Skip to content

stiefenm/spoton

Repository files navigation

Perl Tests

SpotOn

A Spotify plugin for Lyrion Music Server (LMS).

Background

SpotOn builds on the foundation that Michael Herger laid with his Spotty plugin — the original Spotify integration for LMS that served the community for years. Without Herger's pioneering work on Spotty and the broader LMS plugin ecosystem, SpotOn would not exist. Thank you, Michael.

SpotOn is not a fork or a competitor. It is a from-scratch rewrite designed around the current Spotify Web API (including the February 2026 changes) and the latest librespot releases. Where Spotty had to work around years of accumulated API changes, SpotOn could start fresh.

SpotOn Spotty
Podcasts Browse, search, play, follow/unfollow shows, explicit markers, 11 languages Browse and play shows/episodes
Like / Unlike One-click toggle from any track menu Not available
Audio formats OGG, FLAC, PCM, MP3 — configurable per player PCM, FLAC, MP3 — global setting
Spotify Connect Bidirectional sync (play, pause, seek, volume, skip) Currently disabled
Made For You Daily Mixes, Discover Weekly, Daylist, Release Radar Either Liked Songs or Made For You content (not both)

Features

  • Browse — Search tracks, albums, artists, and playlists; full artist discography with albums, singles, compilations
  • Podcasts — Browse saved shows, search for shows and episodes, play episodes, follow/unfollow shows. Episode info view links back to the parent show with lazy-loaded metadata. Explicit episodes are marked. Duration and dates are localized in 11 languages.
  • Library — Liked Songs, Albums, Artists, Playlists, Recently Played, Top Tracks
  • Like / Unlike — Save or remove tracks from your Liked Songs directly from any track context menu. In Material Skin, open the track's "..." menu → "More" → "Like / Unlike" — the plugin checks Spotify for the current state and shows either "Like" (to save) or "Unlike" (to remove). In Classic Skin, the same flow is available via the Track Info panel. After the action, a popup confirms "Liked!" or "Removed" and the menu navigates back automatically.
  • Streaming — Per-player format selection (OGG passthrough, FLAC, PCM, MP3) with 96/160/320 kbps bitrate and volume normalization
  • Spotify Connect — Full bidirectional control: appear as a Connect device, control from any Spotify client, state syncs both ways
  • Made For You — Daily Mixes, Discover Weekly, Daylist, Release Radar with locale-aware sorting
  • Don't Stop The Music — Automatic queue extension using Spotify recommendations
  • Multi-Account — Switch between Spotify accounts without re-authentication

Requirements

  • LMS 8.0+ (LMS 9.x recommended)
  • Spotify Premium account
  • Spotify Developer App (recommended) — create one here, then enter your Client ID in SpotOn settings. Without your own app, API requests share a default Client ID with stricter rate limits.
  • Supported platforms: x86_64 Linux, i386 Linux, aarch64 Linux (Pi 4+), armhf Linux (Pi 2/3), arm Linux, x86_64 Windows, macOS (Universal Binary: Intel + Apple Silicon). On macOS, if you download the binary manually (not via LMS plugin manager), you may need to run xattr -d com.apple.quarantine /path/to/spoton in Terminal before first use.

Installation

  1. Open LMS Settings > Plugins > Additional Repositories
  2. Add the repository URL:
    https://raw.githubusercontent.com/stiefenm/spoton/main/repo.xml
    
  3. Click Apply, then find SpotOn in the plugin list and install it
  4. Restart LMS when prompted

Troubleshooting

See TROUBLESHOOTING.md for common issues and solutions, including Docker setup, Connect audio problems, and how to collect diagnostic data.

License

MIT — see LICENSE

About

SpotOn — A fresh Spotify plugin for Lyrion Music Server (LMS)

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors