Spotify Screensaver Handbuch

spotify-screensaver ist ein eleganter, ressourcenschonender Desktop-Bildschirmschoner mit Live-OLED-Uhr, Song-Metadaten, nativer Audio-Spektrumanalyse (PulseAudio/PipeWire) und Inaktivitäts-Daemon für Linux (WebKitGTK) und Windows (App-Mode). Die Anwendung befindet sich in Entwicklung.

Highlights in v1.4: 64-Band-FFT bei verfügbarer Audioaufnahme unter Linux; auf Windows und bei fehlendem Audiosignal wird ein synthetisches Spektrum verwendet, adaptive Farbextraktion aus Album-Covern, Werbeerkennung mit dezentem Badge und kreisförmiger Visualizer-Modus.

Architektur & MPRIS D-Bus

Unter Linux fragt die Anwendung MPRIS-kompatible Player über das Programm playerctl ab. playerctl muss dafür verfügbar sein:

• Zero-Config: Keine Eingabe von Spotify-API-Tokens oder Entwickler-Accounts nötig.
• Echtzeit-Synchronisation: Titel, Wiedergabezustand und Zeitleiste werden über playerctl abgefragt; eine verzögerungsfreie direkte D-Bus-Signalanbindung ist nicht implementiert.
• Standby-Modus: Wenn Spotify pausiert oder geschlossen ist, wechselt der Schoner in eine ruhige Uhren-Standby-Ansicht.

Audio-Spektrum & Visualizer

Bars Mode

48 diskrete Frequenzbalken mit physikalischem Peak-Hold und stufenlosem Farbverlauf.

Wave Mode

Fließende Oszilloskop-Welle mit weichem Neon-Glow und einstellbarer Sensitivität.

Circular Mode

360° radiales Spektrum rund um das Album-Cover mit pulsierenden Bass-Akzenten.

Mirrored Mode

Gespiegelte Doppelsäulen, die symmetrisch von der Mitte nach außen strahlen.

Installation & Betriebsmodi

Herunterladen & Starten

# Linux x86_64
tar -xzf spotify-screensaver-*-linux.tar.gz
./spotify-screensaver

# Vollbild-Screensaver-Modus
./spotify-screensaver -fullscreen

# Browser-Modus
./spotify-screensaver -browser

# Inaktivitäts-Timeout (automatisch nach 5 Minuten Leerlauf starten)
./spotify-screensaver --idle-timeout=300

Tastenkombinationen

Taste	Aktion
Space	Play / Pause
→ / ←	Nächster / Vorheriger Titel
↑ / ↓	Lautstärke +/- 5%
F oder F11	Vollbildmodus umschalten
ESC	Screensaver beenden / Einstellungen schließen

Sicherheit & Fehlerbehebung

Der integrierte Webserver lauscht standardmäßig auf 127.0.0.1:43210 mit Anti-DNS-Rebinding und CSRF-Schutz. OAuth-Tokens werden via AES-256-GCM und PBKDF2 (100.000 Runden) gesichert.

Fehlerbehebung: WebKitGTK Performance unter Linux

Sollte auf bestimmten GPU-Treibern (z. B. NVIDIA) ein Rendering-Lag auftreten, starte die Anwendung mit:

WEBKIT_DISABLE_DMABUF_RENDERER=1 ./spotify-screensaver