Stream Deck Plugin • User Guide

LyricFlow

Plugin Page Corsair iCUE Support Section

Your music, line by line. Synchronized lyrics, playback controls, real-time now-playing canvas, dial scrubbing, retro audio spectrum visualizer, and Corsair iCUE LCD companion widget. Built for macOS and Windows by Dloper.

1. Overview & Requirements

LyricFlow brings lyrics and music telemetry directly to your desk. Follow live timestamped lines synchronized to your track, scrub through verses with precision encoders, glance at upcoming lyrics, inspect album artwork, and visualize output audio through a 12-band FFT spectrum analyzer.

System Requirements:

2. Action Catalog

Action Hardware Target Behavior & Controls
Lyrics Teleprompter Keypad (Any Stream Deck) Displays current synchronized lyric line. Press to toggle play/pause. Supports darkened album artwork backgrounds and word-wrap toggle.
Neo Lyrics Infobar Stream Deck Neo Infobar Wide display showing current and upcoming lines simultaneously. Automatically scrolls long lines horizontally.
Lyric Scrubber & Volume Rotary Encoder (Stream Deck +) Rotate to seek forwards/backwards by 1–30 seconds (default 5s) or adjust volume. Tap touchstrip to show/hide next lyric; push to toggle play/pause.
Now Playing Canvas Keypad (Any Stream Deck) Shows high-resolution album artwork, track title, artist name, and playback progress bar. Tap to play or pause.
Retro Visualizer Keypad (Any Stream Deck) 12-band real-time audio spectrum analyzer reacting to live system output (35 Hz to 16 kHz) at 10 FPS with smooth attack and decay.

3. Supported Players & Setup

macOS (Spotify & Apple Music Desktop)

LyricFlow connects natively to Spotify and Apple Music on macOS via AppleEvents automation. When launching LyricFlow for the first time, macOS prompts: "Stream Deck wants access to control Spotify / Music". Click Allow.

If access was previously denied, verify under System Settings > Privacy & Security > Automation > Stream Deck that both Music and Spotify are toggled ON.

macOS Web Playback (YouTube, Tidal & Soundcloud)

Browser media detection on macOS works with Google Chrome, Microsoft Edge, and Brave:

  1. Open your browser and navigate to the menu bar: View > Developer > Allow JavaScript from Apple Events.
  2. Allow Automation access when macOS prompts.
  3. Start playback on YouTube or Tidal. LyricFlow will read the active tab's media session and retrieve lyrics.

Windows 10 & 11 (Windows Media Session)

On Windows, LyricFlow hooks into the native Windows Media Session (SMTC). Any desktop player or browser that publishes track info to Windows media controls—including Spotify desktop, Apple Music preview, Tidal, Chrome, Edge, and Firefox—is detected automatically without manual permission configuration.

4. Retro Visualizer Audio Spectrum Setup

Unlike track timers, the Retro Visualizer measures actual audio waveform frequencies passing through your computer's sound output:

5. Corsair iCUE Companion Display Widget

The official LyricFlow iCUE Widget extends your synchronized lyrics to compatible Corsair PC hardware:

6. Lyrics, Offsets & Troubleshooting

Timing Offsets (−10s to +10s)

Because community lyric timestamps may vary between studio album releases, radio edits, and remastered tracks, each LyricFlow action instance offers an adjustable timing offset from −10,000 ms to +10,000 ms. Enter a positive value to advance lyrics earlier, or a negative value to delay them.

Instrumental & Plain Lyric Tracks

When an instrumental track is detected, LyricFlow displays a calm musical note emblem. If a song only has plain untimed lyrics, the hardware keys show the first line and the companion display provides an untimed excerpt.

Player Paused or Offline

If lyrics do not appear, ensure your media player is actively playing audio. When music stops, LyricFlow gracefully displays your configured idle state until playback resumes.

Need assistance?
Visit our Stream Deck Support Hub or contact our developer support team.