Files
lentikr 184a67e519 feat(lyrics,mediactl): embed local lyrics and album art in MPRIS/NowPlaying
Read embedded lyrics (LRC or plain text) and cover art from local file
tags at play time. Lyrics are preferred over network fetch when present;
album art is cached by content hash under ~/.local/share/cliamp/album-art/
and published via mpris:artUrl (Linux) and MPNowPlayingInfoCenter (macOS).
2026-06-29 20:17:41 +08:00

795 B

Lyrics

Press y to show lyrics for the current track. For local files, cliamp uses embedded lyrics from the file tags first. If no embedded lyrics are present, lyrics are fetched from LRCLIB and NetEase Cloud Music.

Modes

  • Synced lyrics: for local files and Navidrome tracks, lyrics auto scroll and highlight the active line in time with playback.
  • Scroll mode: for streams and plain lyrics without timestamps, use j/k or arrow keys to scroll manually.

Embedded LRC lyrics keep their timestamps. Embedded plain text lyrics are shown in scroll mode.

Streams

Lyrics auto update when the ICY metadata changes (e.g., internet radio station transitions).

YouTube and SoundCloud

Titles like "Artist - Song (Official Video)" are parsed to build better search queries.