Problemlösung — die häufigsten Stolperstellen.

Die Audio-Analyse unterstützt MP3, WAV, FLAC, M4A (AAC) und OGG Vorbis. Andere Formate (WMA, AIFF, Opus in OGG-Containern) werden nicht zuverlässig erkannt.

• Prüfe das Datei-Format. Bei Bedarf mit Audacity oder fre:ac nach MP3/WAV konvertieren.
• Tracks, die in der Bibliothek als „Analyse pending" feststecken: Rechtsklick → „Analyse neu starten".
• Bei sehr kurzen Files (< 30 Sek.) ist das BPM-Ergebnis unzuverlässig — das Model braucht ausreichend Takte, um Pattern zu erkennen.
• Bei Ambient-Tracks ohne klaren Beat kann die BPM-Schätzung frei Hand über den Edit-Dialog (Track-Drawer → Bleistift-Symbol) gesetzt werden.

Aussetzer kommen meist von einer überlasteten CPU, einem zu kleinen Audio-Puffer oder konkurrierenden Audio-Apps.

• Schließe andere Audio-Anwendungen (Spotify, Browser-Videos, DAWs). Sie greifen auf denselben Audio-Stack zu.
• CPU-Auslastung im Task-Manager prüfen (Ctrl+Shift+Esc). Dauerhaft > 80 % → der Rechner ist unter Last.
• In Hypnotika: Einstellungen → Audio → Puffergröße von 256 auf 512 oder 1024 Samples erhöhen. Höherer Puffer = stabiler, minimal mehr Latenz.
• Windows-Energieoption auf „Höchstleistung" stellen — gerade bei Laptops bremst „Ausbalanciert" die CPU unter Last.
• Audio-Treiber aktualisieren (Realtek, Intel SST). Veraltete Treiber sind Klassiker-Ursache.

Das Symptom „Bibliothek leer nach App-Start" deutet auf ein Hydration-Problem der lokalen Datenbank hin.

• Prüfe den Inhalt von %APPDATA%\Hypnotika\library.db. Die Datei sollte mindestens ein paar KB groß sein.
• Falls die Datei fehlt oder 0 Bytes ist: Hypnotika hat keine Schreibrechte im Ordner. Rechtsklick auf den Ordner → Eigenschaften → Sicherheit → „Vollzugriff" für deinen User aktivieren.
• Im Zweifel die App mit Admin-Rechten einmal starten — das erzeugt die DB sauber, danach reicht normaler Start.
• Antivirus-Software kann library.db in Quarantäne stellen. Pfad als Ausnahme hinzufügen.
• Backup: der Ordner %APPDATA%\Hypnotika komplett sichern vor größeren Experimenten.

Wenn die sechs Hotkeys ins Leere laufen, hat meist eine andere Anwendung dieselbe Kombination belegt.

• Prüfe, ob Einstellungen → Stream Deck / Makro-Controller → Globale Hotkeys wirklich aktiv ist.
• Teste die Hotkeys direkt auf der normalen Tastatur (Ctrl+Alt+F1 bis F6). Reagiert die App darauf? Wenn ja, liegt der Fehler in der Stream-Deck-Software-Konfiguration.
• Shortcut-Konflikte: Grafiktreiber (NVIDIA GeForce Experience, Intel Graphics Command Center) belegen oft Ctrl+Alt+F1–F4. Diese Hotkeys im jeweiligen Tool deaktivieren.
• Windows-Berechtigungen: Hypnotika darf keine globalen Hotkeys registrieren, wenn es ohne Admin-Rechten in einem geschützten Kontext läuft. Einmaliger Start als Admin hilft, danach ist die Berechtigung gesetzt.
• Bei USB-Problemen: Stream Deck an anderen USB-Port stecken, Elgato-Software neu starten.

• Windows-Mikrofon-Berechtigung: Windows-Einstellungen → Datenschutz & Sicherheit → Mikrofon. Sicherstellen, dass „Apps Zugriff auf das Mikrofon erlauben" an ist und „Desktop-Apps" ebenfalls.
• Richtiges Gerät gewählt? In Hypnotika Einstellungen → Mikrofon → Mikrofon-Gerät prüfen. Headset-Mikros erscheinen manchmal als zwei Einträge (Bluetooth HFP vs. HSP) — eines der beiden ist das richtige.
• System-weit testen: Windows-Einstellungen → System → Sound → Eingabe. Dort sollte der Eingangs-Pegel beim Reinsprechen anschlagen. Wenn nicht, liegt das Problem auf Windows-Ebene, nicht bei Hypnotika.
• Interface-Nutzer:innen: Phantom-Power (48 V) an, falls Kondensator-Mikro.
• Bei USB-Mikros: anderen Port probieren. Manche USB-Hubs liefern nicht genug Strom.

• Prüfe, ob die Aufnahme in den Einstellungen eingeschaltet ist — sie kann bewusst aus sein, wenn ein externes Tool (z.B. OBS) die Aufnahme übernimmt. Siehe Audio-Einrichtung.
• Aufnahme-Ordner: %USERPROFILE%\Documents\Hypnotika\Sessions oder der in den Einstellungen gesetzte Pfad. Der Explorer kann versteckte Ordner ausblenden — „Ausgeblendete Elemente anzeigen" aktivieren.
• Aufnahmen starten nur, wenn tatsächlich Musik gespielt wurde. Wenn du nur angehört und nicht geplayt hast, gibt es nichts aufzuzeichnen.
• Festplatte voll? Die Aufnahme bricht ohne Fehlermeldung ab, wenn weniger als 500 MB frei sind.

Hypnotika nutzt SoundTouchJS für Pitch-Shift ohne Tempo-Änderung. Das ist eine CPU-freundliche Library, stößt aber bei extremen Verschiebungen an Grenzen.

• Empfohlener Bereich: ±3 Halbtöne. Bis ±5 Halbtöne noch akzeptabel. Über ±7 werden Artefakte deutlich hörbar (Phasing, metallisches Zwitschern).
• Bei stark vokalen Tracks (Chor, Gesang) ist das Pitch-Limit niedriger als bei instrumentaler Musik. Vokale Formanten werden verzogen.
• Alternative: das Original-Audio in einem externen Tool (Audacity, Adobe Audition) pitch-shiften und als neuen Track importieren. Dort stehen bessere Algorithmen zur Verfügung (Élastique Pro, Rubber Band).
• Für präzise Tonart-Anpassung: manuelle Pitch-Werte statt automatische Camelot-Wheel-Korrektur eintragen.

• Windows SmartScreen kann die EXE blockieren. „Weitere Informationen" → „Trotzdem ausführen".
• Antivirus (Windows Defender, Kaspersky, Norton) hält neue, noch wenig verbreitete Apps manchmal für Malware. Ausnahme für Hypnotika TranceDeck hinzufügen.
• Fehlende WebView2-Runtime: das UI-Framework braucht Microsoft Edge WebView2. Wenn nicht installiert, von developer.microsoft.com den „Evergreen Standalone Installer" laden.
• VC++-Redistributable: die Audio-Module brauchen Visual C++ 2019+. Installer: aka.ms/vs/17/release/vc_redist.x64.exe.
• Logdatei prüfen: %APPDATA%\Hypnotika\logs\latest.log. Die letzten Zeilen zeigen oft direkt die Ursache (fehlendes Modul, Pfadfehler).

• Browser-Cache der internen WebView leeren: Hypnotika schließen, Ordner %LOCALAPPDATA%\Hypnotika\EBWebView löschen. Beim nächsten Start wird die Cache neu angelegt.
• Harter Reload im UI: Entwicklermodus aktivieren (Einstellungen → Erweitert → DevTools), dann Ctrl+Shift+R.
• Die Sprache wird pro Session gespeichert. Wenn du beim nächsten Start wieder auf der alten Sprache landest, liegt vermutlich ein Schreibrechte-Problem auf %APPDATA%\Hypnotika\settings.json vor — siehe „Tracks verschwinden".
• Die Website-Sprachumschaltung (DE/EN oben rechts) ist unabhängig von der App-Sprache. Beide werden getrennt gespeichert.