wayj84/synced-lyrics-card

Synced Lyrics Card is a lightweight custom card for Home Assistant, the home automation platform, that shows song lyrics in time with whatever is playing on a media player. It pulls the lyrics from LRCLIB, a free lyrics database, and highlights the current line as the song progresses. The card watches a media player entity you choose, reading its track title, artist, album, duration, and playback position. It works well with the built in Spotify integration and uses the player's position updates to keep the highlighted lyric line lined up smoothly between refreshes. It looks up the exact track first, and falls back to a broader search if an exact match is not found. Lyrics that load successfully are cached in the browser for 30 days, so replaying a song loads instantly the next time. There are five layout options to choose from: focus, karaoke, compact, two line, and minimal, each showing a different amount of surrounding lyric context around the current line. You can also customize the font, font size, font weight, text alignment, the opacity of lines that are not currently playing, and how much the active line is scaled up. If a song's synced lyrics are a little early or late, a sync offset setting lets you nudge the timing in small increments until it lines up. Installation works either through HACS, the Home Assistant Community Store, by adding this repository as a custom frontend repository, or manually by copying a single JavaScript file into the Home Assistant configuration folder and registering it as a dashboard resource. No API key, backend service, or separate integration is required since the card runs entirely in the browser and talks directly to LRCLIB. If synchronized lyrics are not available for a track, the card falls back to showing plain, scrollable lyrics instead.