Spotify
TipLink integrates with Spotify to let you build song request systems, react to track changes, and automate playlist management - all driven by your stream events.
The Spotify features TipLink uses (adding to queue, reading playback state) require an active Spotify Premium subscription. The integration will not work with a free Spotify account.
Before You Begin
TipLink connects to Spotify using your own Spotify Developer App. This is a free one-time setup on Spotify's developer portal and takes about 2 minutes.
You will need:
- A Spotify account with Spotify Premium
- A free Spotify Developer account (same login as your Spotify account)
Open Platforms in TipLink Don't have TipLink yet? Download it here.
Set-up Instructions
Step 1: Create a Spotify Developer App
- Go to developer.spotify.com/dashboard and log in.
- Click Create app.
- Fill in a name and description (anything you like, e.g. TipLink Integration).
- In the Redirect URI field, enter exactly:
http://127.0.0.1:6969/spotify-callback/auth - Under APIs used, select Web API, then click Save.
- Open your new app's Settings page and copy the Client ID and Client Secret - you will need these in the next step.
The redirect URI http://127.0.0.1:6969/spotify-callback/auth must be entered character-for-character. Spotify will reject the authorization if it doesn't match.
Step 2: Add the Account in TipLink
- Open TipLink and navigate to the Platforms page using the sidebar.
- Click Spotify at the top of the page.
- A setup panel will appear. Enter your Client ID and Client Secret from your Spotify Developer App.
- Click Create Account.
- Your web browser will open to a Spotify authorization page. Review the permissions and click Agree.
- A TipLink page will appear in the browser confirming the connection was successful. You can safely close the tab.
Spotify is now connected to TipLink!
Managing Your Spotify Account
Open TipLink → Platforms, find your Spotify account in the list, and click the gear icon to open the account settings.
Preferences
| Setting | What it does |
|---|---|
| Auto Connect | When enabled, TipLink validates your Spotify token automatically each time it starts. Recommended if you want playback events to fire without manually connecting. |
| Separate Event for Song Requests | When enabled (default), tracks that were queued via a Spotify: Add to Queue action fire the dedicated Song Request Started Playing event instead of the regular Track Started event. Disable this if you want all track-change events to go through a single alert. |
Song Request Queue
The account settings panel also displays a live Song Request Queue - a list of songs that have been queued via TipLink but have not yet started playing. The queue updates every 3 seconds and shows the track name, artist, and the viewer who requested it.
This is useful for moderating requests or keeping an eye on what's coming up next.
Delete Account
Click Delete Account in the top-right corner of the account settings panel to completely remove this Spotify connection from TipLink.
Connecting & Disconnecting
- Open TipLink.
- On the Home or Platforms page, click Connect next to your Spotify account.
- TipLink will validate your stored token and begin monitoring your Spotify playback.
- If the connection is successful, the button text changes to Disconnect and turns red.
- If the connection fails, the button stays green. Check that your Spotify Developer App credentials are still valid.
Events
TipLink fires the following events from your Spotify account. Use them as triggers for your alerts.
| Event | When it fires |
|---|---|
| Track Started | A new track begins playing. Resuming a paused track does not re-fire this event. If the track was queued via a song request and Separate Event for Song Requests is on, the Song Request Started Playing event fires instead. |
| Song Request Started Playing | A viewer-requested track starts playing. Only fires when Separate Event for Song Requests is enabled in account preferences. |
| Song Added to Queue | A song was successfully added to the queue by a Spotify: Add to Queue action. Fires the moment the song is queued - before it starts playing. Use this to send a chat confirmation. |
| Track Stopped | Spotify was closed or stopped on all devices. |
| Nothing Playing | Playback paused or stopped. Fires on both pause and full stop. |
Available Placeholders
The following data is available in alerts triggered by Spotify events.
Track Started / Song Request Started Playing
| Placeholder | Description |
|---|---|
{{track_name}} | Title of the currently playing track |
{{artist_name}} | Artist(s) of the track |
{{album_name}} | Album the track belongs to |
{{album_art_url}} | URL of the album artwork image |
{{track_url}} | Spotify web link to the track |
{{track_uri}} | Spotify URI of the track (e.g. spotify:track:…) |
{{progress_ms}} | Current playback position in milliseconds |
{{duration_ms}} | Total track duration in milliseconds |
{{progress_pct}} | Playback position as a 0–100 percentage |
{{is_playing}} | Whether Spotify is actively playing (true/false) |
{{requested_by.username}} | Username of the viewer who requested this track (empty if not requested) |
{{requested_by.displayname}} | Display name of the requester |
{{requested_by.requestedAt}} | Date and time the request was made |
Song Added to Queue
| Placeholder | Description |
|---|---|
{{track_name}} | Name of the track that was queued |
{{artist_name}} | Artist(s) of the track |
{{album_name}} | Album the track belongs to |
{{track_url}} | Spotify web link to the track |
{{track_uri}} | Spotify URI of the track |
{{requested_by.username}} | Username of the viewer who triggered the queue action |
{{requested_by.displayname}} | Display name of the requester |
{{requested_by.requestedAt}} | Date and time the request was made |
Track Stopped / Nothing Playing
| Placeholder | Description |
|---|---|
{{track_name}} | Title of the last-known track before stopping |
{{artist_name}} | Artist(s) of the last-known track |
{{album_name}} | Album of the last-known track |
{{album_art_url}} | Album artwork URL of the last-known track |
{{track_url}} | Spotify link of the last-known track |
{{track_uri}} | Spotify URI of the last-known track |
{{duration_ms}} | Total duration of the last-known track in milliseconds |
Removal Instructions
To completely remove your Spotify connection from TipLink:
- Open TipLink and navigate to the Platforms page.
- Find your Spotify account and click the gear icon.
- Click Delete Account in the top-right corner of the settings panel.
- Confirm the deletion.
To also revoke TipLink's access from Spotify's side:
- Log in to spotify.com and go to Account → Apps.
- Find your Spotify Developer App in the list and click Remove Access.
Actions
Once your Spotify account is connected, you can use the following actions in your alerts:
- Spotify: Add to Queue → - Add a song to your Spotify playback queue. The primary action for song request systems.
- Spotify: Add to Playlist → - Add a song to a Spotify playlist. Use alongside Add to Queue to keep a permanent record of requested songs.