Skip to content

Janleyx/decky-spotify-connect

Repository files navigation

Spotify Connect

Spotify Connect is a Decky Loader plugin that turns your handheld into a Spotify Connect endpoint and gives you playback controls inside Decky.

Features

  • Start and stop Spotify Connect from the main Decky panel.
  • Show current track, artist, album art, and seek position.
  • Control shuffle, previous, play/pause, next, repeat, and seeking through MPRIS.
  • Configure browser login, playlist linking, stream quality, startup volume, volume normalisation, autoplay, device name, and song-change notifications.
  • Browse linked Spotify playlists and start playback from inside the plugin.
  • View backend status and recent logs in Dev Tools.
  • Create a redacted debug bundle from Dev Tools.
  • Ships with a bundled spotifyd backend for dev-install zip installs.

Tested Devices

  • Steam Deck
  • Odin 2 / Armada
  • MSI Claw A1M on Bazzite

Install

Install the release zip through Decky Loader's developer install flow. The zip includes the built frontend, plugin metadata, Python backend, and bundled spotifyd binary.

Setup

  1. Open Spotify Connect settings.
  2. Go to Account.
  3. Use Browser Login for Spotify Connect playback.
  4. Use Link Playlists to authorize playlist browsing.
  5. Close settings and enable Spotify Connect from the main plugin panel.
  6. Pick the configured device name from Spotify's device list.

Password login is still available as a fallback, but Browser Login is recommended.

Armada / Odin 2 Note

On Odin 2 / Armada, a Steam browser issue can conflict with CSS Loader during Spotify browser authorization. When CSS Loader is installed, the Account page shows an Armada setup step:

  1. Disable CSS Loader from the Spotify Connect Account page.
  2. Complete Browser Login and Link Playlists.
  3. Re-enable CSS Loader from the same Account page.

This warning only appears on Armada-like devices when CSS Loader is installed or currently disabled.

General Settings

  • Audio Quality: low, normal, or high bitrate. Applies next time Spotify Connect starts.
  • Master Volume: saved startup volume and live soft-volume control.
  • Volume Normalisation: spotifyd volume normalisation.
  • Autoplay Similar Music: writes spotifyd's autoplay option so Spotify can continue similar music after a playlist or album ends.
  • Song Change Notifications: Decky toast notifications when tracks change.

Playlist Browser

Playlist browsing uses Spotify Web API OAuth separately from spotifyd playback login. This is why Account has both Browser Login and Link Playlists.

Notes and Troubleshooting

Spotify playback and controls depend on Spotify Connect and spotifyd. After enabling the plugin, choose the Steam Deck device from the Spotify app.

  • If the device does not appear in Spotify, confirm the plugin is enabled and the device is on the same network.
  • If controls do not appear, check Dev Tools for Account, MPRIS, spotifyd, and Backend Path status.
  • Dev Tools can create a redacted debug bundle for troubleshooting.

Bundled spotifyd

This plugin bundles spotifyd so Decky developer installs work without requiring users to install a separate backend. The bundled binary is used only as the Spotify Connect playback bridge.

Thanks

This plugin uses spotifyd as the bundled Spotify Connect backend. Thank you to the spotifyd project and contributors for making the playback bridge possible.

About

Decky Loader plugin for Spotify Connect playback controls and playlist browsing.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors