Skip to content

IgnoredSoul/SpotPlug

Repository files navigation

SpotPlug

SpotPlug is an extension for Spicetify that creates a socket connection between Spotify and a server. It enables the control and monitoring of your Spotify playback externally.

Features

  • Connects Spicetify directly to a local socket server.

  • Automatically sends data to your server when things change.

  • Accept commands from your server to control playback.

Communication

Client to Server (Outbound)

  • songchange: Triggered when the track changes.

  • playpause: Triggered when playback is toggled.

  • progress: Periodic updates of the current timestamp in the song.

Server to Client (Inbound)

  • control: Controls the playback

    • toggle: Pauses or resumes playback.

    • next: Skips to the next track.

    • prev: Goes back to the previous track/start of song.

    • play: Play a spotify track, album or whatever with a URI

    • seek: Seeks to a part of a song in milliseconds

  • current_track: Returns the current track

  • current_artist: Returns the current artists' profile

  • next_track: Returns the next track

  • next_tracks: Returns N tracks that play next

Configuration

You can find the settings directly within Spotify's Preferences menu:

  • Port: Set the specific local port for the socket server.

  • Enable Client: The the socket connection on or off.

  • Progress Interval: Adjust how frequently the progress event is sent.

  • Force Progress: A more reliable way for the progress event to be sent. You just have to see for yourself lmao.

FAQ

Why did you make this?

Since Spotify decided to lock their API behind a Premium sub and fucked the community off,
my 'now playing' overlay doesn't work anymore due to not being able to use their API.

How do I use this?

You can use example python socket server and expand from there.


About

Socket.io-client Spicetify extension

Topics

Resources

Stars

Watchers

Forks