Spotify Browser Overlay

Mar 2026

Requirements:

- A Spotify account, with Premium active

This is due to a recent Spotify developer change, requiring a Premium account to create "apps"

- The program from GitHub

Also OBS, or some program to capture the browser window

- A Windows PC

At least for now, the directory system is only configured for Windows

- About 15 minutes

Set? Let's go

-

Part 1 - Spotify API:

1. Go to the Spotify Developer page and create a new app

The basic information does not matter, name it whatever you'd like

2. Set a redirectURI

I'd recommend "http://127.0.0.1:", followed by a 4-digit port of your choosing

Ex. "http://127.0.0.1:6969"

This opens a browser window at that address when you first connect

Save the URI, "ClientID" and "Client Secret" (click "View Client Secret")

-

Part 2 - The Program:

1. If you haven't already - download a Release from the GitHub

1. Unzip the program into a folder of your choosing

2. Open the "config.ini" file and enter your values in the [Required] section

If these are not set, the program will not be able to receive/send information

Any information is never passed to me or anyone else, only between you and Spotify/Discord

You can configure any other aspects here, too, like the colors, the text format and size of the player

I'd recommend leaving things as-is so you can get a grasp on the program first, and to make sure it works :)

3. Once ready, run the program

You likely will get a warning about "unsafe program" - don't worry, this isn't a virus

In case you don't know, Microsoft uses something called "signing" to authenticate the programs are "somewhat legit"

All that means is "pay us and we'll make your app not have a warning" (it also requires some "trust factor", which just means enough downloads)

I just don't have the desire to spend hundreds to stop a popup, sorry...

4. The program should open a tab asking to authenticate - do so

There's a small chance it'll ask you to enter the URL you were sent to; if this is the case, just copy the URL from your browser window that opened and paste it into the console

5. Hooray!

If you head to http://127.0.0.1:(yourport), you should see your Spotify activity!

Now you can go into your capture program (OBS), add a Browser Source and set the URL to match the site you just visited

All you need to do now is transform/crop it in OBS/whatever capture program so it fits nicely

Feel free to browse the config.ini more thoroughly now

You've reached the end. Thank you for installing my program and have fun :)

Optional: A Twitch Bot

SBO also includes a method for adding your own Twitch Bot, which can use simple commands to interact with Spotify

If you'd like to learn more, head over to the SBO Bot guide

If you already have the bot configured and need a refresher on the commands, go here instead

Any issues? Ideas? Stupid block of code I probably should've fixed?

Make a bug report on GitHub or shoot me a message on Discord: LilPiffer :)