Music Recognition and Lyrics keeps track of the current song and can follow lyrics while the track plays.
¶ What you can do
You can run music tracking in two modes:
Media Session mode
- Uses your active media session
- Uses
Select a media session
Recognition mode
- Listens to a selected audio device
- Uses
Filter by Album - Uses
Select a device to listen to - Uses the start/stop icon buttons
¶ Quick setup
- Choose mode with the top-left mode switch.
- In Recognition mode, optionally set
Filter by Album. - Adjust the numeric offset control if lyric timing is early or late.
- Pick an input device and start recognition.
- Use Graph System triggers for automation.
¶ Lyrics and timing
Use the offset control to align lyric timing to playback.
Lyric source setting
- Set
Lyrics sourcefrom Settings →MusicReco.
Lyric cache
- Repeated lookups for the same song can reuse cache when caching is enabled.
¶ What data becomes available to graphs
songreco_details: Current song metadata
{
"title": "Song Title",
"artist": "Artist Name",
"album": "Album Name",
"duration": 180000, // milliseconds
"timestamp": 65000 // current playback position
}
songreco_lyric: Individual lyric line as it "appears" in timing
{
"line": "Lyric text here",
"timestamp": 5000 // when this line should appear
}
songreco_lyrics: Full lyrics object (all lines)
songreco_lyric_compound: Multi-line block (e.g., chorus lines together)
Use these in Graph System triggers to:
- Announce song changes ("Now playing: {title} by {artist}")
- Highlight current lyrics on overlay
- Trigger effects on beat or lyric milestone
¶ Common automations
On-stream song display
- Trigger:
songreco_detailsfires - Action: Send to Designer overlay component
- Result: Live song title and artist on stream
Lyric highlight
- Trigger:
songreco_lyricfires (each lyric line) - Action: Update Designer component to show current line
- Result: Karaoke-like lyric follow-along
Music detection alerts
- Trigger:
songreco_detailsfires with new song - Filter: Check if artist matches list (e.g., "no copyrighted music")
- Action: Alert if problematic song detected
¶ Troubleshooting
- No song detected: Check if music app reports metadata (Media Session mode). If using Recognition, verify audio device is correct and has audio flowing.
- Metadata stale or wrong: Some apps don't update fast enough. Try Recognition mode instead.
- Lyrics out of sync: Adjust timing offset; test with a shorter track first.
- Lyrics not found: Lyric source is offline or song not in database. Try manual entry or switch sources.
¶ In-view feedback
- Album art, title, artist, and album are shown in the left panel.
- Lyrics panel shows current line when available.
- If no lyrics are available, you will see an instrumental/not-found state.