Settings

Reset Defaults

SyncLyrics

What's new

Loading…

Full changelog
Status
  • Checking…

Album Art

Request timeout (s)
Max retries
Enable iTunes source
Enable Last.fm source
Try to enhance Spotify URLs
Preferred resolution (px)

Artist Image

Request timeout (s)
Enable Wikipedia/Wikimedia
Fetch FanArt.tv album covers

Audio Recognition

Auto-enable audio fingerprinting on startup. Recommended to keep OFF.
Auto-start when Reaper detected. Keep OFF if you don't use Reaper.
Audio device ID (blank = auto, recommended to keep blank)
Preferred device name. Use this only if the correct device is not being auto-selected.
Audio capture length (s)
Time (gap) between recognitions (s)
Manual latency adjustment (s)
Min amplitude to detect audio
Shazam matches needed to accept new song (1=instant)
Clear pending if no confirmation in N cycles
Validate against Reaper window title
Fuzzy match score (0-100) for Reaper validation

Debug

Enable debug features
Log file name
Logging verbosity
Log provider requests
Log polling events
Print logs to terminal
Include detailed info
Log timing stats
Max log file size (bytes)
Number of backups to keep

Features

Save lyrics to disk
Fetch from providers concurrently
Enable album art database
Auto-switch to provider with word-sync even if another is preferred
Enable word-sync by default (frontend can still toggle)
Cache audio analysis for waveform/spectrum

HTTPS

Enable HTTPS (required for browser mic)
HTTPS port (0 = same as HTTP, >0 = dual-stack, 9013 is default)
Auto-generate self-signed certificate
SSL certificate file path
SSL private key file path

Lyrics

Lines to buffer
UI refresh rate (s)
Check rate when idle (s)
Sync offset (+early, -late)
Spotify sync (+early, -late)
Audio rec sync (+early, -late)
Spicetify sync (+early, -late)
Word-sync offset (+early, -late)
Musixmatch word-sync timing adjustment (s)
NetEase word-sync timing adjustment (s)
Total line transition animation in word-sync (ms). 0=instant, 200-400=smooth.
Time before idle (s)
Provider race timeout (s)
Font scale for the active lyric line
Font scale for prev/next lines
Font scale for far-prev/far-next lines
Additional font scale for mobile screens
Font for lyrics display
Text glow strength (0=off, 2=max)
Lyrics text color
Lyrics font weight
macOS sync offset (+early, -late)
Music Assistant sync (+early, -late)

Media

Enable Spotify source
Source priority
Enable Windows source
Source priority
Enable Spicetify bridge (Spotify Desktop)
Source priority (0 = highest)
Enable Linux MPRIS source (via playerctl)
Source priority (lower = first)
Enable macOS Now Playing source (via nowplaying-cli)
Source priority (lower = first)
Enable Music Assistant source
Source priority (lower = first)
Enable REAPER DAW source (receives telemetry from companion script via UDP)
Source priority (lower = first, 5 = high)
Split 'Artist - Title' from project filename as fallback (disabled by default)
Enable Pear Desktop source (YouTube Music)
Source priority (lower = first)
Pear Desktop API server URL (API plugin must be enabled in Pear)
Read what's playing in tidal-hifi, the TIDAL desktop app
Source priority (lower = first)
tidal-hifi API address. For another computer, use its IP and set tidal-hifi's API hostname to 0.0.0.0
Follow any player on a Windows PC running smtc-now-playing
Source priority (lower = first)
Address of the Windows PC running smtc-now-playing
Let phones, Home Assistant or scripts send what's playing to /api/now-playing
Source priority (lower = first)
Optional. When set, senders must include the header Authorization: Bearer <token>. Set one if SyncLyrics is reachable from the internet

Music Assistant

Server URL (e.g., http://192.168.1.100:8095)
API token (from MA web UI)
Specific player (blank = auto-detect)
Accept paused MA for N seconds (0=forever)

Providers

Enable LRCLib
Fetch priority (lower = first)
Enable Spotify Lyrics
Fetch priority (lower = first)
Enable QQ Music
Fetch priority (lower = first)
Enable NetEase
Fetch priority (lower = first)
Enable Musixmatch
Fetch priority (lower = first)
Request timeout (s)
Max retries
Cache TTL (s)
Request timeout (s)
Max retries
Token refresh buffer (s)
Cache TTL (s)
Request timeout (s)
Max retries
Cache TTL (s)
Request timeout (s)
Max retries
Cache TTL (s)
Request timeout (s)
Max retries
Cache TTL (s)

Server

Server port (9012 is default)
Bind address (0.0.0.0 is default)
Quart debug mode

Slideshow

Start with slideshow enabled
Seconds per image
Enable subtle zoom/pan animation
Animation intensity (subtle/medium/cinematic)
Random image order
Crossfade duration (s)

Spotify API

Spotify connection Checking…

Callback URL
Metadata cache (s)
Enable API cache
Spotify-only mode polling (s)
Hybrid/idle mode polling (s)

System

Enable Windows Media
Prefer Windows Media
SMTC timeout (s)
Apps to ignore (partial match)
Accept paused Windows media for N seconds (0=forever)
Accept paused Spotify for N seconds (0=forever)
Accept paused Spicetify for N seconds (0=forever)
Accept paused Linux source for N seconds (0=forever)
Accept paused macOS source for N seconds (0=forever)

UI

Background blur (px)
Background overlay opacity
Disable background blur & scaling
Medium blur album art background
Keep the display awake while lyrics are shown - always, only during playback, or off (requires HTTPS)
Font for menus and controls

Updates

Once a day, ask the SyncLyrics server for the latest version
Include anonymous stats in the daily check: version, install type, OS, which sources and lyrics providers are on and used, and whether anything played. Never songs or settings values

Visual Mode

Enable visual mode for instrumentals
Delay before hiding lyrics (s)
Auto-switch to sharp mode in visual mode
Enable slideshow when no music
Seconds per image

Deprecated Not actively used

These settings are defined but not currently wired up to any functionality. They are kept for potential future use or backwards compatibility.
Default gradient start
Default gradient end
Default text color
Dark mode gradient start
Dark mode gradient end
Dark mode text color
Light mode gradient start
Light mode gradient end
Light mode text color
Enabled animations
wave fade slide none
Enabled backgrounds
gradient solid albumart
Hide extra UI elements
Elements to hide in minimal mode
bottom-nav
Enable local DB
Max DB size (MB)
Cleanup threshold (0-1)
File pattern
Enable caching
Cache duration (days)
Max cache size (MB)
Max memory items
Enable notifications
Notification duration (s)
Icon path
Enable GSettings
Require Playerctl
Enable minimal mode
Show provider name
Track provider stats
Auto-switch theme
Use album art colors
SyncLyrics
Project