Skip to content

manuelmayer-dev/Macro-Deck-Spotify-Plugin

Repository files navigation

Spotify plugin for Macro Deck 2

Control your Spotify-Player using Macro Deck 2

Important Notes

  • You need Spotify Premium in order to be able to control your Player!
    If you just want to make use of the Variables, it should work without the need of Premium.
  • This is a plugin for Macro Deck 2, it does NOT function as a standalone app!

Features

Action Description
Resume/Pause playback Toggles playback
Skip/Previous Skips the playback to the next/previous track
Volume Sets the volume of the Spotify player
Shuffle Sets random play order on or off
Repeat Sets repeating mode
Play playlist Starts playing a specific playlist
Add/Remove Library Add or Remove the current track to your library

Variables

Variable Description Type
spotify_playing_title Holds the currently playing track String
spotify_playing_artists Holds the artists of the currently playing track String
spotify_playing_loop Indicates the repeating mode of the current playback String
spotify_playing_shuffle Indicates if the playback is played randomly Boolean
spotify_playing_volume The current player volume Number
spotify_playing_link The full link to the current track to share String
spotify_track_in_library Indicates if the current track is added to your library Boolean
spotify_playing Indicates if the player is playing a track at the moment (can be bound to the button state) Boolean

Installation

  1. Go to the Spotify Developer Portal
  2. Create a new App, give it a name and description of your choice
  3. Add http://localhost:5000/callback in the Redirect URIs field
  4. Copy the client ID of your new App into the Configuration field in Macro Deck
  5. Press the "Authorize Spotify"-Button
  6. It should open your browser, where you must authorize the App to access your Spotify account.
    The Tokens (Access and Refresh) will be filled into their fields automatically. After authorizing the app you can close your browser again and save the Configuration with "Ok".

Helping with the translation

All translation files are located under:
https://github.com/Develeon64/Macro-Deck-Spotify-Plugin/tree/main/Resources/Languages

Adding/editing a translation file

  1. Fork this GitHub repository
  2. Add/edit the translation files
  3. Create a pull request of the forked repository

Note

Please use the ISO names for the file name and for the Language node in the file. For LanguageCode use the ISO-639-1 code. You can find more information on Wikipedia.

Third party licenses

This plugin uses some awesome 3rd party libraries: