[2.4.0] - 2026-08-24
⚠️ Important
Keep Screen Awake is enabled by default and changes how your display behaves. After upgrading, any phone or tablet showing SyncLyrics over HTTPS will stay awake while a track is playing, rather than dimming and locking on its usual timeout. The lock is released as soon as playback stops.
That's the point of the feature, but it does mean more battery drain on a device that isn't plugged in, and it can look like the device has stopped sleeping properly. To change it: Settings > UI > Keep Screen Awake (always / playback / off), or add ?keepAwake=off to the URL for a single display.
Nothing changes over plain HTTP - the browser API requires a secure context, so the feature is inactive there.
✨ New Features
Pear Desktop (YouTube Music) Source
SyncLyrics can now read the currently playing track from Pear Desktop, giving YouTube Music users synced lyrics. Enable it under Media settings (off by default) and make sure Pear Desktop's API server plugin is running - the default URL is http://127.0.0.1:26538.
Thanks to @webbrain-one for the implementation in #24, and @1upbyte for the original request and API research in #20.
Keep Screen Awake
Phones and tablets used as a lyrics display no longer dim and lock mid-song. A new Keep Screen Awake setting (Settings > UI) uses the Screen Wake Lock API to hold the display on - always, only during playback (default), or off. Override it per display with ?keepAwake=always|playback|off.
Requires a secure context (HTTPS or localhost). In an iframe the parent must set allow="screen-wake-lock", which the Home Assistant Lovelace iframe card does not - those users still need the direct URL or Fully Kiosk.
Thanks to @Ayce45 for contributing this feature in #25.
What's Changed
- Add Screen Wake Lock support (keep display on while lyrics are shown) by @Ayce45 in #25
- fix: Add Pear Desktop (YouTube Music) support by @webbrain-one in #24
New Contributors
- @Ayce45 made their first contribution in #25
- @webbrain-one made their first contribution in #24
Full Changelog: v2.3.0...v2.4.0