[Release] SyncLyrics v2 - Music Assistant Support + more

Earlier I had posted about my app, SyncLyrics - a real-time synced lyrics app. Thanks to the response and a few great community members, I’ve updated it to include full Music Assistant support plus a bunch of other cool features!

Music Assistant:

Simply configure your MA server URL and token as environment variables like this:

SYSTEM_MUSIC_ASSISTANT_SERVER_URL=http://192.168.1.100:8095 # input the real URL
SYSTEM_MUSIC_ASSISTANT_TOKEN=
SYSTEM_MUSIC_ASSISTANT_PLAYER_ID=                           # Optional

The app automatically detects the first active player and uses that to fetch track metadata + lyrics. It should work with all MA sources and players, but please do report any issues you find.

There is a manual latency compensation in settings if you notice lyrics are too fast or slow.

It also supports MA playback controls, queue, like, etc.

Media Browser:

The app now has a built-in embedded library browser, which works with both Spotify and Music Assistant. It automatically opens the correct one based on your music source, and you can browse your playlists, albums, etc., and control playback directly from inside SyncLyrics!

Lyrics and Font Customization: You can now customize the size, color, glow, and font of the lyrics. There’s a bunch of built-in fonts, with support for custom font files too. Karaoke lyrics got some improvements too, with smoother animation timing.

New Playback Controls: The app now has built-in volume controls and shuffle/repeat + a device picker UI for both Spotify and Music Assistant. So with these additions, SyncLyrics is also a complete control surface for your music, not just a dashboard.

Other Supported Platforms: I’ve also added BETA support for Linux and macOS (unsigned). These might need polishing and bug fixes, so please report any issues.

Home Assistant Compatibility: Based on some issues, I added a Debian version of the SyncLyrics HA addon. If the main one does not work, this one should have improved compatibility on certain CPUs like Xeon.

There’s also a lot of other bug fixes and polishing.

For HA users, just add this link:

To your repositories and install the SyncLyrics addon. There’s a full guide and documentation on my main repo too - GitHub - AnshulJ999/SyncLyrics: A real-time synced lyrics app. Cross-platform support (including Home Assistant). Runs as a server that can be displayed on any device via a webpage. Optimized for tablet dashboards.

If you used SyncLyrics before, you’ll need to re-authorize Spotify once (new permissions for playback controls).

I hope this allows more people to try out the app :smiley:

2 Likes

This looks awesome, but I can’t seem to get it working. What Music Assistant API token am I looking for? I tried using HA’s long-lived access token and got the message “Invalid or expired token” when I tried to login to Music Assistant through the SyncLyrics web portal. I can’t view the other auto-generated refresh tokens associated with my Music Assistant listed on the Security page. Here is the SyncLyrics debug error message:

(music_assistant.py:182) DEBUG - Music Assistant connection failed (attempt 1): Authentication failed: Invalid or expired token

Any help would be greatly appreciated, thanks!

Ha dang it, restart clear it up, sorry. Thanks for this awesome add on!