Setting up Aoede on ServerPrism

Aoede is a unique Discord music bot that streams directly from Spotify, using Spotify itself as its primary interface. This guide covers setting up your Aoede bot on ServerPrism.

Create your bot in Discord Developer Portal

1. Go to the Discord Developer Portal.
2. Click New Application.
3. Give your application a name (e.g., "Aoede Music Bot") and click Create.
4. Navigate to the Bot tab on the left sidebar.
5. Click Add Bot, then Yes, do it!.
6. Under TOKEN, click Reset Token, then Yes, do it!.
7. Copy the token. This is your bot's secret key; keep it safe. You will need it for your ServerPrism panel.
8. Scroll down to Privileged Gateway Intents.
9. Enable the Message Content Intent toggle. Aoede needs this to process Spotify links and commands within messages.

Invite the bot to your server

1. In the Discord Developer Portal, go to the OAuth2 tab, then URL Generator.
2. Under SCOPES, select bot.
3. Under BOT PERMISSIONS, select the following:
   • Read Messages/View Channels
   • Send Messages
   • Connect
   • Speak
   • Use Voice Activity
4. Copy the generated URL at the bottom of the page.
5. Paste the URL into your browser and press Enter.
6. Select the Discord server you want to add the bot to and click Authorize.

Order on ServerPrism

When ordering your Discord bot server on ServerPrism:

1. Select the "Discord Bots" product.
2. Choose Aoede as your bot runtime.
3. A 1 GB RAM plan is generally sufficient for Aoede.
4. Select your preferred server region.
5. Complete the deployment process.

Configure startup variables

After your server deploys, you need to configure the bot's environment variables. Go to the Startup tab in your ServerPrism panel.

Set the following variables:

• BOT_TOKEN: Paste the bot token you copied from the Discord Developer Portal.
• PREFIX: The command prefix for your bot (e.g., !). Aoede primarily uses Spotify links directly, but a prefix might be used for other commands if implemented.
• SPOTIFY_CLIENT_ID: Your Spotify application's Client ID. Create an application at Spotify for Developers to get this.
• SPOTIFY_CLIENT_SECRET: Your Spotify application's Client Secret. Also from your Spotify for Developers application.

Refer to the Startup tab in your panel for any other specific variables your bot might require.

First start

1. After setting your environment variables, navigate to the Console tab in your ServerPrism panel.
2. Click the Start button.
3. Monitor the console output. Successful startup will show messages indicating the bot is connecting to Discord and Spotify, typically ending with a message like "Aoede is online!" or similar confirmation.
4. Check your Discord server; your bot should appear online in the member list.

Common issues

• Bot token rejected/Invalid Token: Double-check that BOT_TOKEN in your Startup tab is exactly the token copied from the Discord Developer Portal, with no extra spaces or characters.
• Bot online but not responding: Ensure you enabled the Message Content Intent in the Discord Developer Portal under your bot's settings. Also, verify that the bot has the necessary permissions (Connect, Speak, Send Messages) in your Discord server.
• Spotify connection issues: Confirm SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET are correct and from a valid Spotify application. Make sure your Spotify application has http://localhost:8888/callback as a Redirect URI if required by the bot's specific authentication flow (check Aoede's documentation if issues persist).

Next steps

Once Aoede is running, you can start using it by pasting Spotify song or playlist links directly into your Discord channel where the bot is present. For more advanced usage or troubleshooting, refer to the official Aoede GitHub repository or its documentation for specific commands and features.