LyricGlass: a Private, Single-Device LRCLIB Client

LyricGlass is a private, single-device lyric display app maintained by RonnieCC. It runs exclusively on one Essential PH-1 and uses Apple Music as its primary source. This page describes the limited circumstances under which LyricGlass contacts LRCLIB.

When LyricGlass uses LRCLIB

LyricGlass queries LRCLIB only when Apple Music provides a fully identified track with no usable synchronized lyrics. It performs an exact lookup first; only if that returns 404 does it attempt a search, and only if the result is unambiguous is it used.

• The exact lookup uses the recognized track name, artist, album, and duration when those fields are available.
• Search is limited to the exact-lookup 404 path and uses the recognized track name and artist.
• A search result is used only when title, artist, duration, and, when needed, album metadata leave one unambiguous match.
• Apple authorization, transport, rate-limit, server, malformed-response, and malformed-primary-lyrics failures do not query LRCLIB.

Data boundary

LyricGlass recognizes surrounding music through the PH-1 microphone and ShazamKit. Raw microphone audio is not persisted.

LRCLIB receives only the song metadata needed for the lookup. No audio, credentials, Music User Tokens, playback data, device keys, or recognition history are ever sent to LRCLIB.

Successful lyric records may be cached locally on the device with their source information. LyricGlass does not send that cache or its contents back to RonnieCC or LRCLIB.

Product boundary

LyricGlass does not play music, control another application’s playback, capture another application’s audio, consume Bluetooth media metadata, or coordinate with a second device. It is a narrow personal client: recognize nearby music, obtain lyrics under the conditions above, and display their timing on its own device.

Client identification

This is the public project page for the LyricGlass LRCLIB client. The LRCLIB User-Agent identifies the application and release version and will reference this page’s public canonical URL. RonnieCC will keep this page aligned with material changes to LyricGlass’s LRCLIB request behavior.