git404hub

what is synced-lyrics-card fr?

wayj84/synced-lyrics-card — explained in plain English

Analysis updated 2026-05-18

1Audience · generalComplexity · 2/5Setup · easy

tl;dr

Synced Lyrics Card is a Home Assistant frontend card that shows time-synced song lyrics from LRCLIB for any media player, with customizable layouts, fonts, and timing adjustment.

vibe map

mindmap
  root((synced-lyrics-card))
    What it does
      Time synced lyrics
      Pulls from LRCLIB
      Browser side caching
      Sync offset adjustment
    Tech stack
      JavaScript
      Home Assistant
      LRCLIB
    Use cases
      Dashboard lyrics display
      Karaoke style overlay
      Spotify pairing
    Layouts
      Focus
      Karaoke
      Compact
      Minimal

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Display synced, karaoke-style lyrics on a Home Assistant dashboard while music plays.

VIBE 2

Show a compact or minimal lyrics overlay alongside a Spotify or other media player card.

VIBE 3

Correct lyrics that appear slightly ahead of or behind the music using a timing offset.

VIBE 4

Fall back to plain scrollable lyrics for songs that have no synced timing available.

what's the stack?

JavaScriptHome AssistantLRCLIB

how it stacks up fr

wayj84/synced-lyrics-card0xkinno/neuralvault0xlocker/d17-contracts
Stars111
LanguageTypeScriptSolidity
Setup difficultyeasyhardhard
Complexity2/54/55/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Runs entirely in the browser with no API key or backend, needs a media player entity that exposes track metadata.

No license information is provided in the README.

in plain english

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.

prompts (copy fr)

prompt 1
Write the YAML configuration for adding Synced Lyrics Card to a Home Assistant dashboard using my Spotify media player entity.
prompt 2
Explain how to install Synced Lyrics Card manually without using HACS.
prompt 3
How do I fix lyrics that appear half a second early using the sync_offset setting?
prompt 4
Compare the focus, karaoke, compact, two-line, and minimal layouts of Synced Lyrics Card and suggest one for a small wall-mounted tablet.

Frequently asked questions

what is synced-lyrics-card fr?

Synced Lyrics Card is a Home Assistant frontend card that shows time-synced song lyrics from LRCLIB for any media player, with customizable layouts, fonts, and timing adjustment.

What license does synced-lyrics-card use?

No license information is provided in the README.

How hard is synced-lyrics-card to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is synced-lyrics-card for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.