Ausfuehrliches Benutzerhandbuch

1. Wofuer dieses Handbuch gedacht ist

Dieses Handbuch erklaert VoxFrame Subtitle Player vom Start bis zum Ende. Es folgt der aktuellen App-Oberflaeche: Hauptbildschirm, Player-Bedienung, CC/subtitle-Hub, Player-Menue, Smart Subtitle Assistant, OpenSubtitles-first, Uebersetzung, IPTV Live-Captions, LAN Watch/QR Web-Player, Chromecast/Cast, Family Filter, Account/Cloud und Einstellungen.

Die App verwendet in der Oberflaeche oft den englischen Begriff subtitle. Dieses Handbuch nutzt Untertitel fuer normale Dateien und Tracks und Captions fuer Text, der waehrend der Wiedergabe angezeigt wird, besonders bei IPTV-Live-Workflows.

2. Die App starten

Starte VoxFrame Subtitle Player ueber die mitgelieferte Verknuepfung oder den Startbefehl. Nach dem Start siehst du den leeren Player-Bildschirm mit dem Titel VoxFrame Subtitle Player und der Schaltflaeche Open video.

Wenn noch kein Video geladen ist, kannst du auf drei Arten beginnen:

1. Klicke im leeren Bildschirm auf Open video.
2. Klicke im Player-Menue auf Open video.
3. Ziehe eine Videodatei in das Fenster.

Die App akzeptiert derzeit lokale Videodateien mit diesen Erweiterungen: .mp4, .mkv, .avi, .mov, .webm, .m4v und .ts.

Fuer Untertitel akzeptiert die App .srt, .vtt, .webvtt, .ass und .ssa.

3. Der Hauptbildschirm

Der Hauptbildschirm ist videozentriert. Das Video steht im Mittelpunkt; die Bedienung erscheint als Overlay. Beim Anschauen blendet die App die Bedienung nach einigen Sekunden automatisch aus. Bewege die Maus, klicke oder tippe in das Fenster, um sie wieder einzublenden.

Oben steht die Titelleiste mit Videoname oder Streamname. Unten befindet sich die Player-Leiste mit Fortschritt, Zeit, Wiedergabetasten, Untertitelstatus und Menues.

Die wichtigsten unteren Bedienelemente sind:

• Progress slider: auf der Zeitleiste ziehen, um in einem lokalen Video zu suchen.
• Play/Pause: Wiedergabe starten oder pausieren.
• Stop: Wiedergabe stoppen und das aktuelle Video im Player schliessen.
• Back 10 seconds: 10 Sekunden zurueckspringen.
• Forward 10 seconds: 10 Sekunden vorspringen.
• Time: aktuelle Position und Gesamtdauer anzeigen.
• Subtitle status: zeigt den aktiven Untertitel oder No subtitles.
• Stop current task: erscheint bei laufenden AI/STT/Uebersetzungsaufgaben.
• Volume: oeffnet das Lautstaerkemenue.
• CC: oeffnet das Untertitel-Track-Menue.
• Captions toggle: Captions ein- oder ausschalten.
• Speed: oeffnet die Geschwindigkeitsauswahl.
• Player menu: oeffnet die Hauptaktionen.
• Fullscreen: schaltet Vollbild ein oder aus.

4. Tastenkürzel

Die App unterstuetzt diese Tastenkombinationen, wenn ein Video geladen ist:

• Space: Wiedergabe/Pause.
• Media Play/Pause: Wiedergabe/Pause auf Tastaturen mit Medientasten.
• Left: 10 Sekunden zurueck.
• Right: 10 Sekunden vor.
• Up: Lautstaerke um 5 Prozent erhoehen.
• Down: Lautstaerke um 5 Prozent senken.
• F: Vollbild umschalten.
• M: stumm schalten oder Ton wieder einschalten.
• C: Captions ein- oder ausschalten.
• Esc: schliesst zuerst offene Menues oder Einstellungen; im Vollbild geht die App zur normalen Ansicht zurueck.
• Ctrl+O: Video oeffnen.

Wenn noch kein Video geladen ist, funktioniert Ctrl+O trotzdem. Die anderen Wiedergabetasten warten, bis Medien geoeffnet sind.

5. Ein lokales Video öffnen

Verwende Open video, um ein lokales Video auszuwaehlen. Du kannst ein Video auch in das Fenster ziehen. Beim Oeffnen:

1. Die App zeigt kurz einen Ladestatus.
2. Die Video-Engine oeffnet die Datei.
3. Die App prueft, ob Einstellungen fuer dieses Video gespeichert wurden.
4. Wenn kein Video-Gedaechtnis vorhanden ist und die Quelle lokal ist, sucht die App nach einem Sidecar-Untertitel neben der Videodatei.

Sidecar-Untertitel werden automatisch erkannt, wenn:

• der Untertitel denselben Basisnamen wie das Video hat, zum Beispiel Movie.mkv und Movie.srt; oder
• genau eine brauchbare Untertiteldatei im selben Ordner liegt.

Wenn mehrere lose Untertitel vorhanden sind und die App nicht sicher waehlen kann, wird nichts automatisch geladen. Lade dann die richtige Datei mit Open subtitle.

6. Video-Gedächtnis pro Datei

VoxFrame merkt sich mehrere Entscheidungen pro Video. Beim erneuten Oeffnen stellt die App nach Moeglichkeit wieder her:

• geladenen Untertitelpfad;
• Untertitelverzoegerung;
• ob Captions ein oder aus waren;
• gewaehle Untertitelsprache;
• gewaehle Zielsprache fuer Uebersetzung;
• Subtitle style preset;
• Glossary/name-lock Text;
• minimum match Einstellung;
• letzten Uebersetzungskontext, damit Quality Check und bilingual review Quelle und Uebersetzung weiter verbinden koennen.

Live-Transkript-Untertitel werden nicht als normale wiederherstellbare Untertitel gespeichert. Wenn ein Live-Transkriptpfad aus dem temporaeren Live-Ordner stammt, wird er beim erneuten Oeffnen uebersprungen.

7. Untertitel manuell öffnen

Waehle Open subtitle im Player-Menue, um eine Untertiteldatei zu laden. Die App liest die Datei ueber den Subtitle Loader und laedt sie in die Video-Engine.

Nach dem Laden:

• wird der Untertitel sichtbar, wenn Captions eingeschaltet sind;
• versucht die App, die Sprache aus Dateiname oder Trackinformationen zu erkennen;
• wird die Untertitelverzoegerung auf 0 gesetzt;
• wird die Sync-Analyse neu berechnet;
• wird die Auswahl im Video-Gedaechtnis gespeichert.

Wenn die Datei nicht gelesen werden kann, meldet die App, dass der Untertitel nicht geladen wurde.

8. Das CC/subtitle-Menue

Klicke auf CC, um das Untertitelmenue zu oeffnen. In der aktuellen Build ist dieses Menue auch der kompakte Subtitle Assistant Hub. Du siehst hier also Tracks, Status, Quelle, Confidence und schnelle Untertitelaktionen.

Oben zeigt VoxFrame:

• welcher Untertitel oder Track aktiv ist;
• Quellen-/Confidence-Hinweise wie OpenSubtitles match, Hash/Releasename, translated, AI generated, synced oder quality-fixed;
• die Zusage OpenSubtitles first - translate/generate only if needed;
• die gewaehlte Zielsprache ueber den Sprachchip.

Die schnellen Tasten sind:

• Smart Subtitle Assistant: sucht zuerst menschliche Untertitel und uebersetzt oder erzeugt nur bei Bedarf.
• Translate: oeffnet Uebersetzungsaktionen fuer den geladenen Untertitel.
• Sync: startet Fast-STT-Sync, wenn lokales Video und Untertitel vorhanden sind.
• Live: oeffnet Live transcript/translate fuer IPTV/live streams.
• Language: oeffnet die Zielsprache.

Unter dem Hub stehen die verfuegbaren Tracks. Dort kannst du eingebettete oder externe Tracks waehlen, Captions ausschalten, Delay anpassen und die vertikale Position verschieben.

Untertitelverzoegerung

Die Delay-Tasten sind -0.5s und +0.5s. Nutze -0.5s, wenn Text zu spaet kommt, und +0.5s, wenn Text zu frueh kommt. Bei Live-Captions steuern dieselben Tasten den Live-Anzeigeversatz.

Untertitelposition

Die Untertitelposition bewegt normale Untertitel hoeher oder tiefer im Bild. Das hilft, wenn Text Player-Bedienung, TV-Grafiken oder fest eingebrannte Untertitel ueberlappt.

9. Captions ein- und ausschalten

Nutze die Captions-Schaltflaeche oder druecke C. Captions ausschalten laedt den Untertitel nicht aus:

• die Wiedergabe laeuft weiter;
• geladene Untertitel bleiben vorhanden;
• nur die Anzeige wird verborgen;
• die Entscheidung wird pro Video gemerkt.

Beim erneuten Einschalten zeigt die App den zuletzt gewaehlen Untertiteltrack oder geladenen Untertitel.

10. Lautstärke

Klicke auf die Lautstaerketaste, um das Lautstaerkemenue zu oeffnen. Du kannst den Slider ziehen oder Tastenkombinationen nutzen.

M schaltet stumm. Up und Down aendern die Lautstaerke in 5-Prozent-Schritten.

11. Wiedergabegeschwindigkeit

Klicke auf Speed, um die Wiedergabegeschwindigkeit zu waehlen. Aktuelle Auswahl:

• 0.75X
• 1X
• 1.25X
• 1.5X
• 2X

Die App zeigt den aktuellen Wert auf der Speed-Taste. Aenderungen gelten fuer die aktuelle Player-Sitzung.

12. Vollbild

Nutze die Vollbildtaste oder druecke F. Im Vollbild blendet die App die normale Fensteroberflaeche aus und haelt das Video im Mittelpunkt.

Druecke erneut Esc oder F, um zur normalen Ansicht zurueckzukehren.

13. Das Player-Menue

Das Player-Menue ist in klare Modi gegliedert, damit die App einfacher wirkt und du nicht durch viele technische Einzelaktionen suchen musst.

Local Mode

• Open video
• Open IPTV playlist
• Open subtitle
• Export subtitle

Cloud Mode / Review Studio

• Choose language
• OpenSubtitles via VoxFrame Cloud
• Translate via VoxFrame Cloud
• Subtitle quality check

Wenn Cloud aktiv ist und dein Account die Route erlaubt, laufen passende Funktionen ueber VoxFrame Cloud statt ueber eigene Provider-Keys.

Smart Subtitle / Live Mode

• Sync with fast STT
• Smart Subtitle Assistant
• Transcribe via VoxFrame Cloud
• Benchmark fast STT
• Live transcript / translate fuer IPTV/live streams

Cast Mode / Guardian

• LAN Watch / QR web-player
• Chromecast / Cast
• Family filter: off/on
• Settings

LAN Watch und Chromecast verwenden beide lokale HLS-Basis. LAN Watch ist der QR/browser-player; Chromecast sendet Playback direkt an ein Cast-Geraet.

14. Smart Subtitle Assistant

Smart Subtitle Assistant ist die empfohlene Route fuer Filme und Serien. Ein Klick versucht die komplette Untertitelkette in der richtigen Reihenfolge.

Die Reihenfolge ist human-first:

1. VoxFrame prueft eingebettete Tracks und vorhandene lokale SRT/VTT-Dateien.
2. Danach sucht VoxFrame bei OpenSubtitles in der gewaehlten Zielsprache.
3. Wenn kein guter Treffer vorhanden ist, sucht VoxFrame einen englischen menschlichen Untertitel und uebersetzt diesen in die Zielsprache.
4. Erst wenn keine brauchbare menschliche Quelle vorhanden ist, darf VoxFrame einen neuen Untertitel mit STT/AI erzeugen.

Bei Rate-Limits wie HTTP 429, API rate limit exceeded oder VoxFrame Cloud HTTP 502 zeigt VoxFrame den Grund und bietet den sinnvollen Fallback an: Uebersetzung aus Englisch, wenn eine englische Quelle verfuegbar ist.

Waehrend Suche, Download, Uebersetzung oder Generierung laeuft, zeigt die UI Status, ungefaehre Dauer oder Fortschritt.

15. Zielsprache waehlen

Mit Choose language oder dem Sprachchip im CC/subtitle-Hub waehlst du die Zielsprache. Unterstuetzte Ziele sind NL, EN, DE, FR, ES, IT, PT, PL, TR, AR, SV, NO, DA, FI, RO, CS, HU, EL, RU, UK, JA, KO, ZH, HI und ID.

Die Sprache beeinflusst OpenSubtitles-Suche, Uebersetzung, live translate, Batch-Ausgabe und Video-Gedaechtnis.

Aenderst du die Sprache waehrend eines lokalen Films, prueft VoxFrame zuerst, ob ein eingebetteter Track in dieser Sprache vorhanden ist. Danach prueft die App lokale SRT/VTT-Dateien. Gibt es keinen Treffer, fragt VoxFrame, ob gesucht werden soll: OpenSubtitles zuerst, danach bei Bedarf Uebersetzung aus Englisch.

Bei IPTV/live translate wird die neue Sprache an den Live-Uebersetzungsworkflow weitergegeben. Der Stream soll weiterlaufen, waehrend neue Captions in der gewaehlten Sprache erscheinen.

16. OpenSubtitles verwenden

VoxFrame sucht zuerst menschliche Untertitel. OpenSubtitles ist deshalb der erste Online-Schritt fuer lokale Videos, bevor AI-Generierung verwendet wird.

Typischer Ablauf:

1. Die App erstellt nach Moeglichkeit eine Video-Identitaet mit Hash, Dateigroesse, Titel, Jahr und Releasename.
2. Die App sucht bei OpenSubtitles in der gewaehlten Zielsprache.
3. Kandidaten werden nach Hash, Releasename und Match-Qualitaet bewertet.
4. Der beste Treffer wird geladen, wenn die Confidence hoch genug ist.
5. Der Quellenhinweis erscheint im Status, zum Beispiel OpenSubtitles match.

Wenn kein Zielsprache-Treffer gut genug ist, sucht VoxFrame zuerst nach einem englischen menschlichen Untertitel als Quelltext. Wird er gefunden, kann VoxFrame diese Quelle uebersetzen. AI-Generierung ist der letzte Schritt, nicht der Standard. Bei HTTP 429 oder API rate limit exceeded ist das OpenSubtitles- Limit erreicht.

17. AI subtitles generieren

Generate AI subtitles ist der Fallback, wenn ein lokales Video keinen brauchbaren menschlichen Untertitel hat. Im Smart Subtitle Assistant wird diese Route erst genutzt, nachdem eingebettete Tracks, lokale Dateien, OpenSubtitles in der Zielsprache und eine englische menschliche Quelle versucht wurden.

Die App kann schnelle lokale STT ueber Purfview Faster-Whisper, Whisper.cpp als Fallback oder Cloud-Transkription nutzen. Wenn bereits ein englischer menschlicher Untertitel vorhanden ist, sollte VoxFrame nicht transkribieren, sondern diesen Untertitel uebersetzen.

18. Untertitel uebersetzen

Translate uebersetzt den geladenen Untertitel oder den besten gefundenen Quelltext in die gewaehlte Zielsprache. Fuer lokale Filme ist ein englischer menschlicher Untertitel die bevorzugte Quelle, wenn kein Treffer in der Zielsprache vorhanden ist.

Uebersetzbare Quellen sind externe SRT/VTT-Dateien, exportierbare eingebettete Tracks, englische OpenSubtitles-Treffer und Live-Transkript im Live-Kontext. Wenn Quelle und Ziel dieselbe Sprache sind, ueberspringt VoxFrame die Uebersetzung.

Die Ausgabe bekommt den Sprachcode im Dateinamen, zum Beispiel .ro.srt, damit du die Version spaeter erkennst. Fertige SRT-Dateien bekommen die Credit-Zeile Subs by VoxFramePlayer. fuer Vor- und Abspann.

Batch translate all bleibt bewusst begrenzt auf NL, EN, DE, FR, ES und IT. Einzelne normale Uebersetzungen koennen mehr Zielsprachen verwenden.

19. Subtitle quality check und repair

Subtitle quality check prueft den geladenen Untertitel auf typische Probleme. Das genaue Verhalten haengt von Settings > Subtitle Tools ab.

Typischer Ablauf:

1. Die App prueft, ob ein Untertitel geladen ist.
2. Je nach Einstellung erstellt sie eine lokale STT-Referenz.
3. Der Repair-Service analysiert Fehler, Warnungen und reparierbare Punkte.
4. Die App schreibt immer einen Report.
5. Wenn ein reparierter Untertitel geschrieben wird, heisst er .quality-fixed.srt.
6. Die Preview zeigt Zusammenfassung und Beispiele, bevor du waehlst, was passieren soll.

Die Preview kann zeigen:

• Fehler/Warnungen vor der Reparatur;
• Fehler/Warnungen nach der Reparatur;
• Anzahl Aenderungen, etwa Textfixes, Timingfixes, entfernte Cues und eingefuegte fehlende Sprache;
• Ausgabedatei;
• kompakte Vorher/Nachher-Beispiele.

Preview-Aktionen:

• Open report: oeffnet die Report-Datei.
• Only save: speichert den reparierten Untertitel, ohne ihn zu laden.
• Load repaired subtitle: laedt den reparierten Untertitel in den Player, wenn verfuegbar.
• Close: schliesst die Preview.

20. Sync with fast STT

Sync with fast STT versucht, den geladenen Untertitel mit einer schnellen lokalen STT-Referenz auszurichten.

Voraussetzungen:

• ein lokales Video ist geladen;
• ein Untertitel ist geladen;
• schnelle lokale STT-Engine und gewaehles Modell sind verfuegbar.

Diese Aktion ist keine Uebersetzung. Sie analysiert Speech-Timing und schreibt einen synchronisierten Untertitel, wenn der Match verlaesslich genug ist.

21. Benchmark fast STT

Benchmark fast STT testet die Geschwindigkeit der schnellen lokalen STT-Route auf einem kurzen Audiofragment des aktuellen Videos. Die App nutzt ffmpeg, um ein Benchmark-Fragment zu erstellen, und fuehrt die gewaehlten Purfview/Faster-Whisper-Einstellungen aus.

Das Ergebnis wird als letzter Fast-STT-Status gespeichert und ist in Settings > Speech to Text sichtbar.

22. Untertitel exportieren

Export subtitle speichert den aktuell geladenen Untertitel in eine Datei, die du waehlst. Bei einem normalen externen Untertitel kopiert die App die bestehende Untertiteldatei.

Bei einer MKV oder einem anderen lokalen Video mit eingebetteten Untertiteltracks kannst du einen Track als SRT exportieren:

1. Oeffne das Video.
2. Oeffne das CC Menue.
3. Waehle den eingebetteten Untertiteltrack, den du behalten moechtest, zum Beispiel Dutch (subrip) (embedded).
4. Oeffne das Player-Menue.
5. Waehle Export subtitle.
6. Waehle den Speicherort. Die App exportiert den gewaehlten eingebetteten Track als .srt.

Die App nutzt die Erweiterung der Quelle als vorgeschlagene Erweiterung. Wenn kein normaler geladener Untertitel oder gewaehlter eingebetteter Track vorhanden ist, oder wenn die Quelldatei nicht mehr existiert, zeigt die App eine Meldung.

Live-Captions aus IPTV/live transcript werden nicht ueber diese normale Exporttaste gespeichert.

23. IPTV-Playlist öffnen

Waehle Open IPTV playlist im Player-Menue.

Die App oeffnet das Fenster Open IPTV playlist. Dort kannst du:

• eine M3U/M3U8 URL einfuegen und Load URL waehlen;
• eine lokale .m3u oder .m3u8 Datei mit Open file waehlen;
• mit Cancel abbrechen.

Nach dem Laden oeffnet die App den Channel Picker.

24. IPTV-Sender wählen

Der Channel Picker zeigt zuerst Gruppen, wenn Gruppen vorhanden sind. Du kannst:

• nach Gruppe suchen;
• eine Gruppe mit Open group oeffnen;
• doppelklicken oder Enter verwenden;
• Other playlist waehlen, um eine andere Playlist zu laden;
• Cancel waehlen, um zurueckzugehen.

Innerhalb einer Gruppe oder ohne Gruppen zeigt die App Sender. Du kannst:

• nach Sendername, Gruppe, tvg-id oder URL suchen;
• mit Back to groups zur Gruppenuebersicht zurueck;
• den gewaehlten Stream mit Open stream oeffnen;
• doppelklicken oder Enter verwenden.

25. IPTV live transcript / translate

Live transcript / translate ist fuer IPTV oder andere Live-Streams gedacht. Die App liest laufend Audio aus dem Live-Stream, erstellt Textsegmente und zeigt sie als Captions. Wenn Live-Translate aktiv ist, wird der Text in die gewaehlte Zielsprache uebersetzt.

Das Live-Fenster enthaelt unter anderem:

• Translate live captions: schaltet die Live-Uebersetzung ein;
• Untertitel-Setup: waehlt das Transkriptionsprofil;
• Gesprochene Sprache: waehlt die gesprochene Quellsprache oder Automatisch erkennen, wenn sie unbekannt ist;
• Buffer mode: zeigt den synchronisierten Live-Modus fuer einen entfernten Stream;
• Live subtitle delay: fuegt eine zusaetzliche Anzeigeverzoegerung hinzu;
• Target language: waehlt bei aktiver Uebersetzung die Zielsprache.

Aktuell sind diese Profile sichtbar:

• LocalBest: empfohlene lokale Qualitaet. Audio bleibt auf diesem PC und das Profil nutzt die beste bisher getestete lokale Live-Konfiguration;
• LocalLight: leichtere lokale Konfiguration fuer einen schwaecheren PC/GPU. Sie nutzt die aktuellen lokalen Spracheinstellungen; waehle bei Bedarf unter Settings > Speech to Text ein kleineres Modell;
• DirectOpenAi: nutzt deinen eigenen gespeicherten OpenAI API-Key fuer direkte Live-Transkription mit Wortzeitstempeln. OpenAI rechnet diese Nutzung mit dir ab; VoxFrame Cloud-Guthaben wird nicht verwendet;
• CloudStable: empfohlene Cloud-Qualitaet mit 10-Sekunden-Audiobloecken ueber den VoxFrame-Cloud-Proxy;
• CloudFilmSpeakers: 12-Sekunden-Bloecke fuer mehr Dialogkontext. Trotz des Profilnamens werden Sprecher **nicht erkannt, benannt oder markiert**.

DirectOpenAi erscheint nur, wenn VoxFrame Cloud ausgeschaltet und ein eigener OpenAI API-Key gespeichert ist. Cloud-Profile sind nur sichtbar, wenn der Account VoxFrame Cloud verwenden darf. Jeder Audioblock wird dann per HTTPS an VoxFrame gesendet und hinter dem VoxFrame-Proxy von OpenAI verarbeitet. Dieser Workflow gibt der App keinen Provider-Zugang; die Verarbeitung bleibt hinter dem VoxFrame-Proxy. Audioverbrauch wird erst nach erfolgreicher Transkription gebucht; Live-Uebersetzung wird separat berechnet.

Bei einem entfernten Live-Stream liegt die synchronisierte Wiedergabe mit einem lokalen oder DirectOpenAi-Profil normalerweise ungefaehr 30 Sekunden hinter Live, mit einem Cloud-Profil mindestens 60 Sekunden, jeweils plus Transkriptions- und eventueller Uebersetzungszeit. Das sind qualitaetsorientierte Pufferprofile, keine verzoegerungsfreien Captions.

Waehle die gesprochene Quellsprache ausdruecklich, wenn du sie kennst; dadurch wird die Erkennung meist vorhersehbarer. Automatisch erkennen bleibt fuer eine unbekannte Quellsprache verfuegbar. Gesprochene Sprache und Uebersetzungsziel sind zwei getrennte Einstellungen.

Der lokale Hauptplayer bleibt live. Beim normalen IPTV-Schauen soll er nicht wie ein 10-Minuten-DVR zurueckspulbar sein. LAN Watch bekommt eine eigene HLS-Pufferung, aber der lokale Player selbst bleibt auf Live-Verhalten.

Wenn IPTV kurz hakt, Audio fehlt oder der Sender keine verwertbare Sprache liefert, wartet und puffert die Live-Kette weiter. Das Aufholen ist begrenzt: Wenn die Verarbeitung zu weit hinter das Wiedergabefenster faellt, kann VoxFrame einen bereits zu spaeten Audioblock kontrolliert ueberspringen, statt Verzoegerung und Speicherverbrauch unbegrenzt wachsen zu lassen. Auf einem ueberlasteten PC oder bei instabiler Verbindung kann dadurch eine kurze Caption-Luecke entstehen.

Der Status zeigt den Zustand des Workflows:

• Listening: Die Sitzung laeuft und wartet auf verwertbare Sprache;
• No speech yet: Bloecke wurden geprueft, aber noch keine klare Sprache gefunden; das ist nicht automatisch ein Fehler;
• Degraded: Ein Teil des Workflows ist voruebergehend eingeschraenkt; Quell-Captions bleiben aktiv, wenn die Uebersetzung nicht mithalten kann;
• Reconnecting: VoxFrame fuehrt einen begrenzten Neuverbindungsversuch aus;
• Failed: Der Live-Workflow wurde wegen eines technischen Problems beendet.

Aenderst du die Zielsprache, gilt sie fuer neue Bloecke, ohne den Stream neu zu starten. Bereits angezeigte Captions bleiben unveraendert.

26. LAN Watch / QR web-player

LAN Watch / QR web-player erstellt einen lokalen Browser-Player fuer Telefon, Tablet, Laptop, Smart-TV-Browser oder ein anderes Geraet im gleichen Wi-Fi/LAN. VoxFrame zeigt einen QR-Code und darunter einen kleinen anklickbaren Link. Die URL wird auch in die Zwischenablage kopiert.

Bei lokalen Filmen startet LAN Watch an der aktuellen Position. Normale externe SRT/VTT-Untertitel koennen als WebVTT mitgegeben werden. Eingebettete MKV-Untertitel werden nicht automatisch mitgestreamt; exportiere sie zuerst als SRT und lade diese Datei.

Bei IPTV/live stream erstellt LAN Watch eine eigene Live-HLS-Pufferung mit ungefaehr 15 Sekunden Verzoegerung und Segmenten von ungefaehr 5 Sekunden. Pause im Web-Player stoppt den Server-Puffer nicht; er fuellt weiter. Innerhalb der verfuegbaren LAN-Pufferzeit kannst du zurueckspringen und von dort weitersehen.

Die LAN-Watch-Cachegrenze ist 10 GB. Stopst du LAN Watch oder schliesst du den Player, loescht VoxFrame den temporaeren LAN-Watch-Puffer direkt.

Live-Captions koennen nach LAN Watch mitlaufen, wenn sie im lokalen Player aktiv sind, bevor LAN Watch startet.

27. Chromecast / Cast

Chromecast / Cast oeffnet das Cast-Menue. VoxFrame sucht im gleichen Netzwerk nach Chromecast, Google TV und DLNA-Renderern. PC und Cast-Geraet muessen im gleichen Netzwerk sichtbar sein; VPN, Firewall oder Router koennen mDNS/SSDP blockieren.

Wenn du Chromecast oder Google TV waehlst, startet VoxFrame einen lokalen HLS-Stream und sendet danach einen LOAD-Befehl an den Chromecast Default Media Receiver. WebVTT-Untertitel koennen mitgegeben werden, wenn ein externer Untertitel oder ein exportierbarer Track als Datei verfuegbar ist.

Chromecast ist nicht LAN Watch: LAN Watch ist QR/browser, Chromecast ist direkte Cast-Wiedergabe. Eingebettete MKV-Untertitel zuerst exportieren oder als SRT laden, wenn du sie sicher casten willst.

28. Family filter

Family filter: off/on ist ein leichter Familienfilter. Wenn er aktiv ist, versucht VoxFrame grobe Sprache in Live-Captions und AI/uebersetzten Untertiteln abzuschwaechen oder zu maskieren.

Der Filter ist optional und keine harte Kindersicherung. Er arbeitet auf Subtitle-/Caption-Text und kann eingebrannte Sprache im Video oder Audio nicht entfernen.

29. AI/STT/live-Aufgaben stoppen

Wenn AI, STT, Uebersetzung oder Live-Transkript laufen, zeigt der Player Stop current task. Klicke darauf, um die laufende Aufgabe abzubrechen.

Wenn ein Live-Caption-Overlay aktiv ist, leert Stop das Overlay und beendet den Live-Sitzungsstatus.

30. Settings öffnen und schließen

Oeffne Settings aus dem Player-Menue.

Das Einstellungsfenster ist ein Overlay in der App. Schliesse es mit der Schliesstaste oder Esc.

Einstellungen werden unterschiedlich gespeichert:

• Checkboxen direkt nach Aenderung;
• Auswahllisten direkt nach Aenderung;
• Textfelder, wenn das Feld den Fokus verliert;
• lokale STT-Modellwahl direkt nach Aenderung.

Links stehen diese Bereiche:

• Account
• Player
• Subtitle Tools
• Speech to Text
• About

31. Settings > Account

Dieser Tab verwaltet Lizenzaktivierung, Accountstatus, Kaeufe, Downloads und Premium Cloud Nutzung.

License

Felder und Tasten:

• Status: zeigt Demo, Trial, Licensed, Expired oder Pending.
• Activation key: Eingabefeld fuer einen VoxFrame-Aktivierungsschluessel.
• Account e-mail: optionales Account-Mailadresse.
• Server: zeigt die API-Basis, die die App nutzt.
• Device: zeigt Geraetestatus.
• Activate: aktiviert den eingegebenen Key auf diesem Geraet.
• Refresh license: aktualisiert den Lizenzstatus online.
• Log out: loescht lokale Accountdaten und versucht, das Geraet serverseitig zu deaktivieren.

Die App speichert den Lizenz-Token lokal im Credential Store. Teile keine Logs oder Screenshots, die Aktivierungsschluessel enthalten.

Purchase

Der Kaufbereich zeigt Stripe-Status und verfuegbare Plaene.

Premium options

Plan-Karten:

• Player License
• Cloud Plus
• Cloud Pro

Bei Player License oeffnet Player kaufen Stripe checkout direkt, wenn die App entweder einen Lizenz-Token oder eine Account-Mailadresse hat. Wenn beides fehlt, fordert die App zuerst die Account-Mailadresse an.

Die Player License kostet einmalig EUR 24,95. Nach bestaetigter Zahlung wird dieselbe installierte Demo automatisch zu Player Pro. Es wird kein separater Pro-Player installiert. Die Lizenzdaten werden auch fuer Wiederherstellung oder Neuinstallation an die Account-Mailadresse gesendet.

Bei Cloud-Plaenen fragt die App zuerst nach der Zahlungsform:

• Monthly
• One-time
• Yearly

Fuer Cloud Plus/Pro oeffnet Stripe erst nach Auswahl der Zahlungsform. Ein direkter qualifizierender Cloud-Kauf schaltet Player Pro ebenfalls automatisch frei; ein vorheriger separater Player-Kauf ist nicht noetig. Das Cloud-Recht bleibt vom permanenten Player-Pro-Recht getrennt. One-time ist ein 30-Tage-Cloud-Pass. Yearly one-time gilt 365 Tage mit monatlicher begrenzter Erneuerung.

Kauf abrufen

Retrieve purchase prueft, ob eine abgeschlossene Stripe-Zahlung bereit ist, mit der App verknuepft zu werden.

Nutze dies nach der Rueckkehr von der Stripe-Erfolgsseite oder wenn der Browser dich zur App zurueckgeleitet hat.

Downloads

Tasten:

• Check release: fragt den Server, ob fuer diesen Account ein Release verfuegbar ist.
• Download release: laedt ein berechtigtes Release, wenn vorhanden, und prueft wenn moeglich die Checksumme.

Diese Tasten haengen vom Lizenzstatus ab und funktionieren nur, wenn der Server ein Release fuer diesen Account anbietet.

Premium Cloud

Optionen und Felder:

• Use VoxFrame Cloud for premium API usage: aktiviert Cloud-Routen, wenn die Berechtigung es erlaubt.
• Plan: zeigt den aktuellen Plan.
• Credits/minutes: zeigt lokale Saldo-Informationen.
• Usage: zeigt Nutzungszusammenfassung.
• Refresh usage: laedt aktuelle Nutzung.
• Manage account: versucht, das Stripe Billing Portal zu oeffnen, wenn es fuer diese Lizenz verfuegbar ist. Wenn der Server kein Stripe-Portal erstellen kann, oeffnet die App als Fallback die VoxFrame-Accountseite und zeigt unter der Taste eine Statusmeldung.

Wenn Cloud eingeschaltet ist, nutzt die App fuer unterstuetzte Funktionen die VoxFrame-Cloudroute statt eigener Provider-Keys, solange Lizenz und Cloud-Token gueltig sind.

32. Settings > Player

Der Player-Tab enthaelt Verhalten, bevorzugte Sprachen, Untertitelstil, Glossary, Match-Schwelle, Provider-Keys und Cache.

Player behavior

Einstellungen:

• App language: Oberflaechensprache. Auswahl: English, Nederlands, Deutsch, Francais.
• Automatically search: Untertitel automatisch suchen, wenn moeglich.
• Auto-pick best subtitle: den besten passenden Untertitel automatisch laden.
• Create SRT when no match exists: Untertitel erzeugen, wenn kein guter Treffer existiert.
• Auto-translate: automatisch uebersetzen, wenn der Workflow es unterstuetzt.
• Preferred languages: kommagetrennte Sprachcodes fuer Untertitelsuche, zum Beispiel nl,en.
• Subtitle style: Style-Preset fuer Untertitelformatierung.
• Glossary / name lock: Woerter oder Uebersetzungen, die stabil bleiben muessen.
• Min. match: Mindest-Confidence fuer automatische Untertitelauswahl.

Subtitle style

Stilauswahl:

• Balanced
• Compact
• Reading
• Large

Glossary / name lock

Nutze eine Regel pro Zeile:

• einen Namen, der erhalten bleiben soll, zum Beispiel VoxFrame
• oder eine feste Uebersetzung, zum Beispiel The Order = De Orde

Das Glossary kann bei Uebersetzung und Qualitaetspruefung verwendet werden.

33. Settings > Player > Providers

Der Provider-Bereich enthaelt API-Keys und Provider-Login-Daten.

Felder:

• OpenAI API key: dein eigener OpenAI-Key. Leer lassen, um einen gespeicherten Key zu behalten.
• OpenAI text model: Modell fuer Textuebersetzung/Auswahl.
• Load models: aktualisiert Modellauswahl.
• OpenAI transcription: Transkriptionsmodell.
• OpenSubtitles key: API-Key fuer OpenSubtitles.
• OpenSubtitles login: Benutzername.
• Password: OpenSubtitles-Passwort. Leer lassen, um das gespeicherte Passwort zu behalten.

Tasten:

• Save keys: speichert eingegebene Provider-Einstellungen.
• Clear keys: entfernt gespeicherte Provider-Keys.
• Test OpenSubtitles: prueft OpenSubtitles-Zugangsdaten und API-Key.

Wenn Use VoxFrame Cloud aktiv ist und dein Account die Cloud-Route erlaubt, nutzt die App VoxFrame Cloud fuer unterstuetzte Aktionen. Provider-Keys bleiben fuer eigene Key-/lokale Routen nuetzlich.

34. Settings > Player > Cache

Der Cache-Bereich zeigt den Untertitel-Cacheordner. Clear cache loescht den Cacheordner und erstellt ihn neu.

Nutze dies, wenn:

• du alte Downloads oder generierte Untertitel aufraeumen willst;
• du testen willst, ob ein Workflow wirklich neu herunterlaedt/generiert;
• der Cache moeglicherweise defekte oder veraltete Dateien enthaelt.

35. Settings > Subtitle Tools

Dieser Tab steuert Repair, Translation Review, Live-Translate-Qualitaet und Batch-Verhalten.

Repair mode

Auswahl:

• Safe: minimale Reparatur. Keine ASR-Referenz, kein Einfuegen fehlender Sprache und keine automatische Ladeauswahl.
• Standard: Standardverhalten von VoxFrame. Repariert Text/Timing, nutzt ASR wenn verfuegbar, schreibt .quality-fixed.srt und fragt vor dem Laden.
• Aggressive: strenger. Nutzt schaerfere Schwellen, teilt frueher und nutzt ASR-Hilfe, wenn verfuegbar. Auto-load bleibt aus, damit du zuerst den Report pruefen kannst.

Repair-Checkboxes

• Use local STT reference: erstellt wenn moeglich eine lokale STT-Referenz.
• Insert missing speech: darf fehlende ASR-Cues einfuegen, wenn Repair das unterstuetzt.
• Report only: erstellt nur einen Report und schreibt keinen reparierten Untertitel.
• Ask before loading repaired subtitle: fragt, bevor der reparierte Untertitel geladen wird.
• Never overwrite original: der originale Untertitel wird nie ueberschrieben.
• Always save report: ein Report wird immer gespeichert.

Die letzten beiden Sicherheitseinstellungen erzwingt die App.

Translation review

Einstellungen:

• Live quality: Qualitaet/Latenz fuer Live-Translate.
• Use glossary / name lock: nutzt das Glossary bei Uebersetzung.
• Use scene context: nutzt Umgebungskontext bei normaler Untertiteluebersetzung.
• Suggest glossary candidates: laesst Quality Reports Glossary-Kandidaten vorschlagen.
• Quality report after translation: erstellt automatisch nach Uebersetzung einen Quality Report.
• Review suspicious cues: markiert verdaechtige Cues fuer Review.
• Auto-load preferred batch result: laedt nach Batch-Uebersetzung automatisch die Ausgabe der gewaehlten Zielsprache.
• Fast fallback model for live translate: nutzt ein schnelleres Fallbackmodell, wenn Live-Translate zurueckzufallen droht.

Live translate quality

Auswahl:

• Fast: schnellstes Live-Modell zuerst. Gut, wenn Captions vor allem weiterlaufen muessen.
• Balanced: Standard. Nutzt zuerst gpt-5.4-mini und gpt-5.4-nano als schnellen Fallback, wenn Live-Translate zurueckzufallen droht.
• Better: bleibt beim besseren Live-Modell und deaktiviert schnellen Fallback. Nutze dies, wenn Qualitaet wichtiger als Latenz ist.

Reset subtitle tools

Reset subtitle tools setzt diesen Tab auf Standardwerte:

• repair mode Standard;
• STT-Referenz an;
• fehlende Sprache einfuegen an;
• report-only aus;
• ask before loading an;
• glossary/name lock an;
• scene context an;
• glossary suggestions an;
• automatischer quality report aus;
• suspicious cue review aus;
• batch preferred output auto-load an;
• live quality Balanced;
• fast fallback fuer live translate an.

36. Settings > Speech to Text

Dieser Tab verwaltet lokale STT-Engines und Modelle.

Fast local engine

Die schnelle lokale Engine ist Purfview Faster-Whisper.

Felder und Tasten:

• Engine: zeigt Engine und Verfuegbarkeit.
• Install fast engine: laedt und installiert die Engine.
• Fast model: waehlt das Modell.
• Install selected fast model: laedt das gewaehlte Modell.
• Source language: waehlt Sprache oder Auto-Erkennung.
• Device: waehlt Auto / CUDA if possible, CUDA oder CPU.
• Compute: waehlt Auto, float16, int8_float16, int8 oder float32.
• Purfview args: Zusatzargumente fuer fortgeschrittene Nutzung.

Fast-model-Auswahl:

• large-v3-turbo - 1.6 GB
• small - 472 MB
• medium - 1.5 GB
• large-v2 - 2.9 GB
• large-v3 - 3.1 GB
• base - 142 MB
• distil-large-v3 - 1.5 GB English

Standardmaessig versucht die App large-v3-turbo zu waehlen, wenn verfuegbar.

Source-language-Auswahl:

• Auto detect
• English
• Dutch
• German
• French
• Spanish
• Italian

Die Hardware-advice-Zeile prueft, ob CUDA verfuegbar ist. Wenn Device und Compute auf Auto stehen, kann die App den Rat automatisch anwenden.

Fallback engine

Die Fallback-Engine ist Whisper.cpp.

Felder und Tasten:

• Engine: zeigt Whisper.cpp und Verfuegbarkeit.
• Install fallback engine: laedt die Fallback-Engine.
• .bin model: waehlt das Fallbackmodell.
• Install selected .bin: laedt das gewaehlte .bin Modell.

Fallback-model-Auswahl:

• large-v3-turbo-q5_0 - 547 MB
• small-q5_1 - 190 MB
• base - 141 MB
• small - 465 MB
• large-v3-turbo - 1.5 GB

Standardmaessig versucht die App large-v3-turbo-q5_0 zu waehlen, wenn verfuegbar.

Status und Fortschritt

Unten im Settings-Overlay zeigt die App Status und Downloadfortschritt. Waehrend Downloads sind Tasten temporaer deaktiviert. Danach werden Modellauswahl und Verfuegbarkeitslabels neu geladen.

37. Settings > About

Der About-Tab enthaelt Version, Maker, Updates, Hilfe und Diagnose.

Elemente:

• Version: zeigt die App-Version.
• Maker: zeigt William Baars / VoxFrame.
• Updates: Status der Updatepruefung.
• Check for updates: prueft ueber Account/Lizenz, ob ein Release verfuegbar ist.
• Account: oeffnet die Online-Accountseite.
• Website: oeffnet die Website.
• Help: oeffnet Online-Hilfe.
• Credits: zeigt verwendete Technologien.
• Open logs: oeffnet den Logordner fuer Support/Diagnose.
• Export safe support log: erstellt in Downloads eine nochmals bereinigte Supportkopie.
• Delete logs: entfernt aktuelle und rotierte Diagnoselogs.

Die Hilfetaste oeffnet Online-Hilfe, damit Anleitungen ohne neuen App-Build aktualisiert werden koennen.

38. Logs und Diagnose

Nutze Settings > About > Open logs, um den Logordner selbst anzusehen. Wenn du Diagnosedaten an den Support senden musst, nutze vorzugsweise Export safe support log; dadurch entsteht eine separate, bereinigte Textdatei in Downloads. Delete logs entfernt das aktuelle Log und die rotierten Logs.

Logs sind fuer Fehlersuche wichtig. Die App schreibt Statusmeldungen fuer Video oeffnen, Untertitel laden, OpenSubtitles-Suche, Hash, Releasename, Confidence, Rate-Limits, Uebersetzung, lokale STT, quality check, live transcript, LAN Watch, lokale HLS-Pufferung, Chromecast/Google TV/DLNA Discovery, Account, Lizenz und Cloud-Routen.

Normales Logging enthaelt keinen Caption-Text, keine vollstaendigen entfernten URLs, keine absoluten lokalen Pfade, Provider-Keys, Lizenz-/Access-Tokens oder Zahlungsdaten. Entfernte Adressen werden auf sichere Diagnoseinformationen reduziert; der Supportexport bereinigt alle gesammelten Dateien einschliesslich aelterer Logzeilen erneut.

Die Loggroesse ist begrenzt. runtime.log rotiert bei ungefaehr 2 MB, behaelt hoechstens drei aeltere rotierte Dateien und entfernt die aelteste automatisch.

Wenn etwas nicht funktioniert, notiere Video oder IPTV-Sender, gesprochene Quellsprache, Zielsprache, lokal/IPTV/LAN Watch/Chromecast, aktiven Untertitel, genaue Fehlermeldung, Cloud oder eigene Provider-Keys und welche Aktion du geklickt hast.

39. Haeufige Workflows

Lokalen Film mit bestem Untertitel ansehen

1. Oeffne den Film mit Open video.
2. Waehle die Zielsprache im CC/subtitle-Hub.
3. Waehle Smart Subtitle Assistant.
4. VoxFrame prueft eingebettet/lokal, sucht OpenSubtitles, uebersetzt bei Bedarf aus Englisch und generiert erst als letzten Schritt.
5. Pruefe den Quellen-/Confidence-Hinweis.

Sprache waehrend eines Films wechseln

1. Waehle die neue Zielsprache.
2. VoxFrame prueft eingebettete Tracks und lokale SRT/VTT-Dateien.
3. Wenn nichts passt, bestaetige die Suche.
4. VoxFrame sucht OpenSubtitles und uebersetzt bei Bedarf aus Englisch.

IPTV ueber LAN Watch ansehen

1. Starte IPTV und pruefe, ob der Sender laeuft.
2. Starte Live-Captions, wenn du Untertitel im LAN-Web-Player willst.
3. Waehle LAN Watch / QR web-player.
4. Scanne den QR-Code oder klicke den Link darunter.
5. Rechne mit ungefaehr 15 Sekunden Live-Verzoegerung.
6. Stoppe LAN Watch, wenn du zum lokalen Player zurueck willst.

Chromecast verwenden

1. Stelle sicher, dass Chromecast, Google TV oder DLNA-TV im selben Netzwerk ist.
2. Oeffne Video oder IPTV.
3. Lade einen externen Untertitel, wenn du Untertitel casten willst.
4. Oeffne Chromecast / Cast und waehle das Zielgeraet.

40. Problemloesung

OpenSubtitles findet nichts

Pruefe Titel, Jahr, Releasename und Zielsprache. Wenn kein Zieltreffer gut genug ist, suche oder erlaube eine englische Quelle und uebersetze diese.

OpenSubtitles zeigt HTTP 429 oder API rate limit exceeded

Das OpenSubtitles-Limit ist erreicht. Warte, versuche es spaeter erneut oder uebersetze aus einem verfuegbaren englischen Untertitel.

Uebersetzung ist Englisch geblieben

Pruefe den Sprachchip und den CC/subtitle-Hub. Wenn Quelle und Ziel gleich erkannt wurden, ueberspringt VoxFrame die Uebersetzung. Lade sonst die englische Quelle und starte Translate in die gewaehlte Zielsprache.

Keine Untertitel in LAN Watch

LAN Watch kann normale externe SRT/VTT-Untertitel mitgeben. Eingebettete MKV- Untertitel zuerst exportieren und laden. Fuer IPTV muessen Live-Captions aktiv sein, bevor LAN Watch startet.

Chromecast erscheint nicht oder startet nicht

Pruefe, ob Chromecast/Google TV aktiv ist, im gleichen Netzwerk sitzt und mDNS/SSDP nicht blockiert wird. Teste LAN Watch / QR web-player als Fallback.

41. Glossar

• Smart Subtitle Assistant: Flow, der zuerst vorhandene/menschliche Untertitel sucht und erst danach uebersetzt oder generiert.
• OpenSubtitles-first: zuerst menschliche Untertitel suchen; AI nur bei Bedarf.
• LAN Watch: lokaler QR/browser-player ueber HLS im selben Wi-Fi/LAN-Netzwerk.
• HLS: Streamingformat mit kleinen Segmenten und Playlist.
• Chromecast / Google Cast: Cast-Protokoll fuer Chromecast und Google TV.
• DLNA: lokales Netzwerkprotokoll fuer manche TVs und Media-Renderer.
• Family filter: optionaler leichter Profanity-Filter fuer Captions/Subtitles.
• Confidence: Hinweis, wie sicher eine Quelle oder ein Match ist.