Setting up song requests - songify-rocks/Songify GitHub Wiki

Spotify Setup

To enable song requests, you'll need to authenticate with the Spotify API. Follow these steps:

  1. Create a Spotify Developer App

    • Visit the Spotify Developer Dashboard and log in.
    • Click Create an App and provide an App Name (e.g., Songify) and a brief description.
    • For the Redirect URI, enter: 
      http://localhost:4002/auth
    • Important: After pasting the Redirect URI, make sure to click Add.

  2. Get Your Client ID and Client Secret

    • Once the app is created, click Settings in the top-right corner.
    • Copy the Client ID and Client Secret displayed on the page.

  3. Configure Spotify in Songify

    • Open Songify and navigate to Settings -> Spotify.
    • Paste the Client ID and Client Secret into their respective fields.
    • Toggle the switch to enable Use Own AppID.

  4. Restart Songify

    • Close the settings window. You’ll be prompted to restart the app—click Yes.

  5. Link Your Spotify Account

    • After restarting, go to Settings -> Spotify -> Link to connect your Spotify account.
    • Log in to your Spotify account if prompted and authorize the app.

  6. Verify the Setup

    • If the setup is successful, you’ll see:
      • Linked account: Your Spotify username.
      • Your Spotify profile picture.

Spotify Dashboard

Twitch

To enable song requests, you need to authenticate with the Twitch API.

  1. Log in with Twitch

    • Go to Settings -> Twitch and click on Log in with Twitch.
    • Authorize the Songify app when prompted.

  2. Redirect to Success Page

    • After authorizing, you will be redirected to a success page.

  3. Optional: Use a Secondary Account

    • If you want to use a secondary account (e.g., a bot account), log in with that account as well.
    • You will be asked if you want to use the secondary account for chat actions.

Song Requests

Note: Song requests require a Spotify Premium account.

Before proceeding, ensure you’ve completed the setup for both Spotify and Twitch.

  1. Create a New Reward

    • Go to Settings -> Twitch -> Rewards and click on Create New Reward.
    • Fill in the title, prompt, and cost for the reward.
    • Important: Ensure the reward name does not conflict with any existing rewards.

  2. Edit the Reward on Twitch

    • Click Create Reward.
    • You will be redirected to the Twitch Rewards page where you can customize the reward further.

  3. Refresh and Add the Reward in Songify

    • Return to Settings -> Twitch -> Rewards in Songify.
    • Click Refresh Rewards, then select your newly created reward from the dropdown menu.
    • Click the + button to add it to the rewards list.

  4. Enable Song Requests

    • Go to Settings -> Song Requests and ensure the following are enabled:
      • Enable SR (Channel Points) for reward-based song requests.
      • Enable SR (Command) if you also want to allow song requests through chat commands.
      • Set the allowed userlevels using the dropdowns for command and reward.
      • Set the maximum allowed requests per user based on the userlevel.

  5. Connect the Twitch Chat Bot

    • If the Twitch chat bot is not already connected, click Connect in the main window menu.

  6. Test Song Requests

    • Trigger the reward or use the song request command in Twitch chat.
    • If everything is set up correctly, you will see the requested song appear in the queue window, and the bot will respond in Twitch chat.