diff --git a/CHANGELOG.md b/CHANGELOG.md index 5d26826c..353f91de 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -113,6 +113,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 * In multi-select mode on **Albums**, **Random Albums**, **New Releases** and **Playlists**, holding **Shift** while clicking a second card now selects every item between the anchor (last clicked) and the click target — the standard OS-level pattern. Range expansion follows the user-visible order, so filters and sort affect what gets included. * Plain click still toggles a single item and moves the anchor to it; behaviour without Shift is unchanged. +### Help — full rewrite with live search and 10 cleanly-themed sections + +**By [@Psychotoxical](https://github.com/Psychotoxical), PR [#485](https://github.com/Psychotoxical/psysonic/pull/485)** + +* Help page rebuilt from scratch: dropped entries the UI itself answers, consolidated natural groupings, and added entries for features that didn't exist yet when the original Q/A list was written (**Orbit**, **Magic Strings**, **LUFS**, **Mini Player**, **Smart Playlists**, **Track Preview**, **Search**, **Statistics**, **Tracks** hub, **Genre Browser**, **Discord**, **Bandsintown**, **Multi-select**, **Sidebar/Home/Artist customization**, **Sleep Timer**, **Open Source Licenses**). 45 focused entries across **10 themed sections**. +* New **live in-page search**: case-insensitive substring across every Q+A, sections without hits collapse out, matches auto-expand so the answer is visible without clicking. × button clears the query. +* Translated to all **8 supported locales** (en, de, fr, nl, zh, nb, ru, es). Russian and Chinese are at machine-translation quality and would benefit from a polish pass by the original locale maintainers. + ## Fixed ### Hot cache, HTTP streaming replay, and queue source indicator diff --git a/src/locales/de.ts b/src/locales/de.ts index 80a1b401..a4a1200b 100644 --- a/src/locales/de.ts +++ b/src/locales/de.ts @@ -1003,128 +1003,118 @@ export const deTranslation = { }, help: { title: 'Hilfe', + searchPlaceholder: 'Hilfe durchsuchen…', + noResults: 'Keine passenden Themen. Versuche einen anderen Suchbegriff.', + // ── Section 1: Erste Schritte ────────────────────────────────────────── s1: 'Erste Schritte', q1: 'Welche Server sind kompatibel?', - a1: 'Psysonic funktioniert mit jedem Subsonic-kompatiblen Server: Navidrome, Gonic, Subsonic, Airsonic und anderen. Navidrome ist die empfohlene Wahl.', - q2: 'Wie verbinde ich mich mit meinem Server?', - a2: 'Öffne die Einstellungen und klicke auf "Server hinzufügen". Gib die Server-URL (z. B. 192.168.1.100:4533), Benutzername und Passwort ein. Psysonic testet die Verbindung vor dem Speichern — bei Fehler wird nichts gespeichert.', - q3: 'Kann ich mehrere Server verwenden?', - a3: 'Ja. Du kannst beliebig viele Server in den Einstellungen hinzufügen und jederzeit zwischen ihnen wechseln. Immer ist nur ein Server aktiv.', - s2: 'Wiedergabe', - q4: 'Wie spiele ich Musik ab?', - a4: 'Doppelklick auf einen Track startet die Wiedergabe. Auf Album- und Künstlerseiten gibt es "Alle abspielen". Tracks lassen sich auch per Drag & Drop in die Warteschlange ziehen.', - q5: 'Welche Tastenkürzel gibt es?', - a5: 'Leertaste = Play / Pause · Escape = Vollbild schließen. Medientasten (Play/Pause, Weiter, Zurück) funktionieren auf allen Plattformen. Unter Linux bitte die Buttons in der Playerleiste nutzen. In-App-Kürzel und systemweite globale Shortcuts können in Einstellungen → Tastenkürzel / Globale Shortcuts angepasst werden.', - q6: 'Was ist die Warteschlange?', - a6: 'Die Warteschlange zeigt alle kommenden Tracks. Öffnen mit dem Panel-Icon oben rechts im Header (neben dem Now-Playing-Indikator). Tracks per Drag & Drop umsortieren, mit dem Shuffle-Button mischen oder als Playlist speichern.', - q7: 'Wie öffne ich den Vollbild-Player?', - a7: 'Klick auf das Album-Cover unten in der Playerleiste oder auf das Expand-Icon daneben. Mit Escape wieder schließen.', - q8: 'Wie funktioniert die Wiederholfunktion?', - a8: 'Klick auf den Wiederhol-Button in der Playerleiste, um zwischen den Modi zu wechseln: Aus → Alles wiederholen → Einen wiederholen.', - s3: 'Bibliothek', - q9: 'Wie lade ich ein Album herunter?', - a9: 'Auf der Album-Detailseite auf "Download (ZIP)" klicken. Der Server packt das Album zunächst in eine ZIP-Datei — bei großen Alben oder verlustfreien Dateien (FLAC / WAV) kann es einen Moment dauern, bevor der Download tatsächlich startet. Das ist normal: Der Fortschrittsbalken erscheint erst, wenn der Server fertig ist und die Übertragung beginnt.', - q10: 'Wie markiere ich Tracks und Alben als Favoriten?', - a10: 'Das Stern-Icon auf einem Track oder im Album-Header anklicken. Markierte Einträge erscheinen im Bereich "Favoriten" in der Seitenleiste.', - q11: 'Was ist das Karussell auf der Startseite?', - a11: 'Das Banner oben auf der Startseite wählt zufällige Alben aus der Bibliothek und rotiert alle 10 Sekunden weiter. Mit den Punkten kann man manuell springen, Klick auf das Banner öffnet das Album.', - s4: 'Einstellungen', - q12: 'Wie ändere ich das Theme?', - a12: 'Einstellungen → Design. Eine große Auswahl an Themes in 8 Gruppen: Psysonic Themes, Mediaplayer, Betriebssysteme, Spiele, Filme, Serien, Social Media und Open-Source-Classics (Catppuccin, Nord, Gruvbox, Nightfox).', - q13: 'Wie ändere ich die Sprache?', - a13: 'Einstellungen → Sprache. Englisch, Deutsch, Französisch, Niederländisch und Chinesisch werden unterstützt.', - q15: 'Wie lege ich einen Download-Ordner fest?', - a15: 'Einstellungen → App-Verhalten → Download-Ordner. Beliebigen Ordner wählen — heruntergeladene Alben werden dort als ZIP gespeichert. Ohne eigenen Ordner landet alles im Standard-Downloads-Ordner.', - s5: 'Scrobbling', - q16: 'Wie funktioniert Scrobbling?', - a16: 'Psysonic scrobbled direkt zu Last.fm — keine Navidrome-Konfiguration nötig. Last.fm-Konto in Einstellungen → Last.fm verbinden und Scrobbling dort aktivieren.', - q17: 'Wann wird ein Scrobble gesendet?', - a17: 'Ein Scrobble wird übermittelt, wenn 50 % eines Tracks gehört wurden.', - q22: 'Was ist die Waveform in der Playerleiste?', - a22: 'Die Waveform-Leiste ersetzt den klassischen Fortschrittsbalken. Klick auf eine beliebige Stelle zum Springen, ziehen zum Scrubben. Der gespielte Teil leuchtet in einem Blau-Mauve-Farbverlauf, der gepufferte Bereich erscheint etwas heller, der ungespielter Teil ist abgeblendet.', - q24: 'Kann ich die Warteschlange mischen?', - a24: 'Ja. Die Warteschlange öffnen und auf das Shuffle-Icon im Header klicken. Der aktuell laufende Track bleibt an Position 1 — alle restlichen Tracks werden zufällig neu geordnet.', - q25: 'Öffnen Last.fm- und Wikipedia-Links auf Künstlerseiten im Browser?', - a25: 'Ja — sie öffnen sich im Standard-Systembrowser. Der Button zeigt kurz eine Bestätigungsmeldung beim Klick.', - s7: 'Zufallsmix', - q26: 'Was ist der Zufallsmix?', - a26: 'Der Zufallsmix erstellt eine Playlist aus zufälligen Tracks deiner gesamten Bibliothek. Über "Zufallsmix" in der Seitenleiste erreichbar, dann "Neuer Mix" klicken. Die Anzahl der Tracks ist vor der Generierung einstellbar.', - q27: 'Was ist der Keyword-Filter?', - a27: 'Der Keyword-Filter schließt Tracks aus, deren Genre, Titel oder Album bestimmte Wörter enthält. Hörbücher werden automatisch gefiltert. Eigene Keywords in Einstellungen → Zufallsmix hinzufügen oder per Klick auf ein Genre-Tag direkt in der Trackliste.', - q28: 'Was ist der Super-Genre-Mix?', - a28: 'Der Super-Genre-Mix fasst die Bibliothek in übergeordnete Kategorien zusammen (Rock, Metal, Electronic, Jazz, Klassik usw.) und erstellt daraus einen fokussierten Mix. Einen Kategorie-Chip unterhalb der Trackliste auswählen. Ergebnisse erscheinen schrittweise, während die einzelnen Sub-Genres geladen werden.', - s6: 'Problemlösung', - q18: 'Cover und Künstlerbilder laden langsam.', - a18: 'Bilder werden beim ersten Aufruf vom Server geholt und dann 30 Tage lokal gecacht. Bei langsamen Server-Festplatten kann der erste Seitenaufruf einen Moment dauern. Danach geht alles sofort.', - q19: 'Der Verbindungstest schlägt fehl.', - a19: 'URL inklusive Port prüfen (z. B. http://192.168.1.100:4533). Sicherstellen, dass keine Firewall die Verbindung blockiert. Im lokalen Netzwerk http:// statt https:// versuchen. Benutzername und Passwort kontrollieren.', - q20: 'Kein Ton unter Linux.', - a20: 'Psysonic ist als .deb (Ubuntu/Debian), .rpm (Fedora/RHEL) und über AUR für Arch/CachyOS verfügbar (yay -S psysonic). Es gibt kein AppImage. Falls kein Ton kommt, sicherstellen, dass PipeWire oder PulseAudio läuft.', - q21: 'Die App zeigt einen schwarzen Bildschirm unter Linux.', - a21: 'Meist ein GPU/EGL-Treiberproblem in WebKitGTK. Mit GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 starten. Das AUR-Paket und die offiziellen .deb/.rpm-Pakete setzen diese Variablen automatisch.', - q29: 'Was sind Crossfade und nahtlose Wiedergabe?', - a29: 'Beides sind experimentelle Audiofunktionen in Einstellungen → Audio. Nahtlose Wiedergabe puffert den nächsten Track vor, um Stille zu eliminieren. Crossfade blendet den aktuellen Track aus, während der nächste eingeblendet wird — Dauer (1–10 s) einstellbar.', - q30: 'Zeigt Psysonic Songtexte an?', - a30: 'Ja. Klick auf das Mikrofon-Icon in der Playerleiste öffnet den Lyrics-Tab im Queue-Panel. Psysonic lädt Texte automatisch von LRCLIB. Sind synchronisierte Lyrics verfügbar, wird die aktuelle Zeile hervorgehoben und scrollt in Echtzeit mit. Bei reinen Texten wird der Volltext statisch angezeigt.', - q31: 'Kann ich Tastenkürzel anpassen?', - a31: 'Ja. Einstellungen → Tastenkürzel erlaubt das Neuzuordnen von In-App-Aktionen (Play/Pause, Weiter, Zurück, Lautstärke, Vollbild u. v. m.). Einstellungen → Globale Shortcuts ermöglicht systemweite Kürzel, die auch im Hintergrund ausgelöst werden.', - q32: 'Kann ich die Schriftart ändern?', - a32: 'Ja. Einstellungen → Schriftart bietet 10 Schriften zur Auswahl, darunter IBM Plex Mono, Fira Code, JetBrains Mono und Courier Prime. Die gewählte Schrift gilt für die gesamte Oberfläche.', - s8: 'Offline-Modus', - q34: 'Was ist der Offline-Modus?', - a34: 'Der Offline-Modus (Beta) ermöglicht das Zwischenspeichern von Alben auf dem Gerät, sodass die Wiedergabe ohne aktive Serververbindung möglich ist. Gecachte Tracks werden lokal gespeichert und direkt von der Festplatte abgespielt — ohne Netzwerkzugriff.', - q35: 'Wie speichere ich ein Album für die Offline-Nutzung?', - a35: 'Album öffnen und auf das Download-Symbol im Album-Header klicken. Psysonic lädt alle Tracks im Hintergrund herunter. Der Fortschritt wird am Button angezeigt. Nach dem Download wird das Symbol grün. Gecachte Alben können in der Offline-Bibliothek (Seitenleiste) verwaltet und gelöscht werden.', - q36: 'Wie viel Speicherplatz darf der Cache belegen?', - a36: 'In Einstellungen → Bibliothek kann eine maximale Cache-Größe festgelegt werden. Wird das Limit erreicht, erscheint ein Warnbanner auf der Albumseite. Einzelne Alben können in der Offline-Bibliothek gelöscht werden, um Speicherplatz freizugeben.', - q37: 'Wie bewerte ich Songs, Alben und Künstler?', - a37: 'Psysonic unterstützt 1–5-Sterne-Bewertungen über die OpenSubsonic-API (erfordert Navidrome ≥ 0.53). Songs können in der Trackliste eines Albums oder einer Playlist (Spalte „Bewertung"), über das Rechtsklick-Kontextmenü oder direkt in der Playerleiste unterhalb des Künstlernamens bewertet werden. Alben werden auf der Albumdetailseite bewertet, Künstler auf der Künstlerseite. Bewertungen werden sofort an den Server übertragen.', - q38: 'Kann ich eine Bewertung entfernen oder ändern?', - a38: 'Ja. Ein erneuter Klick auf den bereits aktiven Stern entfernt die Bewertung vollständig – der zweite Klick auf denselben Stern löscht sie also. Um eine Bewertung zu ändern, einfach einen anderen Stern anklicken.', - q39: 'Was ist Skip-to-1★ und der Bewertungsfilter?', - a39: 'Skip-to-1★ vergibt automatisch eine 1-Stern-Bewertung, wenn ein Song mehrfach hintereinander manuell übersprungen wird. Aktivierung und Schwellenwert in Einstellungen → Bewertungen. Dort lässt sich auch eine Mindestbewertung für Zufalls-Mix und Zufallsalben festlegen – so werden nur Songs, Alben oder Künstler ab einer bestimmten Sternzahl in generierten Mixes berücksichtigt.', - q40: 'Was ist der Ordner-Browser?', - a40: 'Der Ordner-Browser (Sidebar) ermöglicht die Navigation im Musikverzeichnis des Servers über ein Miller-Column-Layout. Ein Klick auf einen Ordner öffnet dessen Inhalt; über das Play-Symbol lassen sich Ordner direkt abspielen oder zur Warteschlange hinzufügen.', - q41: 'Was ist der Theme-Scheduler?', - a41: 'Einstellungen → Darstellung → Theme automatisch wechseln: Tagesthema und Nachtthema mit Startzeiten konfigurieren. Psysonic wechselt automatisch zur eingestellten Uhrzeit. Ist der Scheduler aktiv, erscheint im Theme-Picker ein Hinweis, warum manuelle Änderungen keine sofortige Wirkung haben.', - q42: 'Kann ich die Benutzeroberfläche vergrößern oder verkleinern?', - a42: 'Ja. Einstellungen → Darstellung → Anzeigeskalierung ermöglicht eine Skalierung der gesamten Oberfläche zwischen 80 % und 125 %, unabhängig von der Systemschriftgröße.', - q43: 'Kann ich den Stil der Seekbar ändern?', - a43: 'Ja. Einstellungen → Darstellung → Seekbar-Stil bietet 10 Stile: Wellenform, Linie & Punkt, Balken, Dicker Balken, Segmentiert, Neon-Glow, Pulswelle, Partikelspur, Flüssigfüllung und Retro-Tape.', - q44: 'Was ist AutoEQ?', - a44: 'Der 10-Band-EQ in Einstellungen → Audio enthält eine AutoEQ-Suche. Kopfhörermodell eingeben – Psysonic lädt das Korrekturprofil aus der AutoEQ-Datenbank und überträgt es automatisch auf die EQ-Bänder.', - q45: 'Was ist Replay Gain?', - a45: 'Replay Gain normalisiert die Lautstärke, sodass laute und leise Alben auf einem gleichmäßigen Pegel wiedergegeben werden. Aktivierung in Einstellungen → Audio → Replay Gain; Modus Track (pro Song) oder Album (behält die relative Dynamik innerhalb eines Albums).', - q46: 'Was ist der Hot Cache?', - a46: 'Der Hot Cache (Alpha, Einstellungen → Bibliothek) lädt die nächsten Songs der Warteschlange vorab auf die Festplatte, damit die Wiedergabe ohne Pufferverzögerung startet – besonders nützlich bei langsamen oder entfernten Servern. Psysonic hält den aktuellen Track und die nächsten 5 im Cache und verdrängt ältere Einträge, wenn das Größenlimit erreicht wird. Cache-Größe und Debounce-Verzögerung sind konfigurierbar.', - q47: 'Kann ich eine Playlist offline cachen?', - a47: 'Ja. In den Playlist-Details auf das Download-Symbol klicken – alle Tracks werden im Hintergrund heruntergeladen. Ist die Playlist vollständig gecacht, wechselt das Symbol zu einem roten Papierkorb; ein erneuter Klick entfernt die Playlist aus dem Offline-Cache.', - q48: 'Was ist die Infinite Queue?', - a48: 'Wenn die Warteschlange leer läuft und Wiederholen deaktiviert ist, fügt Psysonic automatisch zufällige Tracks aus deiner Bibliothek hinzu, damit die Wiedergabe nie stoppt. Automatisch hinzugefügte Tracks erscheinen unterhalb des Trenners „— Automatisch hinzugefügt —". Umschalten über das Unendlichkeitssymbol im Warteschlangen-Header. In Einstellungen → Warteschlange kann der automatische Nachschub auf ein bestimmtes Genre beschränkt werden.', - q49: 'Kann ich Psysonic über die Kommandozeile bedienen?', - a49: 'Ja – das Psysonic-Binary kann die laufende App fernsteuern. Beispiele: psysonic --player play / pause / next / prev, --player volume 75, --player seek 15, --player mute, --player shuffle, --player repeat off|all|one, --player star / unstar, --player rating 1–5. Außerdem: Server wechseln (--player server list / set), Ausgabegerät wählen (--player audio-device list / set), Bibliotheks-Ordner filtern (--player library list / set), Instant Mix starten (--player mix new / append) und Suche (--player search track|album|artist ). Vollständige Hilfe: psysonic --player --help. Shell-Completions für bash und zsh sind über psysonic completions verfügbar.', - q50: 'Wie verwalte ich Playlists?', - a50: 'Über „Playlists" in der Seitenleiste. Mit „Neue Playlist" eine Playlist erstellen. In der Playlist-Detailansicht können Tracks per Drag & Drop umsortiert, mit dem ×-Button entfernt und über die Songsuche neue hinzugefügt werden. Die „Vorschläge"-Sektion macht Empfehlungen basierend auf dem Inhalt der Playlist. Rechtsklick auf einen Track für weitere Optionen.', - q51: 'Kann ich meine Einstellungen sichern und wiederherstellen?', - a51: 'Ja. Einstellungen → Backup & Restore ermöglicht den Export aller Einstellungen, Serverprofile, Themes und Tastenkürzel in eine JSON-Datei. Auf einem anderen Gerät oder nach einer Neuinstallation importieren, um alles auf einmal wiederherzustellen. Passwörter sind in der Sicherung enthalten – die Datei sicher aufbewahren.', - q52: 'Wie ändere ich das Audioausgabegerät?', - a52: 'Einstellungen → Audio → Ausgabegerät. Psysonic listet alle verfügbaren Ausgaben auf. Auswahl wechselt die Wiedergabe sofort. Den Aktualisierungsbutton daneben nutzen, wenn ein Gerät nach dem App-Start angeschlossen wurde. Unter Linux werden ALSA-Gerätenamen bereinigt angezeigt.', - q53: 'Was ist Device Sync?', - a53: 'Device Sync überträgt Alben, Playlists oder ganze Künstler auf einen USB-Stick oder eine SD-Karte. Über „Device Sync" in der Seitenleiste öffnen, einen Zielordner auf dem Laufwerk wählen, Quellen in den Browser-Tabs auswählen und auf „Auf Gerät übertragen" klicken. Psysonic lädt die Tracks vom Server und legt sie in der durch die Dateinamen-Vorlage definierten Ordnerstruktur ab.', - q54: 'Was ist die Dateinamen-Vorlage in Device Sync?', - a54: 'Die Dateinamen-Vorlage steuert, wie Tracks auf dem Gerät benannt und organisiert werden. Vorgaben (Standard, Multi-Disc, Alt. Ordner) auswählen oder selbst aus den klickbaren Token-Chips zusammenbauen: {artist}, {album}, {title}, {track_number}, {disc_number}, {year} und / als Ordner-Trennzeichen. Eine Live-Vorschau zeigt, wie ein Beispiel-Track benannt würde.', - q55: 'Funktioniert Device Sync plattformübergreifend?', - a55: 'Ja. Das auf dem Gerät gespeicherte Manifest (psysonic-sync.json) enthält die beim Sync verwendete Dateinamen-Vorlage. Wird Device Sync auf einem anderen Betriebssystem mit anderer Vorlage geöffnet, erkennt Psysonic die bereits vorhandenen Dateien korrekt – Alben werden nicht fälschlich als ausstehend angezeigt.', - s9: 'Device Sync', - q56: 'Was ist Internet Radio?', - a56: 'Die Internetradio-Seite (Seitenleiste) ermöglicht die Wiedergabe beliebiger Livestreams direkt in Psysonic. Sender werden vom Navidrome-Server bezogen – dort über das Admin-Panel hinzufügen oder eine .pls- / .m3u-Datei importieren. Die Wiedergabe erfolgt über HTML5-Audio, nicht den Rust-Audio-Engine – einige EQ- und Replay-Gain-Einstellungen gelten daher nicht für Radio.', - q57: 'Welche Stream-Formate unterstützt Internet Radio?', - a57: 'Psysonic unterstützt alle Formate, die der Audio-Stack des Systems dekodieren kann: MP3, AAC, OGG Vorbis und die meisten HLS-Streams. Da HTML5-Audio verwendet wird, hängt die Codec-Unterstützung von der Plattform ab – MP3 und AAC funktionieren überall.', - s10: 'Internet Radio', - q58: 'Woher bezieht Psysonic Songtexte?', - a58: 'Psysonic unterstützt drei Lyrics-Quellen, alle konfigurierbar in Einstellungen → Lyrics: Navidrome-Server (eingebettete/OpenSubsonic-Lyrics), LRCLIB (community-gepflegte synchronisierte Texte) und NetEase Cloud Music (umfangreicher internationaler Katalog). Jede Quelle kann aktiviert/deaktiviert und per Drag & Drop priorisiert werden. Synchronisierte Lyrics scrollen automatisch und unterstützen Klick-zum-Springen.', - q59: 'Gibt es eine Ansicht, was andere Nutzer gerade hören?', - a59: 'Ja. Das Broadcast-Symbol oben rechts im Header öffnet das „Now Playing"-Dropdown. Es zeigt, was andere Nutzer auf dem Navidrome-Server gerade hören – aktualisiert alle 10 Sekunden. Der eigene Eintrag verschwindet beim Pausieren.', + a1: 'Psysonic ist primär für Navidrome gebaut und voll Subsonic-kompatibel — Gonic, Airsonic, LMS und andere Subsonic-API-Server funktionieren ebenfalls. Einige fortgeschrittene Features (Bewertungen, Smart Playlists, Magic-String-Sharing, User-Verwaltung) erfordern Navidrome.', + q2: 'Wie füge ich einen Server hinzu?', + a2: 'Einstellungen → Server → Server hinzufügen. URL eingeben (z. B. http://192.168.1.100:4533), Benutzername und Passwort. Psysonic testet die Verbindung vor dem Speichern — bei Fehler wird nichts gespeichert. Du kannst beliebig viele Server hinzufügen und im Header zwischen ihnen wechseln; immer ist nur einer aktiv.', + q3: 'Schnelle UI-Tour?', + a3: 'Sidebar (links) für Navigation, Mainstage / Seiten in der Mitte, Playerleiste unten, Warteschlangen-Panel rechts (über das Icon oben rechts neben dem Now-Playing-Indikator). Die Suche oben durchsucht die gesamte Bibliothek; "Now Playing" zeigt, was andere Nutzer auf dem gleichen Navidrome-Server gerade hören.', + // ── Section 2: Wiedergabe & Warteschlange ────────────────────────────── + s2: 'Wiedergabe & Warteschlange', + q4: 'Wie nutze ich die Warteschlange?', + a4: 'Warteschlangen-Panel oben rechts öffnen. Zeilen per Drag & Drop umsortieren, nach außen ziehen zum Entfernen, oder über die Toolbar mischen, als Playlist speichern oder zu einem Track springen. Zeilen lassen sich auch aus dem Panel heraus an andere Stellen ziehen.', + q5: 'Gapless vs. Crossfade — was ist der Unterschied?', + a5: 'Gapless puffert den nächsten Track vor, sodass keine Stille zwischen Songs entsteht (ideal für Live-Alben und DJ-Mixe). Crossfade blendet den aktuellen Track aus, während der nächste eingeblendet wird (1–10 s, gut für gemischte Mixe). Die zwei sind gegenseitig exklusiv — eines aktivieren deaktiviert das andere. Konfiguration in Einstellungen → Audio.', + q6: 'Was ist die Infinite Queue?', + a6: 'Wenn die Warteschlange leerläuft und Wiederholen aus ist, hängt Psysonic ähnliche / zufällige Tracks aus deiner Bibliothek hinten dran, sodass die Wiedergabe nie stoppt. Auto-hinzugefügte Tracks erscheinen unter dem Trenner „— Automatisch hinzugefügt —". Umschalten über das Unendlichkeits-Icon im Warteschlangen-Header; in Einstellungen → Warteschlange auf ein Genre einschränken.', + q7: 'Mehrfachauswahl und Shift-Klick-Bereich?', + a7: 'Im Mehrfach-Modus auf Alben / New Releases / Random Albums / Playlists: Klick toggelt einen Eintrag, dann Shift halten und einen anderen Eintrag klicken — alles dazwischen in der sichtbaren Reihenfolge wird ausgewählt. Shift-Klicks erweitern vom zuletzt geklickten Anker. Die Toolbar oben bietet Bulk-Aktionen (Queue, Download, Löschen usw.).', + q8: 'Tastenkürzel und globale Hotkeys?', + a8: 'Standard-In-App-Tasten: Leertaste = Play / Pause, Esc = Vollbild / Modal schließen, F1 = Shortcut-Spickzettel. Einstellungen → Eingabe lässt jede In-App-Aktion neu zuweisen (auch als Akkorde wie Strg+Shift+P) und systemweite globale Shortcuts setzen, die auch im Hintergrund oder minimiert funktionieren. Medientasten (Play/Pause, Weiter, Zurück) funktionieren auf allen Plattformen.', + // ── Section 3: Audio-Werkzeuge ───────────────────────────────────────── + s3: 'Audio-Werkzeuge', + q9: 'Replay-Gain-Modi?', + a9: 'Einstellungen → Audio → Replay Gain. Track-Modus normalisiert jeden Song auf einen Zielpegel. Album-Modus erhält die Lautstärke-Kurve innerhalb eines Albums. Auto-Modus wählt Track oder Album je nachdem, ob die Warteschlange aus einem einzelnen Album stammt. Tracks ohne Replay-Gain-Tags fallen auf einen konfigurierbaren Preamp zurück.', + q10: 'Was ist Smart Loudness Normalization (LUFS)?', + a10: 'Eine moderne Alternative zu Replay Gain in Einstellungen → Audio. Psysonic analysiert jeden Track nach LUFS / EBU R128 und speichert das Ergebnis, sodass die Lautstärke über die gesamte Bibliothek konsistent ist — auch bei Tracks ohne Replay-Gain-Tags. Die Cold-Cache-Analyse läuft im Hintergrund und nutzt 35–40 % CPU für ~1 Minute, danach 0. Ziel-Lautstärke (Standard −10 LUFS) einmal festlegen.', + q11: 'EQ und AutoEQ?', + a11: 'Ein 10-Band-Parametrik-EQ in Einstellungen → Audio → Equalizer mit manuellen Bändern und Presets. AutoEQ daneben holt ein gemessenes Korrekturprofil für dein Kopfhörermodell aus der AutoEQ-Datenbank und überträgt es automatisch auf die Bänder — Kopfhörer wählen, der EQ rastet auf der korrekten Kurve ein.', + q12: 'Wie wechsle ich das Audio-Ausgabegerät?', + a12: 'Einstellungen → Audio → Ausgabegerät. Psysonic listet alle verfügbaren Ausgaben und wechselt sofort beim Auswählen. Der Aktualisierungs-Button scannt nach Geräten, die nach dem Start angeschlossen wurden. Linux-ALSA-Namen wie „sysdefault" werden für die Lesbarkeit automatisch bereinigt.', + q13: 'Was ist der Hot Cache?', + a13: 'Der Hot Cache lädt den aktuellen Track plus die nächsten in den RAM und auf die Festplatte vor, sodass die Wiedergabe ohne Pufferverzögerung startet — besonders nützlich bei langsamen / entfernten Servern. Eviction greift, wenn das Größenlimit erreicht ist. Größe und Debounce-Verzögerung (damit schnelle Skips nicht überfetchen) in Einstellungen → Audio.', + // ── Section 4: Bibliothek & Discovery ────────────────────────────────── + s4: 'Bibliothek & Discovery', + q14: 'Wie funktionieren Bewertungen und Skip-to-1★?', + a14: 'Psysonic unterstützt 1–5-Sterne-Bewertungen über OpenSubsonic (Navidrome ≥ 0.53). Songs in Tracklisten, im Rechtsklick-Menü oder in der Playerleiste unter dem Künstlernamen bewerten; Alben auf der Albumseite; Künstler auf der Künstlerseite. Skip-to-1★ (Einstellungen → Bibliothek → Bewertungen) vergibt automatisch 1 Stern nach einer konfigurierbaren Anzahl aufeinanderfolgender Skips. Im selben Panel lässt sich eine Mindestbewertung als Filter für Random Mix und andere Mixes setzen.', + q15: 'Wie browse ich — Ordner, Genres, Tracks?', + a15: 'Der Ordner-Browser (Sidebar) navigiert durch das Musikverzeichnis des Servers im Miller-Column-Layout — Klick auf Ordner zum Öffnen, Klick auf Track oder Play-Icon eines Ordners zum Abspielen / Hinzufügen. Genres nutzt eine nach Track-Anzahl skalierte Tag-Cloud; Klick auf ein Genre öffnet es. Tracks ist ein flacher Library-Hub mit spaltensortierbarer virtueller Liste und Live-Suche.', + q16: 'Suche und erweiterte Suche?', + a16: 'Die Header-Suche läuft live während der Eingabe und durchsucht Künstler, Alben und Tracks. Die erweiterte Suche (Sidebar) bietet eine reichere Sicht: Filter nach Jahr, Genre, Bewertung, Format, Kanälen, Sample-Rate, BPM, Stimmung, kombinierbar. Rechtsklick auf jeden Treffer öffnet das gleiche Kontextmenü wie überall sonst in der App.', + q17: 'Was sind die Mixes (Random / Genre / Super Genre / Lucky)?', + a17: 'Random Mix erstellt eine Playlist aus zufälligen Tracks deiner Bibliothek; der Schlüsselwort-Filter schließt Hörbücher, Comedy etc. nach Genre / Titel / Album-Substrings aus. Super-Genre-Mix gruppiert deine Bibliothek in breite Stile (Rock, Metal, Electronic, Jazz, Klassik …) und erstellt einen fokussierten Mix. Lucky Mix nutzt Hörhistorie, Bewertungen und AudioMuse-AI-ähnliche Tracks, um per Klick eine sofortige Playlist zu bauen.', + q18: 'Statistik-Seite?', + a18: 'Statistik (Sidebar) zeigt Top-Künstler, Top-Alben, Top-Tracks, Genre-Verteilung, Hörzeit über die Zeit und pro Bibliothek, wenn mehrere Music Folder konfiguriert sind. Mehrere Ansichten lassen sich als teilbares Card-Bild exportieren.', + q19: 'Wie lade ich ein Album als ZIP herunter?', + a19: 'Albumseite → „Download (ZIP)". Der Server packt das Album zuerst — bei großen oder verlustfreien Alben (FLAC / WAV) erscheint der Fortschrittsbalken erst, wenn das Zippen fertig ist und der Transfer beginnt. Das ist normal.', + // ── Section 5: Lyrics ────────────────────────────────────────────────── + s5: 'Lyrics', + q20: 'Woher kommen die Lyrics?', + a20: 'Drei Quellen, konfigurierbar in Einstellungen → Lyrics: Navidrome-Server (eingebettete / OpenSubsonic-Lyrics), LRCLIB (community-gepflegte synchronisierte Texte) und NetEase Cloud Music (umfangreicher asiatischer + internationaler Katalog). Jede Quelle aktivieren / deaktivieren und per Drag & Drop priorisieren.', + q21: 'Wie zeige ich Lyrics während der Wiedergabe?', + a21: 'Klick auf das Mikrofon-Icon in der Playerleiste öffnet den Lyrics-Tab im Warteschlangen-Panel. Synchronisierte Lyrics scrollen automatisch und unterstützen Klick-zum-Springen; reine Texte scrollen als statischer Block. Den Vollbild-Player über das Cover in der Playerleiste öffnen für eine immersive Lyrics-Ansicht mit Mesh-Blob-Hintergrund.', + // ── Section 6: Sharing & Social ──────────────────────────────────────── + s6: 'Sharing & Social', + q22: 'Was sind Magic Strings?', + a22: 'Magic Strings sind kurze Copy-Paste-Tokens, die Dinge zwischen Psysonic-Nutzern ohne Drittanbieter-Server teilen. Server-Einladungs-Strings ermöglichen einem Freund das Onboarding auf deinem Navidrome mit einem Paste; Album- / Künstler- / Queue-Magic-Strings öffnen dasselbe Album / denselben Künstler / dieselbe Queue beim Empfänger. Aus dem Teilen-Menü generieren, in die Suche einfügen zum Konsumieren.', + q23: 'Was ist Orbit?', + a23: 'Orbit ist synchrones Zusammenhören: ein Host spielt einen Track, alle Gäste hören ihn synchron, und Gäste können Songs vorschlagen, die der Host in die Queue annehmen kann. Session über den Orbit-Button im Header starten, Einladungslink teilen, andere können von jeder Psysonic-Installation beitreten. Der Host kontrolliert die Wiedergabe (Skip, Seek, Queue) — Gäste sehen den Stand in Echtzeit und können Vorschläge machen. Sessions sind ephemer und enden, wenn der Host sie schließt.', + q24: 'Was ist das Now-Playing-Dropdown?', + a24: 'Das Broadcast-Symbol oben rechts im Header zeigt, was andere Nutzer auf deinem Navidrome-Server gerade hören, aktualisiert alle 10 Sekunden. Der eigene Eintrag verschwindet sofort beim Pausieren. Per-Server — Nutzer auf einem anderen aktiven Server werden nicht angezeigt.', + // ── Section 7: Personalisierung ──────────────────────────────────────── + s7: 'Personalisierung', + q25: 'Themes und der Theme-Scheduler?', + a25: 'Einstellungen → Darstellung → Theme bietet 60+ Themes in 8 Gruppen (Psysonic, Mediaplayer, Betriebssysteme, Spiele, Filme, Serien, Social Media, Open Source Classics — Catppuccin / Nord / Gruvbox / Nightfox / Dracula). Auto-Switch-Theme erlaubt das Setzen von Tag- und Nacht-Theme mit Startzeiten, sodass Psysonic automatisch wechselt.', + q26: 'Kann ich Sidebar, Home und Künstlerseite anpassen?', + a26: 'Ja — Einstellungen → Personalisierung. Der Sidebar-Customizer erlaubt das Umsortieren der Nav-Items per Drag und das Ausblenden ungenutzter. Der Home-Customizer schaltet jede Mainstage-Reihe (Hero, Recent, Discover, Recently Played, Starred …) ein/aus. Der Artist-Page-Customizer ordnet die Sektionen (Top Songs, Alben, Singles, Compilations, ähnliche Künstler usw.) um und blendet ungenutzte aus.', + q27: 'Was ist der Mini-Player?', + a27: 'Ein kleines schwebendes Fenster mit Cover, Transport-Controls und kompakter Queue. Über das Mini-Player-Icon in der Playerleiste oder das zugehörige Tastenkürzel öffnen. Das Fenster merkt sich Position und Größe zwischen Sessions. Auf Windows wird die Mini-Webview beim Start vorerstellt, sodass das Öffnen sofort geschieht; Linux / macOS aktivieren das optional über Einstellungen → Darstellung → Mini-Player vorladen.', + q28: 'Was ist die Floating Player Bar?', + a28: 'Eine optionale Playerleisten-Variante (Einstellungen → Darstellung), die sich mit themed Hintergrund, Akzent-Border, abgerundetem Cover und zentriertem Lautstärke-Bereich vom unteren Rand löst. Nützlich auf hohen Monitoren oder kompakten Themes.', + q29: 'Track-Vorschau beim Hovern?', + a29: 'Über eine Track-Zeile hovern, den kleinen Vorschau-Button auf dem Cover klicken oder die Vorschau über das Rechtsklick-Menü auslösen — Psysonic streamt die ersten ~15 s durch dieselbe Rust-Audio-Engine, sodass Loudness-Normalisierung greift. Praktisch beim Durchblättern eines neuen Albums.', + q30: 'Sleep-Timer?', + a30: 'Klick auf das Mond-Icon in der Playerleiste öffnet den Sleep-Timer. Eine Dauer wählen (oder „Ende des aktuellen Tracks") und Psysonic blendet aus und pausiert am Ende. Der Button zeigt einen Kreis-Ring und einen Countdown im Button, während der Timer läuft.', + q31: 'UI-Skalierung, Schrift, Seekbar-Stil?', + a31: 'Einstellungen → Darstellung — Anzeigeskalierung (80–125 %, ohne System-Schriftgröße zu beeinflussen), Schrift (10 UI-Schriften, u. a. IBM Plex Mono, Fira Code, Geist, Golos Text …), Seekbar-Stil (Wellenform analysiert / Pseudowave deterministisch / Linie & Punkt / Balken / Dicker Balken / Segmentiert / Neon-Glow / Pulswelle / Partikelspur / Flüssigfüllung / Retro-Tape).', + // ── Section 8: Power User ────────────────────────────────────────────── + s8: 'Power User', + q32: 'CLI-Player-Steuerung?', + a32: 'Das Psysonic-Binary kann als Fernsteuerung dienen. Beispiele: psysonic --player play / pause / next / prev, --player volume 75, --player seek 15, --player shuffle, --player repeat off|all|one, --player rating 1-5. Server, Audiogeräte, Bibliotheken wechseln; Instant Mix triggern; Künstler / Alben / Tracks suchen. Vollständige Liste mit psysonic --player --help. Shell-Completions für bash und zsh über psysonic completions.', + q33: 'Smart Playlists (Navidrome)?', + a33: 'Smart Playlists sind serverseitige dynamische Playlists, die durch Regeln definiert werden (Genre = Rock UND Jahr > 2020 etc.). Die Playlists-Seite in Psysonic erlaubt das Erstellen, Bearbeiten und Löschen mit visuellem Regel-Editor — Psysonic spricht dafür mit der Navidrome Native API. Sie verhalten sich wie normale Playlists im Rest der App und aktualisieren sich automatisch, wenn sich die Bibliothek ändert.', + q34: 'Einstellungen sichern und wiederherstellen?', + a34: 'Einstellungen → Storage → Backup & Restore exportiert Server-Profile, Themes, Tastenkürzel und andere Einstellungen in eine einzige JSON-Datei. Auf einem anderen Gerät oder nach einer Neuinstallation importieren, um alles auf einmal wiederherzustellen. Server-Passwörter sind enthalten — Datei sicher aufbewahren.', + q35: 'Wo sehe ich alle Open-Source-Lizenzen?', + a35: 'Einstellungen → System → Open Source Licenses. Die volle Abhängigkeitsliste (Cargo-Crates und npm-Pakete) wird mit gebündelten Lizenztexten ausgeliefert. Klick auf einen Eintrag öffnet den vollen Text; der kuratierte Highlight-Block oben hebt die User-bekannten Bibliotheken hervor (Tauri, React, rodio, symphonia usw.).', + // ── Section 9: Offline & Sync ────────────────────────────────────────── + s9: 'Offline & Sync', + q36: 'Offline-Modus — Alben und Playlists cachen?', + a36: 'Album oder Playlist öffnen und das Download-Icon im Header klicken — Psysonic cacht jeden Track lokal, sodass er ohne Netzwerkzugriff abspielt. Die Offline-Bibliothek (Sidebar) listet alles Gecachte, zeigt laufende Downloads und erlaubt das Entfernen über das Papierkorb-Icon (das nach Abschluss erscheint).', + q37: 'Offline-Speicherlimit?', + a37: 'Einstellungen → Bibliothek → Offline lässt eine maximale Cache-Größe setzen. Wird das Limit erreicht, zeigt die Albumseite einen Warnhinweis. Speicher freigeben durch Entfernen von Alben oder Playlists in der Offline-Bibliothek.', + q38: 'Device Sync — Musik auf USB / SD?', + a38: 'Device Sync (Sidebar) kopiert Alben, Playlists oder ganze Künstler auf ein externes Laufwerk für Offline-Hören auf anderen Geräten. Zielordner wählen, Quellen aus den Browser-Tabs auswählen, „Auf Gerät übertragen" klicken. Psysonic schreibt ein Manifest (psysonic-sync.json), sodass es weiß, welche Dateien bereits dort sind, auch beim Wieder-Öffnen unter einem anderen OS mit anderer Vorlage. Vorlagen unterstützen {artist} / {album} / {title} / {track_number} / {disc_number} / {year}-Tokens mit / als Ordner-Trennzeichen.', + // ── Section 10: Integrationen & Fehlerbehebung ───────────────────────── + s10: 'Integrationen & Fehlerbehebung', + q39: 'Last.fm-Scrobbling?', + a39: 'Einstellungen → Integrationen → Last.fm. Konto einmal verbinden, Psysonic scrobbelt direkt zu Last.fm — keine Navidrome-Konfiguration nötig. Ein Scrobble wird gesendet, wenn 50 % eines Tracks gehört wurden. Now-Playing-Pings gehen zu Beginn raus.', + q40: 'Discord Rich Presence?', + a40: 'Einstellungen → Integrationen → Discord zeigt deinen aktuellen Track auf deinem Discord-Profil. Wahl zwischen App-Icon, Cover-Art deines Servers (über getAlbumInfo2 — benötigt einen öffentlich erreichbaren Server) oder Apple-Music-Covern. Anzeige-Strings (Details, Status, Tooltip) per Token-Templates anpassen.', + q41: 'Bandsintown-Tour-Daten?', + a41: 'Opt-in unter Einstellungen → Integrationen → Now-Playing-Info. Der Now-Playing-Tab auf der Now-Playing-Seite zeigt dann kommende Tour-Daten für den laufenden Künstler über die Bandsintown-Widget-API. Standardmäßig aus — keine Anfragen, bevor aktiviert.', + q42: 'Internet Radio — Live-Streams abspielen?', + a42: 'Internet Radio (Sidebar) spielt jeden auf deinem Navidrome-Server gespeicherten Live-Stream (Sender über die Navidrome-Admin-UI hinzufügen). Wiedergabe läuft über die HTML5-Audio-Engine des Browsers — die meisten EQ- / Replay-Gain- / Loudness-Einstellungen gelten nicht für Radio, aber ICY-Metadaten (aktueller Songname) werden angezeigt. Unterstützt MP3, AAC, OGG Vorbis und die meisten HLS-Streams; Codec-Support hängt von der Plattform ab.', + q43: 'Der Verbindungstest schlägt fehl — was tun?', + a43: 'URL inklusive Port doppelt prüfen (z. B. http://192.168.1.100:4533). Im lokalen Netzwerk klappt http:// oft, wo https:// nicht funktioniert (kein Zertifikat). Sicherstellen, dass keine Firewall den Port blockiert und dass Benutzername und Passwort stimmen. Bei Servern hinter einem Reverse-Proxy zuerst die direkte URL probieren, um die Ursache einzugrenzen.', + q44: 'Cover und Künstlerbilder laden langsam.', + a44: 'Bilder werden beim ersten Aufruf vom Server geholt und dann 30 Tage lokal gecacht. Bei langsamen Server-Festplatten kann der erste Seitenaufruf einen Moment dauern; danach sind sie sofort da. Der Hot Cache hilft auch bei Tracks, der Bild-Cache ist davon unabhängig.', + q45: 'Linux-Probleme — schwarzer Bildschirm oder kein Ton?', + a45: 'Schwarzer Bildschirm ist meist ein GPU- / EGL-Treiberproblem in WebKitGTK — mit GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 starten (die AUR- / .deb- / .rpm-Installer setzen das automatisch). Für Audio sicherstellen, dass PipeWire oder PulseAudio läuft. Tonaussetzer nach Sleep / Wake werden mittlerweile vom Post-Sleep-Recovery-Hook automatisch behandelt.', }, queue: { title: 'Warteschlange', diff --git a/src/locales/en.ts b/src/locales/en.ts index ac40bb0a..703222c0 100644 --- a/src/locales/en.ts +++ b/src/locales/en.ts @@ -1009,128 +1009,118 @@ export const enTranslation = { }, help: { title: 'Help', + searchPlaceholder: 'Search Help…', + noResults: 'No matching topics. Try a different search term.', + // ── Section 1: Getting Started ───────────────────────────────────────── s1: 'Getting Started', q1: 'Which servers are compatible?', - a1: 'Psysonic works with any Subsonic-compatible server: Navidrome, Gonic, Subsonic, Airsonic, and others. Navidrome is the recommended choice.', - q2: 'How do I connect to my server?', - a2: 'Open Settings and click "Add Server". Enter the server URL (e.g. 192.168.1.100:4533), your username, and password. Psysonic tests the connection before saving — nothing is stored if the connection fails.', - q3: 'Can I use multiple servers?', - a3: 'Yes. You can add as many servers as you like in Settings and switch between them at any time. Only one server is active at a time.', - s2: 'Playback', - q4: 'How do I play music?', - a4: 'Double-click any track to play it. On album and artist pages, use "Play All" to start the whole album. You can also drag tracks into the queue panel.', - q5: 'What keyboard shortcuts are available?', - a5: 'Space = Play / Pause · Escape = Close fullscreen player. Media keys (Play/Pause, Next, Previous) work on all platforms. On Linux, use the player bar buttons for media keys. In-app shortcuts and system-wide global shortcuts can be customized in Settings → Keyboard Shortcuts / Global Shortcuts.', - q6: 'What is the queue?', - a6: 'The queue shows all upcoming tracks. Open it with the panel icon in the top-right header (next to the Now Playing indicator). You can reorder tracks by dragging, shuffle with the shuffle button, and save the queue as a playlist.', - q7: 'How do I open the fullscreen player?', - a7: 'Click the album art thumbnail in the player bar at the bottom, or the expand icon next to it. Press Escape to close it again.', - q8: 'How does repeat work?', - a8: 'Click the repeat button in the player bar to cycle through: Off → Repeat All → Repeat One.', - s3: 'Library', - q9: 'How do I download an album?', - a9: 'Open an album\'s detail page and click "Download (ZIP)". The server compresses the album into a ZIP file first — for large albums or lossless files (FLAC / WAV) this can take a moment before the download actually starts. This is normal: the progress bar appears once the server finishes zipping and the transfer begins.', - q10: 'How do I star / favorite tracks and albums?', - a10: 'Click the star icon on any track row or on the album header. Starred items appear in the Favorites section in the sidebar.', - q11: 'What is the hero carousel on the home page?', - a11: 'The banner at the top of the home page randomly picks albums from your library and rotates through them every 10 seconds. Click the dots to jump to a specific one, or click the banner to open the album.', - s4: 'Settings', - q12: 'How do I change the theme?', - a12: 'Settings → Theme. Choose from a large selection of themes across 8 groups: Psysonic Themes, Mediaplayer, Operating Systems, Games, Movies, Series, Social Media, and Open Source Classics (Catppuccin, Nord, Gruvbox, Nightfox).', - q13: 'How do I change the language?', - a13: 'Settings → Language. English, German, Spanish, French, Dutch, Chinese, Norwegian, and Russian are supported.', - q15: 'How do I set a download folder?', - a15: 'Settings → App Behavior → Download Folder. Pick any folder — downloaded albums are saved there as ZIP files. Without a custom folder, your browser\'s default downloads location is used.', - s5: 'Scrobbling', - q16: 'How does scrobbling work?', - a16: 'Psysonic scrobbles directly to Last.fm — no Navidrome configuration needed. Connect your Last.fm account in Settings → Last.fm and enable scrobbling there.', - q17: 'When is a scrobble sent?', - a17: 'A scrobble is submitted after you\'ve listened to 50% of a track.', - q22: 'What is the waveform in the player bar?', - a22: 'The waveform seekbar replaces the classic progress slider. Click anywhere on it to jump to that position, or drag to scrub. The played portion glows with a blue-to-mauve gradient, the buffered range appears slightly brighter, and the unplayed portion is faded.', - q24: 'Can I shuffle the queue?', - a24: 'Yes. Open the queue panel and click the shuffle icon in the queue header. The currently playing track stays at position 1 — all remaining tracks are randomly reordered.', - q25: 'Do Last.fm and Wikipedia links on artist pages open in a browser?', - a25: 'Yes — they open in your default system browser. The button briefly shows a confirmation label when clicked.', - s7: 'Random Mix', - q26: 'What is Random Mix?', - a26: 'Random Mix builds a playlist of random tracks from your entire library. Open it via "Random Mix" in the sidebar and click "New Mix". You can adjust the track count before generating.', - q27: 'What is the Keyword Filter?', - a27: 'The Keyword Filter excludes tracks whose genre, title, or album name contains specific words. Audiobooks are filtered automatically. Add custom keywords in Settings → Random Mix, or click any genre tag in the track list to add it instantly.', - q28: 'What is the Super Genre Mix?', - a28: 'The Super Genre Mix groups your library into broad categories (Rock, Metal, Electronic, Jazz, Classical, etc.) and builds a focused mix from that style. Select a category chip below the track list. Results appear progressively as each sub-genre is fetched.', - s6: 'Troubleshooting', - q18: 'Cover art and artist images load slowly.', - a18: 'Images are fetched from your server\'s disk on first load and then cached locally for 30 days. If your server\'s storage is slow, the first visit to a page may take a moment. Subsequent visits will be instant.', - q19: 'The connection test fails.', - a19: 'Check the URL including the port (e.g. http://192.168.1.100:4533). Make sure no firewall blocks the connection. Try http:// instead of https:// on a local network. Also verify that your username and password are correct.', - q20: 'No audio on Linux.', - a20: 'Psysonic is available as .deb (Ubuntu/Debian), .rpm (Fedora/RHEL), and via AUR on Arch/CachyOS (yay -S psysonic). There is no AppImage. If audio is missing, ensure PipeWire or PulseAudio is running.', - q21: 'The app shows a black screen on Linux.', - a21: 'This is usually a GPU/EGL driver issue in WebKitGTK. Launch with GDK_BACKEND=x11 WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1. The AUR package and official .deb/.rpm installers set these automatically.', - q29: 'What are Crossfade and Gapless Playback?', - a29: 'Both are experimental audio features in Settings → Audio. Gapless pre-buffers the next track to eliminate silence between songs. Crossfade fades out the current track while fading in the next — adjust the duration (1–10 s) to taste.', - q30: 'Does Psysonic show lyrics?', - a30: 'Yes. Click the microphone icon in the player bar to open the Lyrics tab in the queue panel. Psysonic fetches lyrics automatically from LRCLIB. If synced lyrics are available, the active line is highlighted and scrolls in real time as the song plays. If only plain text is available, the full text is shown statically.', - q31: 'Can I customize keyboard shortcuts?', - a31: 'Yes. Settings → Keyboard Shortcuts lets you remap in-app actions (Play/Pause, Next, Previous, Volume Up/Down, Fullscreen, and more) to any key. Settings → Global Shortcuts lets you assign system-wide shortcuts that trigger even when Psysonic is in the background.', - q32: 'Can I change the font?', - a32: 'Yes. Settings → Font lets you choose from 10 fonts including IBM Plex Mono, Fira Code, JetBrains Mono, Courier Prime, and others. The selected font applies to the entire UI.', - s8: 'Offline Mode', - q34: 'What is Offline Mode?', - a34: 'Offline Mode (Beta) lets you cache albums to your device so you can listen without an active server connection. Cached tracks are stored locally and played back directly from disk — no network request is made during playback.', - q35: 'How do I cache an album for offline use?', - a35: 'Open any album and click the download icon in the album header. Psysonic downloads all tracks in the background. Progress is shown on the button. Once cached, the icon turns green. You can view and remove cached albums in the Offline Library page (sidebar).', - q36: 'How much storage can offline caching use?', - a36: 'You can set a maximum cache size in Settings → Library. When the limit is reached, a warning banner appears on the album page. You can delete individual albums from the Offline Library to free up space.', - q37: 'How do I rate songs, albums, and artists?', - a37: 'Psysonic supports 1–5 star ratings via the OpenSubsonic API (requires Navidrome ≥ 0.53). Rate songs in the album or playlist track list using the star column, in the right-click context menu, or directly in the player bar below the artist name. Albums can be rated on their detail page; artists on their artist page. Ratings are saved to the server immediately.', - q38: 'Can I remove or change a rating?', - a38: 'Yes. Click the currently active star to clear the rating entirely — clicking the same star a second time removes it. To change a rating, simply click a different star.', - q39: 'What is Skip-to-1★ and the rating filter?', - a39: 'Skip-to-1★ automatically assigns a 1-star rating to a song after you manually skip it a configurable number of consecutive times. Enable it and set the skip threshold in Settings → Ratings. The same settings panel lets you set a minimum star rating for Random Mix and Random Albums, so only songs, albums, or artists above a certain rating are included in generated mixes.', - q40: 'What is the Folder Browser?', - a40: 'The Folder Browser (sidebar) lets you navigate your server\'s music directory tree using a Miller-column layout. Click a folder to drill into it; click a track or the play icon on a folder to play or enqueue its contents directly.', - q41: 'What is the Theme Scheduler?', - a41: 'Settings → Appearance → Auto-Switch Theme: define a day theme and a night theme with start times. Psysonic switches automatically at the configured hours. When the scheduler is active, a hint in the theme picker explains why manual theme selection has no immediate effect.', - q42: 'Can I resize the interface?', - a42: 'Yes. Settings → Appearance → Interface Scale lets you scale the entire UI between 80 % and 125 % without affecting your system font size.', - q43: 'Can I change the seekbar style?', - a43: 'Yes. Settings → Appearance → Seekbar Style offers 10 styles: Waveform, Line & Dot, Bar, Thick Bar, Segmented, Neon Glow, Pulse Wave, Particle Trail, Liquid Fill, and Retro Tape.', - q44: 'What is AutoEQ?', - a44: 'The 10-band EQ in Settings → Audio includes an AutoEQ lookup. Enter your headphone model and Psysonic fetches a correction profile from the AutoEQ database and applies it automatically to the equalizer bands.', - q45: 'What is Replay Gain?', - a45: 'Replay Gain normalizes track volume so loud and quiet albums play at a consistent level. Enable it in Settings → Audio → Replay Gain and choose Track mode (per-song normalization) or Album mode (preserves relative dynamics within an album).', - q46: 'What is the Hot Cache?', - a46: 'Hot Cache (Alpha, Settings → Library) preloads the next several tracks in your queue to disk so playback starts instantly with no buffering delay — especially useful on slow or remote servers. Psysonic keeps the current track and the next 5 in cache and evicts older entries when the size limit is reached. You can set the maximum cache size and a debounce delay to avoid unnecessary fetches when skipping quickly.', - q47: 'Can I cache a playlist for offline use?', - a47: 'Yes. Open any playlist and click the download icon in the playlist header. All tracks are downloaded in the background — progress is shown in the offline download indicator. Once fully cached, the icon changes to a red trash icon; clicking it removes the playlist from the offline cache.', - q48: 'What is Infinite Queue?', - a48: 'When the queue runs out and Repeat is off, Psysonic silently appends random tracks from your library so playback never stops. Auto-added tracks appear below a "— Added automatically —" divider in the queue. Toggle it with the infinity icon in the queue header. You can also restrict auto-added tracks to a specific genre in Settings → Queue.', - q49: 'Can I control Psysonic from the command line?', - a49: 'Yes — the Psysonic binary doubles as a remote control for the running app. Examples: psysonic --player play / pause / next / prev, --player volume 75, --player seek 15, --player mute, --player shuffle, --player repeat off|all|one, --player star / unstar, --player rating 1-5. You can also switch servers (--player server list / set), change the audio device (--player audio-device list / set), filter the music library (--player library list / set), trigger an Instant Mix (--player mix new / append), and search (--player search track|album|artist ). Run psysonic --player --help for the full list. Shell completions for bash and zsh are available via psysonic completions.', - q50: 'How do I manage playlists?', - a50: 'Open "Playlists" in the sidebar. Click "New Playlist" to create one. On a playlist detail page you can drag tracks to reorder them, remove tracks with the × button, search your library to add songs, and use "Suggestions" to get smart track recommendations based on your playlist content. Right-click any track for more options.', - q51: 'Can I back up and restore my settings?', - a51: 'Yes. Settings → Backup & Restore lets you export all your settings, server profiles, themes, and keybindings to a single JSON file. Import it on another machine or after a reinstall to restore everything at once. Passwords are included in the backup — store the file securely.', - q52: 'How do I change the audio output device?', - a52: 'Settings → Audio → Output Device. Psysonic lists all available audio outputs on your system. Select the one you want — playback switches immediately. Use the refresh button next to the list if a device was connected after the app started. On Linux this uses ALSA device names; generic entries like "default" or "sysdefault" are automatically cleaned up for readability.', - q53: 'What is Device Sync?', - a53: 'Device Sync lets you copy albums, playlists, or entire artists to a USB drive or SD card for listening on other devices. Open it via "Device Sync" in the sidebar. Select a target folder on your drive, choose sources from the browser tabs, and click "Transfer to Device". Psysonic downloads the tracks from your server and writes them in the folder structure defined by the filename template.', - q54: 'What is the filename template in Device Sync?', - a54: 'The filename template controls how tracks are named and organized on the device. Use the preset buttons (Standard, Multi-Disc, Alt. Folder) or build your own using the clickable token chips: {artist}, {album}, {title}, {track_number}, {disc_number}, {year}, and / for folder separators. A live preview shows how an example track would be named.', - q55: 'Does Device Sync work across platforms?', - a55: 'Yes. The sync manifest (psysonic-sync.json) written to the device stores the filename template used during sync. When you open Device Sync on a different OS with a different template, Psysonic uses the stored template to correctly detect which files are already on the device — so albums don\'t show as pending when they are already synced.', - s9: 'Device Sync', - q56: 'What is Internet Radio?', - a56: 'The Internet Radio page (sidebar) lets you play any live stream directly in Psysonic. Stations are fetched from your Navidrome server — add them there via the Navidrome admin panel, or import a .pls / .m3u file. Playback uses the browser\'s built-in HTML5 audio engine rather than the Rust audio engine, so some EQ and Replay Gain settings do not apply to radio.', - q57: 'What stream formats does Internet Radio support?', - a57: 'Psysonic supports any format your system\'s audio stack can decode: MP3, AAC, OGG Vorbis, and most HLS streams. The stream is played via HTML5