Skip to content
ivLis edited this page Jan 22, 2026 · 1 revision

Settings

한국어

Complete guide to configuring ivLyrics.


Accessing Settings

  1. Open ivLyrics from the Spotify sidebar
  2. Click the Settings button (gear icon) in the bottom right

Display Settings

Lyrics Display

Setting Description
Font Family Choose the font for lyrics display
Font Size Adjust the lyrics text size
Line Spacing Control space between lyrics lines
Text Alignment Left, center, or right alignment
Scroll Behavior Smooth or instant scrolling

Karaoke Mode

Setting Description
Highlight Style Word or syllable-based highlighting
Highlight Color Color for the current word/syllable
Animation Speed Transition speed for highlights

Color Theme

Setting Description
Primary Color Main accent color
Background Background style and opacity
Text Color Lyrics text color
Secondary Text Translation/phonetic text color

Translation Settings

General

Setting Description
Target Language Language to translate lyrics into
Auto Translate Automatically translate when playing foreign songs
Show Original Display original lyrics alongside translation

Phonetic

Setting Description
Enable Phonetic Show romanization for supported languages
Furigana Display furigana for Japanese (hiragana above kanji)

AI Providers

Configure AI services for translation and phonetic notation.

Available Providers

Provider Features API Key Required
Gemini Translation, Phonetic, Metadata, TMI Yes (Free tier available)
ChatGPT Translation, Phonetic, Metadata, TMI Yes
Claude Translation, Phonetic, Metadata Yes
Groq Translation, Phonetic Yes
OpenRouter Translation, Phonetic Yes
Perplexity Translation, Phonetic Yes
Pollinations Translation, Phonetic No

Provider Settings

For each provider:

  1. Enable/disable the provider
  2. Enter API key (if required)
  3. Select model variant
  4. Choose enabled capabilities

Capabilities

Capability Description
Translation Translate lyrics to target language
Phonetic/Pronunciation Convert to romanized text
Metadata Translate song title and artist name
TMI (Track Music Info) Generate interesting facts about the song

Lyrics Providers

Configure where lyrics are fetched from.

Available Providers

Provider Karaoke Synced Unsynced
Spotify Yes Yes No
LRCLIB No Yes Yes

Provider Priority

Drag providers to reorder priority. The first provider that returns lyrics will be used.

ivLyrics Sync

When enabled, community-contributed sync data can enhance synced lyrics to karaoke mode.


Keyboard Shortcuts

Setting Default Description
Fullscreen Toggle F12 Enter/exit fullscreen mode
TV Mode Toggle T Toggle TV mode (fullscreen only)

Advanced Settings

Cache

Setting Description
Clear Lyrics Cache Remove cached lyrics data
Clear Translation Cache Remove cached translations
Clear All Cache Remove all cached data

Debug

Setting Description
Enable Debug Mode Show additional debug information
API Tracker View API request/response logs

Reset

Setting Description
Reset Settings Restore all settings to defaults
Reset Tutorial Show the setup wizard again

Tips

  1. Performance: If lyrics scroll slowly, try reducing animation effects
  2. API Costs: Use Gemini's free tier or Pollinations to avoid API costs
  3. Accuracy: Different AI providers may produce different translation quality
  4. Offline: Cached lyrics and translations work offline

Related

Clone this wiki locally