@opendj/lyrics
v0.1.2
Published
Lyrics lookup, LRC parsing, cache contracts, LRCLIB adapter, and feedback hooks for OpenDJ.
Downloads
648
Readme
@opendj/lyrics
Lyrics + karaoke primitives for OpenDJ. Day-one feature, not a future extension. Depends on @opendj/sync for timing/cue conversion.
Contents (planned — see docs/agent-brief.md §"Lyrics and karaoke"):
LyricsProviderinterface +LyricsLookupInput/LyricsDocument/LyricsLinetypes- LRC format parser (synchronized timestamps + plain-text fallback)
- LRCLIB adapter (HTTP via
fetch; works in Node + Workers) - Lyrics cache contracts (positive + negative lookups, attribution, suppression)
- Feedback hooks (
wrong_song,bad_timing,wrong_line,missing_lyrics,offensive_or_bad_content) lyricsDocumentToSyncCues+getActiveLyricWindowhelpers (used by TV/live view)
Lyrics enrich the experience but never block queue operations. Lookup runs in the background after now-playing changes.
