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

Spotify Setup

  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.
    • To create the app click on SAVE
  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.
      • To obtain the secret you have to click on View client secret
  3. Configure Spotify in Songify

    • Open Songify and navigate to Settings -> Spotify.
    • Paste the Client ID and Client Secret into their respective fields.
  4. Link Your Spotify Account

    • Click Link to connect your Spotify account.
    • Log in to your Spotify account if prompted and authorize the app.
  5. 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.
      • By default, Songify will launch MS Edge, you can disable that in Settings -> System -> Use default web browser
    • 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. Selecting the Reward

    • Go to Settings -> Twitch -> Rewards and enable the reward you want to use for song requests.
    • Songify also offers the creation of Channel Rewards
      • Click on + in the top right corner.
      • Fill in the title, prompt, and cost for the reward.
      • Important: Ensure the reward name does not conflict with any existing rewards.
      • Click Create Reward.
      • You will be redirected to the Twitch Rewards page where you can customize the reward further.
  2. 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) in the Commands tab 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.
  3. Connect the Twitch Chat Bot

    • If the Twitch chat bot is not already connected, click Connect in the main window menu.
  4. 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.