Spotilyss

Displays your currently playing Spotify song on-screen in the bottom-left corner! This mod uses the official Spotify API for a reliable connection and requires a simple, one-time setup to link with your account.

One-Time Setup: Connecting to Spotify

This process gives the mod a unique "key" to securely access your "Now Playing" information. It's a bit involved, but you only have to do it once. The mod will never see your Spotify password.

Part 1: Create Your "App" on Spotify's Website

1. Go to the Spotify Developer Dashboard:

   • Log in with your Spotify account here: https://developer.spotify.com/dashboard/applications

2. Create a New App:

   • Click the green CREATE APP button.
   • Give it any name and description (e.g., "My Atlyss Mod," "Spotilyss").
   • Check the agreement boxes and click CREATE.

3. Configure and Get Your Keys:

   • On your new app's dashboard, click the green Edit Settings button.
   • In the box labeled Redirect URIs, copy and paste this exactly:

     https://example.com/callback
     

   • Click Add, then scroll to the bottom and click Save.
   • Now, back on your app's main page, copy the Client ID. You'll need it soon.
   • Click Show client secret and copy the Client Secret key as well.

Part 2: Configure the Mod In-Game

1. Launch the game once with the mod installed. This creates the necessary configuration file.
2. Close the game. Go to the game's folder and open this file in a text editor: BepInEx/config/com.s0apysh0wer.spotilyss.cfg.
3. Paste your Client ID and Client Secret into the matching fields.
4. Ensure the Spotify Redirect URI setting in this file also says exactly: https://example.com/callback.
5. Save and close the file.

Part 3: Final Authentication (The "Copy-Paste" Step)

1. Launch the game!
2. A browser window will automatically open, asking you to grant permission to your app. Click "Agree".
3. You will be redirected to a simple white page that says "Example Domain". This is correct and means it's working!
4. Look at the address bar in your browser. Copy the ENTIRE, long URL. It will look like this: https://example.com/callback?code=AQA...[a_very_long_string_of_characters]
5. Go back into the game. The mod's settings menu should already be open.
6. Paste the full URL you just copied into the text box that says "Pasted URL".
7. Click "Submit Authentication Code".

That's it! The menu will close, and the mod will be fully authenticated, displaying your current song. You will never have to do this again unless you reinstall the mod.

Enjoy!

Troubleshooting

• INVALID_CLIENT: Invalid redirect URI error in the browser: This means the URI in your config file and the URI you added to the Spotify Dashboard are not an exact, character-for-character match. Go back to Part 1 and Part 2 and make sure they are identical.
• The URL I'm redirected to doesn't have ?code= in it: This is also caused by the URIs not matching. See the point above.