Skip to content

Themes and Visualization

vicrodh edited this page Mar 15, 2026 · 4 revisions

Themes and Visualization

Themes

QBZ ships with 17 built-in themes plus an auto-theme generator.

Built-in Themes

Theme Style
Dark Default dark theme
Light Clean light theme
OLED Black True black for OLED displays
Warm Warm-toned dark theme
Rumi
Zoey
Mira
Duotone Snow Minimal two-tone light theme
Alucard
Snow Storm Nord-inspired light
Frost Nord-inspired cool
Aurora Nord-inspired with aurora accents
Ikari Evangelion-inspired
Langley Evangelion-inspired
Ayanami Evangelion-inspired
Iscariot
System Follows your desktop environment theme

Switch themes in Settings > Appearance > Theme.

Auto-Theme

QBZ can generate a custom color theme dynamically from:

  • System Colors — matches your desktop environment's accent colors
  • Wallpaper Sync — extracts colors from your current wallpaper
  • Custom Image — generate a theme from any image you choose

Enable in Settings > Appearance > Auto-Theme. You can regenerate the theme at any time.

Immersive Player

The immersive player is a full-screen experience with album artwork and real-time audio visualizations.

Opening the Immersive Player

  • Click the album artwork or track title in the Now Playing bar
  • Press F to toggle fullscreen

Visualization Panels

The immersive player has 15+ visualization panels. Swipe or use arrow keys to switch between them:

Panel Description
Static Album artwork with track info
Visualizer Classic spectrum analyzer
Oscilloscope Real-time waveform display
Linebed 3D frequency landscape
Coverflow Album artwork carousel
Vinyl Animated spinning vinyl record
Lyrics Full synchronized lyrics display
Lyrics Focus Minimal lyrics with blurred background
Album Reactive Artwork that reacts to audio
CometFlow Particle-based frequency visualization
Energy Bands Frequency band energy meter
Lissajous Stereo phase correlation display
Neon Flow Flowing neon light visualization
Spectral Ribbon Frequency spectrum ribbon
Transient Pulse Pulse-based beat visualization
Tunnel Flow 3D tunnel reactive to audio
Queue Current queue with artwork
Suggestions AI-suggested next tracks
History Recently played tracks
Track Info Detailed track metadata and credits

Lyrics

QBZ displays synchronized lyrics when available:

  • Time-synced lyrics scroll with the music
  • Click any lyric line to seek to that position
  • Available in both dedicated Lyrics panels and as an overlay

Customizing Shortcuts

All keyboard shortcuts are fully customizable:

  1. Go to Settings > Customize Shortcuts
  2. Click any shortcut to rebind it
  3. Press the new key combination
  4. Save your changes

Clone this wiki locally