Musa

Instructions

1. Create an app on Slack's App Directory, set the App Manifest to the following:

   {
     "display_information": {
       "name": "Musa"
     },
     "features": {
       "bot_user": {
         "display_name": "Musa",
         "always_online": true
       },
       "slash_commands": [
         {
           "command": "/musa-toggle",
           "url": "https://<your domain>/musa-toggle",
           "description": "Toggles Musa for your user",
           "should_escape": true
         },
         {
           "command": "/musa-status",
           "url": "https://<your domain>/musa-status",
           "description": "Gets the status of Musa for your user",
           "should_escape": true
         },
         {
           "command": "/musa-list-users",
           "url": "https://<your domain>/musa-list-users",
           "description": "Gets Musa users",
           "should_escape": true
         }
       ]
     },
     "oauth_config": {
       "redirect_urls": ["https://<your domain>/slack"],
       "scopes": {
         "user": ["users.profile:write"],
         "bot": ["commands"]
       }
     },
     "settings": {
       "org_deploy_enabled": false,
       "socket_mode_enabled": false,
       "token_rotation_enabled": false
     }
   }

   Here's the main portal page. And here's the testing portal page.

2. Create an app on Spotify's Developer Dashboard, set the Redirect URI to https://<your domain>/spotify. Add yourself to the Users allowlist.

   Again, here's my first one. And, here's my second one.

3. Create a .env file or populate the docker-compose.yml file with the following:

   DATABASE_URL=""
   SLACK_CLIENT_ID=""
   SLACK_CLIENT_SECRET=""
   SPOTIFY_CLIENTS=1
   SPOTIFY_CLIENT_0_ID=""
   SPOTIFY_CLIENT_0_SECRET=""
   ADMIN_USER_ID=""
   HOST="https://<your domain>"

4. Deploy the app using your favorite method. I'm using Docker Compose.

   cd <project root>
   docker-compose up -d

   In my deployment, I have Traefik as a reverse proxy, so I have all the URLs specified with https://.

5. Go to https://<your domain>/ and get started!