A last.fm bot for Slack

slack.fm is a Slack bot that lets you connect your Last.fm account to view your music stats, get song/album/artist info, and more—all from within Slack. Perfect for sharing your music taste, discovering new tracks, and having fun with your team.

• Link your Last.fm account to Slack
• View your or others now playing track, profile, top artists, albums, and songs
• Get fun roasts of your music taste
• See detailed stats for songs, albums, and artists
• Easy-to-use Slack slash commands

To self-host slack.fm, follow these steps:

1. Clone the repository:

   git clone https://github.com/bananajeanss/slack.fm.git
   
   cd slack.fm

2. Install the dependencies:

   npm install

3. Set up your Slack app:

   • Go to the Slack API and create a new app using the slackmanifest.json file.
   • Double-check that everything is set up correctly.

4. Create a .env file
   Copy .env.example and fill in the required variables.

5. Run the app:

   npm start

• SLACK_CLIENT_ID – Your Slack app client ID
• SLACK_CLIENT_SECRET – Your Slack app client secret
• SLACK_BOT_TOKEN – Your Slack bot token (starts with xoxb-)
• SLACK_APP_TOKEN – Your Slack app-level token (starts with xapp-)
• SLACK_SIGNING_SECRET – Your Slack signing secret
• LASTFM_API_KEY – Your Last.fm API key
• LASTFM_SHARED_SECRET – Your Last.fm shared secret
• LASTFM_CALLBACK_URL – OAuth callback URL for Last.fm (must be a valid URL)
• SPOTIFY_CLIENT_ID – Your Spotify client ID
• SPOTIFY_CLIENT_SECRET – Your Spotify client secret
• USE_LANGUAGE_FILTERING – true or false to enable/disable language filtering for output
• DB_PATH – Path to the SQLite database file (default: ./utils/slackfm.db)

Once the bot is running and added to your Slack workspace, you can use these basic commands to get started:

More commands can be found in the commands.md file.

Contributions are welcome! Please fork the repository and create a pull request. For major changes, open an issue first to discuss what you’d like to change.

For further information on contributing, please refer to the CONTRIBUTING.md file.

This project is licensed under the MIT License. See the LICENSE file for details.

• Last.fm API
• Slack API/Bolt
• Spotify API
• SQLite - Local database storage
• Express.js - Web framework for routing
• Axios - HTTP client for API requests