Uitgebreide gebruikershandleiding

1. Waar deze handleiding voor is

Deze handleiding beschrijft het gebruik van VoxFrame Subtitle Player van start tot einde. De tekst volgt de huidige app zoals die in de code is opgebouwd: het hoofdscherm, de player-controls, alle menu's, de instellingen en de belangrijkste workflows rond lokale video, IPTV, ondertitels, transcriptie, vertaling, kwaliteitscontrole en account/cloud.

De app gebruikt in de interface soms de Engelse term subtitle en soms het Nederlandse ondertitel. In deze handleiding bedoelen beide hetzelfde: tekstregels die met de video of stream worden meegetoond.

2. De app starten

Start VoxFrame Subtitle Player via de meegeleverde snelkoppeling of startopdracht. Na het starten zie je het lege player-scherm met de titel VoxFrame Subtitle Player en de knop Open video.

Wanneer er nog geen video is geladen, kun je op drie manieren beginnen:

1. Klik op Open video in het lege scherm.
2. Klik in het player-menu op Open video.
3. Sleep een videobestand naar het venster.

De app accepteert op dit moment lokale videobestanden met deze extensies: .mp4, .mkv, .avi, .mov, .webm, .m4v en .ts.

Voor ondertitels accepteert de app deze bestanden: .srt, .vtt, .webvtt, .ass en .ssa.

3. Het hoofdscherm

Het hoofdscherm is video-first. De video staat centraal; de bediening verschijnt als overlay. Tijdens het kijken verdwijnt de bediening automatisch na enkele seconden. Beweeg de muis of klik/tik op het venster om de bediening terug te halen.

Bovenin staat de titelbalk met de videonaam of de naam van de stream. Onderaan staat de playerbalk met voortgang, tijd, afspeelknoppen, subtitle-status en menu's.

De belangrijkste onderdelen onderin zijn:

• Progress slider: sleep over de tijdlijn om te zoeken in een lokale video.
• Play/Pause: start of pauzeert de video.
• Stop: stopt de video en sluit de huidige video uit de player.
• Back 10 seconds: springt 10 seconden terug.
• Forward 10 seconds: springt 10 seconden vooruit.
• Time: toont huidige positie en totale duur.
• Subtitle status: toont bijvoorbeeld welke subtitle actief is, of No subtitles.
• Stop current task: verschijnt tijdens AI/STT/vertalingstaken en stopt de lopende taak.
• Volume: opent het volumemenu.
• CC: opent het subtitle-track menu.
• Captions toggle: zet captions aan of uit.
• Speed: opent de snelheidskeuze.
• Player menu: opent alle hoofdacties.
• Fullscreen: schakelt fullscreen aan of uit.

4. Sneltoetsen

De app ondersteunt de volgende sneltoetsen wanneer er een video is geladen:

• Space: afspelen/pauzeren.
• Media Play/Pause: afspelen/pauzeren op toetsenborden met mediatoetsen.
• Left: 10 seconden terug.
• Right: 10 seconden vooruit.
• Up: volume 5 procent omhoog.
• Down: volume 5 procent omlaag.
• F: fullscreen aan of uit.
• M: mute aan of uit.
• C: captions aan of uit.
• Esc: sluit eerst open menu's of instellingen; in fullscreen gaat de app terug naar normaal venster.
• Ctrl+O: video openen.

Als er nog geen video is geladen, werkt Ctrl+O wel; de andere afspeeltoetsen wachten tot er media open is.

5. Een lokale video openen

Gebruik Open video om een lokale video te selecteren. Je kunt ook een video naar het venster slepen. Wanneer de video opent:

1. De app toont kort een laadstatus.
2. De video-engine opent de video.
3. De app zoekt of er vorige instellingen voor deze video zijn onthouden.
4. Als er geen video-geheugen is en de bron lokaal is, zoekt de app naar een sidecar subtitle naast het videobestand.

Sidecar subtitles worden automatisch gevonden wanneer:

• het subtitlebestand dezelfde basisnaam heeft als de video, bijvoorbeeld Film.mkv en Film.srt; of
• er precies een bruikbaar subtitlebestand in dezelfde map staat.

Wanneer er meerdere losse subtitles in dezelfde map staan en de app niet zeker weet welke bedoeld is, kiest hij niet automatisch. Laad dan handmatig de juiste subtitle via Open subtitle.

6. Video-geheugen per bestand

VoxFrame onthoudt een aantal keuzes per video. Als je dezelfde video later weer opent, herstelt de app waar mogelijk:

• geladen subtitlepad;
• subtitlevertraging;
• of captions aan of uit stonden;
• gekozen subtitletaal;
• gekozen doeltaal voor vertaling;
• subtitle style preset;
• glossary/name-lock tekst;
• minimum match instelling;
• laatste vertaalcontext, zodat quality check en bilingual review later nog weten welke bron en vertaling bij elkaar horen.

Live transcript subtitles worden niet als gewone herstelbare subtitle bewaard. Als een live transcript-pad uit de tijdelijke live-map komt, wordt dat bij heropenen overgeslagen.

7. Ondertitels handmatig openen

Kies in het player-menu Open subtitle om een subtitlebestand te laden. De app probeert het bestand te lezen via de subtitle-loader en laadt het in de video-engine.

Na het laden:

• wordt de subtitle zichtbaar als captions aan staan;
• probeert de app taal te herkennen uit bestandsnaam of trackinformatie;
• wordt de subtitlevertraging teruggezet naar 0;
• wordt de sync-analyse opnieuw berekend;
• wordt de keuze in het video-geheugen opgeslagen.

Als laden mislukt, toont de app een melding en blijft de video gewoon speelbaar.

8. Het CC/subtitle-menu

Klik op CC om het subtitle-menu te openen. In de huidige build is dit menu ook de compacte Subtitle Assistant hub. Je ziet hier dus niet alleen tracks, maar ook status, bronuitleg en snelle subtitle-acties.

Bovenin toont VoxFrame:

• de subtitle-status, bijvoorbeeld welke track actief is of dat er geen subtitle is;
• bron/confidence-uitleg, zoals OpenSubtitles match, hash/releasenaam, translated, AI generated, synced of quality-fixed;
• de belofte OpenSubtitles first - translate/generate only if needed;
• de gekozen doeltaal via de taalchip.

De snelle knoppen in dit menu zijn:

• Smart Subtitle Assistant: zoekt menselijke subtitles eerst, vertaalt of genereert alleen als nodig.
• Translate: opent de vertaalacties voor een geladen subtitle.
• Sync: start sync met fast STT wanneer er een lokale video en subtitle zijn.
• Live: opent live transcript/translate bij IPTV/live stream context.
• Language: opent de doeltaalkeuze.

Onder de hub staan de beschikbare tracks. Daar kun je:

• een embedded subtitletrack kiezen;
• een externe subtitletrack kiezen;
• captions uitzetten via No subtitles of CC off;
• de subtitlevertraging aanpassen;
• de verticale subtitlepositie aanpassen.

Subtitlevertraging

Gebruik -0.5s en +0.5s om de subtitle in stappen van een halve seconde te verschuiven.

• Gebruik -0.5s als de tekst te laat komt.
• Gebruik +0.5s als de tekst te vroeg komt.

Bij gewone subtitles past de app de mpv subtitle-delay aan. Bij live captions in buffered sync past de app de live caption display offset aan.

Subtitlepositie

Gebruik de pijlen omhoog en omlaag in het subtitle-menu om de verticale positie van subtitles aan te passen. De positie wordt opgeslagen als percentage. Standaard staat deze op 90 procent. De app begrenst de waarde tussen 20 procent en 97 procent zodat captions zichtbaar blijven.

9. Captions aan en uit zetten

De captions-toggle naast CC schakelt subtitles in of uit. De sneltoets C doet hetzelfde.

Wanneer captions uit staan:

• blijft de video doorspelen;
• blijven geladen subtitles aanwezig;
• wordt alleen de weergave verborgen;
• wordt de keuze per video onthouden.

Wanneer captions weer aan gaan, toont de app de laatst gekozen subtitletrack of geladen subtitle opnieuw.

10. Volume

Klik op het volumepictogram om de volume-slider te openen. Je kunt ook Up en Down gebruiken om het volume in stappen van 5 procent te wijzigen.

Met M schakel je mute aan of uit. Als je mute uitschakelt, herstelt de app het vorige volume of minimaal een bruikbaar volume.

11. Afspeelsnelheid

Klik op Speed om de snelheidskeuze te openen. De huidige keuzes zijn:

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

De gekozen snelheid wordt direct toegepast op de video-engine.

12. Fullscreen

Gebruik de fullscreen-knop of druk op F. Druk op Esc om fullscreen te verlaten. Wanneer er een menu openstaat, sluit Esc eerst dat menu.

13. Het player-menu

Het player-menu is de hoofdplek voor de grote workflows. Open het via het tandwiel/menu-pictogram rechts onderin. De huidige indeling is gegroepeerd rond duidelijke modes, zodat je minder losse technische acties hoeft te onthouden.

Local Mode

Local Mode bevat de basisacties voor bestanden en playlists:

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

Subtitle Assistant

Subtitle Assistant is de plek voor de slimme subtitle-flow:

• Choose language
• Smart Subtitle Assistant
• Search human subtitles of OpenSubtitles via VoxFrame Cloud
• Translate of Translate via VoxFrame Cloud
• Subtitle quality check

Live Mode

Live Mode verschijnt bij IPTV/live stream context en bevat live subtitlefuncties:

• Sync with fast STT
• Live transcript / translate
• Transcribe via VoxFrame Cloud wanneer de cloudroute beschikbaar is
• Benchmark fast STT

Every screen

Every screen bevat kijken op andere schermen en de lichte gezinsfilter:

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

Daarnaast staat er rechts onderin een aparte Cast-knop. Daarmee open je het Cast-menu voor Chromecast, Google TV en DLNA-apparaten op hetzelfde netwerk. LAN Watch en Chromecast gebruiken dezelfde lokale HLS-basis, maar LAN Watch is een QR/browser-player; Chromecast stuurt playback naar een cast-apparaat.

Sommige knoppen zijn afhankelijk van de huidige bron. Lokale subtitle-tools verschijnen alleen wanneer er een lokaal videobestand is. Live transcript en live translate verschijnen bij IPTV/live stream context. Als VoxFrame Cloud actief is en je account de route toestaat, kunnen labels naar via VoxFrame Cloud veranderen.

14. Smart Subtitle Assistant

Smart Subtitle Assistant is de aanbevolen route voor gewone films en afleveringen. De knop bundelt de losse stappen Find best subtitle, Generate if missing, Translate en Fix sync in een flow.

De volgorde is bewust menselijk eerst:

1. VoxFrame controleert eerst embedded tracks en lokale sidecar subtitles.
2. Daarna zoekt VoxFrame bij OpenSubtitles naar menselijke subtitles in de gekozen doeltaal.
3. Als de gekozen taal ontbreekt, probeert VoxFrame eerst een Engelse menselijke subtitle te vinden en die naar de gekozen taal te vertalen.
4. Pas als er geen bruikbare menselijke bron is en generatie is toegestaan, maakt VoxFrame zelf een subtitle uit de audio.
5. Waar mogelijk volgt een sync- of quality-stap, zodat de subtitle beter bij de video past.

In het subtitlegebied zie je bron- en confidence-uitleg. Voorbeelden zijn OpenSubtitles match, hash/releasenaam, lage matchscore, translated, AI generated, synced of quality-fixed. Dat maakt duidelijk waarom VoxFrame een subtitle kiest en of AI nodig was.

Belangrijk: voor lokale films start de taalwissel niet meteen transcriptie. Als er geen embedded of lokale SRT in de gekozen taal is, vraagt VoxFrame of het mag zoeken. Daarna volgt OpenSubtitles en eventueel vertaling uit een Engelse menselijke subtitle. AI-transcriptie is de laatste stap, niet de eerste.

15. Doeltaal kiezen

Kies Choose language of de taalchip in het subtitlegebied om de subtitle-doeltaal te selecteren. De snelle taalchips tonen meestal de huidige taal plus NL, EN, DE en FR. In de volledige lijst staan meer talen.

De huidige subtitle-doeltalen zijn:

• NL Nederlands
• EN Engels
• DE Duits
• FR Frans
• ES Spaans
• IT Italiaans
• PT Portugees
• PL Pools
• TR Turks
• AR Arabisch
• SV Zweeds
• NO Noors
• DA Deens
• FI Fins
• RO Roemeens
• CS Tsjechisch
• HU Hongaars
• EL Grieks
• RU Russisch
• UK Oekraiens
• JA Japans
• KO Koreaans
• ZH Chinees
• HI Hindi
• ID Indonesisch

Deze keuze wordt gebruikt voor:

• OpenSubtitles zoektaal;
• vertaling van geladen subtitles;
• live translate doeltaal;
• batch translate voorkeursoutput;
• video-geheugen per video.

Als je tijdens een lokale film van taal wisselt, probeert VoxFrame eerst een embedded track in die taal te gebruiken. Daarna kijkt de app naar lokale sidecar subtitles zoals Film.nl.srt. Als die ontbreken, vraagt VoxFrame of het mag zoeken: eerst OpenSubtitles in de doeltaal, daarna een Engelse menselijke subtitle als vertaalbron.

Als je tijdens IPTV/live translate van taal wisselt, verandert VoxFrame de doeltaal voor nieuwe live chunks. De stream blijft doorlopen; de al getoonde captions worden niet opnieuw terugwerkend vertaald.

16. OpenSubtitles gebruiken

Kies Search human subtitles of OpenSubtitles via VoxFrame Cloud om voor de huidige lokale video een menselijke subtitle te zoeken. Dit is de voorkeursroute: VoxFrame zoekt eerst menselijke subtitles en gebruikt AI alleen als dat nodig is.

De normale workflow:

1. De app maakt een video-identiteit met hash, bestandsgrootte, titel en jaar waar mogelijk.
2. De app zoekt bij OpenSubtitles in de gekozen doeltaal.
3. Kandidaten worden gescoord op matchkwaliteit.
4. Als de beste match boven de minimumscore ligt, downloadt de app die subtitle.
5. De subtitle wordt geladen en de bron/confidence wordt in status en logs meegenomen.

De minimumscore staat in Settings > Player > Min. match. Standaard is dit 0.85. Een hogere waarde is strenger; een lagere waarde accepteert sneller matches met meer risico op verkeerde sync of verkeerde release.

Als de gekozen doeltaal geen goede match heeft, probeert VoxFrame niet meteen te transcriberen. De app kijkt eerst of er een Engelse menselijke subtitle beschikbaar is. Als die er is, kan VoxFrame die naar de gekozen taal vertalen. Dit is vooral handig bij talen waar minder OpenSubtitles-resultaten bestaan.

Als OpenSubtitles niets bruikbaars geeft, kan de app afhankelijk van instellingen proberen:

• een Engelse menselijke subtitle te vinden en naar de doeltaal te vertalen;
• pas daarna zelf een subtitle te genereren uit de audio.

Wanneer OpenSubtitles tijdelijk beperkt of blokkeert, kun je meldingen zien zoals HTTP 429, API rate limit exceeded of VoxFrame Cloud HTTP 502 met OpenSubtitles-details. Dat betekent meestal dat OpenSubtitles tijdelijk te veel verzoeken ziet. Wacht even en probeer later opnieuw. Als VoxFrame in die situatie een Engelse subtitle vindt, verschijnt de keuze om die alsnog naar je gekozen taal te vertalen.

OpenSubtitles gebruikt de providerinstellingen uit Settings > Player > Providers, tenzij VoxFrame Cloud actief is en de app de cloudroute gebruikt.

17. AI subtitles genereren

Kies Generate AI subtitles of Transcribe via VoxFrame Cloud wanneer je een lokale video hebt zonder bruikbare menselijke subtitle. Binnen de Smart Subtitle Assistant gebeurt dit pas nadat embedded tracks, sidecar subtitles, OpenSubtitles en de Engelse vertaalfallback geen bruikbare oplossing gaven.

De app probeert afhankelijk van installatie en account in volgorde:

1. snelle lokale STT via Purfview Faster-Whisper;
2. lokale Whisper.cpp fallback;
3. cloud/transcriptieroute wanneer die beschikbaar en geconfigureerd is.

Voor lokale STT pauzeert de app de video tijdelijk, maakt of gebruikt een video-identiteit en schrijft een generated subtitle naar de cache. Daarna wordt de subtitle automatisch geladen. Bij langere taken toont de UI status en waar mogelijk progress of een tijdsinschatting.

Gebruik AI-generatie vooral wanneer er echt geen goede menselijke bron is. Een goede OpenSubtitles-match is meestal sneller, lichter en beter gesynchroniseerd dan opnieuw transcriberen.

De lokale STT-instellingen staan in Settings > Speech to Text.

18. Subtitle vertalen

Kies Translate in het player-menu of subtitlegebied. Daarna opent een submenu met vertaalacties.

Voor vertaling heeft de app een translatable subtitle nodig. Dat kan zijn:

• een geladen externe subtitle;
• een externe subtitletrack die de app kan lezen;
• een embedded subtitletrack die de app naar SRT kan exporteren;
• bij live context: een bestaand live transcript in de overlay.

Als bron en doel dezelfde concrete taal zijn, slaat de app vertaling over en meldt dat de subtitle al in die taal is.

Als er geen subtitle geladen is bij een IPTV/live stream, gebruikt VoxFrame niet de gewone translate-knop. Gebruik dan Live transcript / translate. Bij lokale films vraagt VoxFrame eerst of het mag zoeken naar subtitles, zodat een Engelse menselijke subtitle als vertaalbron kan dienen.

Translate only

Translate only vertaalt de huidige subtitle naar de gekozen doeltaal. De vertaling wordt als nieuw subtitlebestand opgeslagen en daarna geladen.

De app onthoudt de relatie tussen bron en vertaling. Daardoor kunnen Translation quality check en Export bilingual review daarna werken. Nieuwe vertaalbestanden krijgen de doeltaal in de bestandsnaam, zodat je later kunt zien welke taal het bestand bevat. VoxFrame voegt ook een korte begin- en eindcredit toe: Subs by VoxFramePlayer.

Translate + sync

Translate + sync doet eerst hetzelfde als Translate only, en probeert daarna ASR-assisted sync toe te passen. Daarvoor gebruikt de app snelle lokale STT als referentie. Als lokale STT niet beschikbaar is, blijft de vertaling wel beschikbaar en meldt de app dat sync is overgeslagen of mislukt.

Batch translate all

Batch translate all vertaalt naar alle ondersteunde doeltalen: NL, EN, ES, FR, DE en IT.

Batch translate is bewust beperkt tot de compacte batchset NL, EN, DE, FR, ES en IT. De volledige taallijst is wel beschikbaar voor normale single-language vertaling en live translate. Als Auto-load preferred batch result aan staat in Settings > Subtitle Tools, laadt de app de output van de gekozen doeltaal automatisch. De overige outputs blijven als bestanden beschikbaar in de cache/outputlocatie.

Translation quality check

Translation quality check vergelijkt bron en vertaling op basis van de laatst onthouden vertaalcontext. De app maakt een quality report met samenvatting en mogelijke aandachtspunten.

Deze knop werkt pas nadat er een bron- en vertaalsubtitle bekend zijn, bijvoorbeeld na Translate only, Translate + sync, batchvertaling of een OpenSubtitles vertaalfallback.

Build smart glossary

Build smart glossary zoekt in de huidige subtitle naar namen en termen die waarschijnlijk vastgezet moeten worden tijdens vertaling.

Als de app suggesties vindt, opent de Smart glossary builder:

• iedere suggestie staat als aangevinkte checkbox;
• de tooltip toont een voorbeeld;
• Add selected voegt de gekozen termen toe aan de glossary;
• Cancel laat de glossary ongewijzigd.

Toegevoegde termen worden opgeslagen in de glossary-instelling.

Apply style preset

Apply style preset past de gekozen subtitle style preset toe op de huidige subtitle. De preset kies je in Settings > Player > Subtitle style.

De app schrijft een nieuwe output, laadt die indien ingesteld en toont hoeveel tekst- en timingwijzigingen zijn gedaan.

Export bilingual review

Export bilingual review maakt reviewbestanden waarin bron en vertaling naast elkaar staan. De app schrijft een HTML-bestand en een CSV-bestand. Deze functie heeft een bestaande vertaalcontext nodig.

Auto split/merge

Auto split/merge gebruikt dezelfde formatting-service als de style presets, maar richt zich op het automatisch splitsen en samenvoegen van cues voor betere leesbaarheid. De output wordt als nieuwe subtitle geschreven en geladen.

19. Subtitle quality check en repair

Kies Subtitle quality check om de huidige subtitle te analyseren en waar mogelijk te repareren.

De workflow:

1. De app controleert of er een subtitle geladen is.
2. Afhankelijk van de instellingen maakt de app een lokale STT-referentie.
3. De repair-service analyseert fouten, waarschuwingen en herstelbare punten.
4. De app schrijft altijd een report.
5. Als er een herstelde subtitle wordt geschreven, heet die .quality-fixed.srt.
6. De preview toont samenvatting en voorbeelden voordat je kiest wat ermee moet gebeuren.

In de preview zie je:

• aantal errors/warnings voor reparatie;
• aantal errors/warnings na reparatie;
• aantal wijzigingen, zoals tekstfixes, timingfixes, verwijderde cues, gesplitste cues en eventueel ingevoegde ASR-cues;
• outputbestand;
• compacte voor/na voorbeelden.

Onderaan de preview staan:

• Open report: opent het rapportbestand.
• Only save: bewaart de herstelde subtitle maar laadt hem niet.
• Load repaired subtitle: laadt de herstelde subtitle in de player, als die knop beschikbaar is.
• Close: sluit de preview.

De originele subtitle wordt niet overschreven.

20. Sync with fast STT

Sync with fast STT gebruikt een lokaal gegenereerde STT-referentie om te bepalen of de huidige subtitle verschoven moet worden.

Voorwaarden:

• er is een lokale video geladen;
• er is een subtitle geladen;
• de snelle lokale STT-engine en het gekozen model zijn beschikbaar.

Als de analyse betrouwbaar genoeg is, past de app de subtitle-delay toe en slaat die op in het video-geheugen. Als de analyse niet betrouwbaar genoeg is, laat de app de subtitle staan en toont hij de samenvatting.

21. Benchmark fast STT

Benchmark fast STT test de snelheid van de lokale snelle STT-route op een kort audiostuk van de huidige video. De app gebruikt ffmpeg om een benchmark audiofragment te maken en draait daarna de gekozen Purfview/Faster-Whisper instellingen.

Het resultaat wordt opgeslagen als laatste fast STT status en is zichtbaar in Settings > Speech to Text.

22. Subtitle exporteren

Export subtitle bewaart de huidig geladen subtitle naar een door jou gekozen bestand. Bij een gewone externe subtitle kopieert de app het bestaande subtitlebestand.

Bij een MKV of ander lokaal videobestand met embedded subtitletracks kun je ook een track naar SRT exporteren:

1. Open de video.
2. Open het CC menu.
3. Kies de embedded subtitletrack die je wilt bewaren, bijvoorbeeld Dutch (subrip) (embedded).
4. Open het player-menu.
5. Kies Export subtitle.
6. Kies de opslaglocatie. De app exporteert de gekozen embedded track als .srt.

De app gebruikt de extensie van de bron als voorgestelde extensie. Als er geen gewone geladen subtitle of gekozen embedded track is, of als de subtitlebron niet bestaat, toont de app een melding.

Live captions uit IPTV/live transcript worden niet via deze gewone exportknop bewaard.

23. IPTV playlist openen

Kies Open IPTV playlist in het player-menu.

De app opent het venster Open IPTV playlist. Daar kun je:

• een M3U/M3U8 URL plakken en Load URL kiezen;
• een lokaal .m3u of .m3u8 bestand kiezen met Open file;
• afsluiten met Cancel.

Na het laden opent de app de channel picker.

24. IPTV zenders kiezen

De IPTV channel picker toont eerst groepen. In dit venster kun je:

• zoeken op groep;
• een groep openen met Open group;
• dubbelklikken of Enter gebruiken;
• Other playlist kiezen om een andere playlist te laden;
• Cancel kiezen om terug te gaan.

Binnen een groep kun je:

• zoeken op zendernaam, groep, tvg-id of URL;
• terug naar het groepsoverzicht via Back to groups;
• de gekozen stream openen met Open stream;
• dubbelklikken of Enter gebruiken.

Als de playlist geen afspeelbare zenders bevat, toont de app een melding.

25. IPTV live transcript / translate

Bij een IPTV/live stream kun je Live transcript / translate kiezen. De app opent dan het venster Live transcript.

Opties in dit venster:

• Translate live captions: zet live vertaling aan.
• Subtitle-opstelling: kiest het transcriptieprofiel.
• Gesproken taal: kiest de taal die in de stream wordt gesproken; gebruik Auto detect als je die niet weet.
• Bufferstand: toont de gesynchroniseerde live-modus voor een remote stream.
• Live subtitle delay: voegt extra vertraging toe aan live captions.
• Target language: kiest de doeltaal voor live translate.
• Start: start de sessie.
• Cancel: sluit zonder te starten.

De profielen die nu zichtbaar zijn:

• LocalBest: aanbevolen lokale kwaliteit. Audio blijft op deze pc en het profiel gebruikt de best geteste lokale live-opstelling.
• LocalLight: een lichtere lokale opstelling voor een zwakkere pc/GPU. Het profiel gebruikt de huidige lokale spraakinstellingen; kies zo nodig een kleiner model onder Settings > Speech to Text.
• DirectOpenAi: gebruikt je eigen opgeslagen OpenAI API-key voor rechtstreekse live transcriptie met woordtiming. OpenAI rekent dit gebruik aan jou af; VoxFrame Cloud-tegoed wordt niet gebruikt.
• CloudStable: aanbevolen cloudkwaliteit. Het verwerkt audiochunks van 10 seconden via de VoxFrame Cloud-proxy.
• CloudFilmSpeakers: gebruikt chunks van 12 seconden voor meer dialoogcontext. Ondanks de profielnaam worden sprekers **niet** herkend, benoemd of gelabeld.

DirectOpenAi verschijnt alleen wanneer VoxFrame Cloud uitstaat en een eigen OpenAI API-key is opgeslagen. Cloudprofielen zijn alleen zichtbaar wanneer het account VoxFrame Cloud mag gebruiken. Bij deze profielen gaat iedere audiochunk via HTTPS naar VoxFrame en wordt die achter de VoxFrame-proxy door OpenAI verwerkt. Deze workflow gebruikt geen providercredentials in de app: de verwerking blijft achter de VoxFrame-proxy. Audioverbruik wordt pas na een geslaagde transcriptie geboekt; live vertaling wordt apart afgerekend.

Wanneer de huidige bron een remote live stream is, gebruikt de app een gesynchroniseerde buffer zodat video, audio en captions dezelfde tijdlijn houden. Met een lokaal of DirectOpenAi-profiel loopt afspelen normaal ongeveer 30 seconden achter op live; met een cloudprofiel minimaal 60 seconden, plus transcriptie- en eventuele vertaaltijd. Dit zijn kwaliteitsgerichte bufferprofielen, geen zero-delay captions.

Kies de gesproken brontaal expliciet als je die weet; dat geeft meestal voorspelbaardere herkenning. Kies Auto detect als de taal onbekend is. De gesproken brontaal en de doeltaal voor vertaling zijn twee aparte keuzes.

De hoofdplayer blijft bij live IPTV bedoeld als live player. VoxFrame kan intern bufferen voor stabiele live captions, maar de lokale player is niet bedoeld als timeshift-player waarmee je tijdens gewoon kijken minuten terugspoelt. Timeshift hoort bij de LAN Watch web-player, waar een browser binnen de beschikbare HLS-buffer kan terugzoeken.

De live delay keuzes zijn:

• 0 seconds
• +1 second
• +2 seconds
• +3 seconds
• +5 seconds

Tijdens live transcriptie worden captions als overlay getoond. De tijdelijke SRT-output wordt intern gebruikt voor de sessie, maar live captions zijn bedoeld als schermoverlay. Als de IPTV-lijn tijdelijk hapert of een segment geen audio bevat, probeert VoxFrame door te bufferen en wacht het op de volgende bruikbare audio in plaats van de hele sessie direct af te breken. Catch-up is begrensd: als verwerking te ver achter de afspeeltijdlijn raakt, kan VoxFrame een al te late audiochunk gecontroleerd overslaan in plaats van vertraging en geheugengebruik onbeperkt te laten groeien. Op een overbelaste pc of instabiele verbinding kan daardoor een kort gat in de captions ontstaan.

De status laat zien wat er gebeurt:

• Luisteren: de sessie draait en wacht op bruikbare spraak.
• Nog geen duidelijke spraak: er zijn chunks gecontroleerd zonder duidelijke spraak; dit is niet automatisch een fout.
• Tijdelijk beperkt (Degraded): een deel van de workflow loopt achter; broncaptions blijven actief wanneer vertaling niet kan bijhouden.
• Opnieuw verbinden: VoxFrame doet een begrensde herverbindingspoging.
• Mislukt (Failed): de live-captionworkflow is door een technisch probleem gestopt.

Als je de doeltaal wijzigt terwijl live translate draait, krijgen nieuwe live chunks de nieuwe taal. De video blijft lopen en de eerder getoonde captions blijven zoals ze waren.

26. LAN Watch / QR web-player

LAN Watch / QR web-player maakt een lokale browser-player voor telefoon, tablet, laptop of smart-tv-browser op hetzelfde wifi/LAN-netwerk. De app toont een QR-code en zet de link ook onder de QR-code in het klein, klikbaar en gekopieerd naar het klembord.

De web-player gebruikt lokale HLS-segmenten uit je eigen player. Er wordt geen publieke cloudstream gemaakt. Apparaten moeten de VoxFrame-computer via het lokale netwerk kunnen bereiken; firewall, gast-wifi en gescheiden VLANs kunnen de link blokkeren.

Lokale video

Bij lokale films start LAN Watch vanaf de huidige positie. Als er een gewone externe subtitle geladen en captions aan staan, maakt VoxFrame een WebVTT-track voor de web-player. Embedded MKV-subtitles worden niet automatisch meegestreamd; exporteer zo'n track eerst naar SRT en laad die als gewone subtitle als je hem via LAN Watch wilt zien.

De lokale player draagt playback tijdelijk over aan LAN Watch. Als starten mislukt, probeert VoxFrame de lokale player terug te zetten.

IPTV/live stream

Bij IPTV/live stream maakt LAN Watch een aparte live HLS-buffer met ongeveer 15 seconden playback delay, segmenten van ongeveer 5 seconden en een harde cachelimiet van 10 GB. De web-player kan binnen de beschikbare buffer terugspoelen en daarna vanaf dat gekozen punt verder spelen. Pauzeren in de web-player stopt de stream niet; de buffer blijft doorgroeien zolang de sessie actief is en de limiet niet wordt overschreden.

Als live captions actief zijn, schrijft VoxFrame een live .vtt subtitletrack voor LAN Watch en ververst die ongeveer elke twee seconden. Daardoor kunnen live subs ook in de browser-player verschijnen. De hoofdplayer kan ondertussen op pauze staan terwijl de stream en subtitlebuffer doorlopen.

Stop je LAN Watch of sluit je de player, dan ruimt VoxFrame de tijdelijke LAN Watch-map op. Bij een gedeelde live buffer blijft de hoofd-live-sessie bestaan zolang die nog actief is; stoppen van de player zelf ruimt ook die tijdelijke buffers op.

27. Chromecast / Cast

Gebruik de Cast-knop rechtsonder om het lokale Cast-menu te openen. VoxFrame zoekt op hetzelfde netwerk naar Chromecast, Google TV en DLNA-renderers. De detectie gebruikt mDNS voor Google Cast en SSDP voor DLNA.

Wanneer je een Chromecast of Google TV kiest, start VoxFrame eerst een lokale HLS-stream en stuurt daarna een LOAD-opdracht naar de Chromecast Default Media Receiver. Bij succes speelt de TV de lokale HLS-stream af en wordt lokale playback overgedragen aan de TV.

Chromecast is iets anders dan LAN Watch. LAN Watch is de QR/browser-player voor elk apparaat met een browser; Chromecast is directe cast-playback naar een cast-apparaat. Beide blijven lokaal op je netwerk en raken geen andere virtual servers of cloudstreams.

Subtitles bij Cast werken via een WebVTT-track wanneer er een gewone subtitle actief is en captions aan staan. Voor live IPTV kan VoxFrame, waar nodig, een burn-in/compatibility-route gebruiken om buffered live subtitles beter op het cast-apparaat te krijgen. Embedded MKV-subtitles zijn niet hetzelfde als een gewone geladen subtitle; exporteer ze eerst als SRT wanneer je maximale compatibiliteit wilt.

Als er geen cast-apparaten verschijnen, controleer dan of de TV/Chromecast wakker is, op hetzelfde netwerk zit, mDNS/SSDP niet door de router wordt geblokkeerd en Windows Firewall lokale inkomende verbindingen toestaat.

28. Family filter

Family filter: off/on is een lichte gezinsfilter. Als hij aan staat, verzacht VoxFrame bekende grove woorden in live captions en in een tijdelijke subtitletrack. Originele subtitlebestanden worden niet overschreven.

De filter is bedoeld als optionele kijkhulp, niet als perfecte classificatie. Controleer belangrijke content zelf als volledige oudercontrole nodig is.

29. Stoppen van AI/STT/live taken

Tijdens zoeken, genereren, transcriberen, vertalen, benchmarken of live transcriptie verschijnt Stop current task. Klik daarop om de lopende taak te annuleren.

Ook sommige menuacties werken als stop wanneer er al een taak loopt. De app zet de status dan op stoppen en probeert de lopende workflow netjes af te breken.

30. Settings openen en sluiten

Kies Settings in het player-menu. Het instellingenpaneel opent als overlay over de player. Sluiten kan via de sluitknop of met Esc.

Veel instellingen worden automatisch opgeslagen:

• checkboxes direct na wijzigen;
• keuzelijsten direct na wijzigen;
• tekstvelden wanneer het veld focus verliest;
• lokale STT-modelkeuzes direct na wijzigen.

Bij sluiten van Settings werkt de player de providerclients, taal en weergavestatus bij.

De tabs zijn:

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

31. Settings > Account

De accounttab toont licentie, aankoop, downloads, cloudstatus en gebruik.

License

Velden en knoppen:

• Status: toont Demo, Trial, Licensed, Expired of Pending.
• Activation key: invoerveld voor een VoxFrame activatie-key.
• Account e-mail: optioneel accountmailadres.
• Server: toont de API-basis waar de app mee praat.
• Device: toont device-status.
• Activate: activeert de ingevoerde key op dit apparaat.
• Refresh license: vernieuwt de licentiestatus online.
• Log out: wist lokale accountgegevens en probeert het device server-side te deactiveren wanneer dat kan.

Bij activatie controleert de app het formaat van de key. Een verwacht formaat is bijvoorbeeld VSP-XXXX-XXXX-XXXX-XXXX.

Purchase

De purchase-sectie toont Stripe/accountstatus en prijsinformatie. Afhankelijk van accountstatus kun je hier een aankoop starten of een afgeronde aankoop ophalen.

Premium options

De app toont kaarten voor:

• Player License
• Cloud Plus
• Cloud Pro

Bij Player License opent Player kopen direct Stripe checkout wanneer de app een licentietoken of accountmailadres heeft. Ontbreken die allebei, dan vraagt de app eerst om het accountmailadres.

Player License kost eenmalig EUR 24,95. Na bevestigde betaling wordt dezelfde geïnstalleerde Demo automatisch Player Pro. Er wordt geen aparte Pro-player geïnstalleerd. De licentiegegevens komen ook per e-mail voor herstel of een nieuwe installatie.

Bij cloudplannen kan de checkoutkeuze bestaan uit:

• Monthly
• One-time
• Yearly

Voor Cloud Plus/Pro opent Stripe pas na de keuze voor Monthly, One-time of Yearly. Een directe geschikte Cloud-aankoop ontgrendelt Player Pro eveneens automatisch; je hoeft Player dus niet eerst los te kopen. Het Cloud-recht blijft apart van het permanente Player Pro-recht. One-time is een Cloud-pass van 30 dagen. Yearly one-time is 365 dagen met een maandelijkse hard-cap-reset.

Aankoop ophalen

Aankoop ophalen probeert een Stripe-aankoop die via de browser is afgerond op te halen en te activeren. Deze knop is alleen actief wanneer er lokaal een pending checkout delivery token bekend is.

Downloads

In de downloads-sectie staan:

• Release controleren: vraagt de server welke release voor dit account beschikbaar is.
• Release downloaden: downloadt de gekozen release en controleert waar mogelijk de checksum.

Deze knoppen zijn licentie-afhankelijk en werken alleen wanneer de server een release voor dit account aanbiedt.

Premium Cloud

Opties en velden:

• Use VoxFrame Cloud for premium API usage: schakelt cloudroutes in wanneer je entitlement dat toestaat.
• Plan: toont het huidige plan.
• Credits/minutes: toont lokale saldo-informatie.
• Usage: toont usage-samenvatting.
• Refresh usage: haalt actuele usage op.
• Account beheren: probeert het Stripe billing portal te openen wanneer dat voor de licentie beschikbaar is. Als de server geen Stripe-portal kan maken, opent de app de VoxFrame-accountpagina als fallback en toont onder de knop een statusmelding.

Als Cloud aan staat, gebruikt de app voor ondersteunde functies de VoxFrame-cloudroute in plaats van eigen providerkeys, mits je licentie en cloudtoken geldig zijn.

32. Settings > Player

De playertab bevat gedrag, voorkeurstalen, subtitle-stijl, glossary, matchdrempel, providerkeys en cache.

Player behavior

Instellingen:

• App language: de taal van de app. Ondersteund: Engels, Nederlands, Duits en Frans.
• Search automatically: zoekt automatisch naar subtitles wanneer dat in de workflow past.
• Pick best subtitle automatically: kiest automatisch de best scorende subtitle.
• Create SRT when no match exists: genereert een subtitle wanneer er geen goede match is.
• Translate automatically: vertaalt automatisch naar de voorkeurs/doeltaal wanneer deze workflow actief is.
• Preferred languages: lijst met voorkeurstalen, bijvoorbeeld nl, en.
• Subtitle style: kiest de stijl voor style preset en formatting.
• Glossary / name lock: tekstvak met vaste termen en namen.
• Min. match: minimumscore voor OpenSubtitles selectie.

App language

De app ondersteunt:

• en
• nl
• de
• fr

Wanneer je de taal wijzigt, past het instellingenpaneel de labels direct aan.

Preferred languages

Vul taalcodes gescheiden door komma's in, bijvoorbeeld:

``text nl, en ``

De app normaliseert de lijst wanneer het veld focus verliest. Als de lijst leeg of ongeldig is, valt de app terug op nl, en.

Subtitle style

Keuzes:

• Balanced: standaard, algemene balans.
• Netflix-style: strakkere streamingstijl.
• YouTube clean: simpele, nette captions.
• Anime / fansub: past beter bij langere of expressievere subtitle-stijl.
• Short lines: kortere regels.
• Reading comfort: gericht op rustiger lezen.

Deze preset wordt gebruikt door Apply style preset, Auto split/merge en kan ook de vertaalpipeline stylen.

Glossary / name lock

Gebruik het glossary-veld om namen of vaste vertalingen te sturen.

Een regel zonder = betekent: houd deze term vast.

``text VoxFrame ``

Een regel met = betekent: vertaal bron altijd naar de vaste doelterm.

``text The Order = De Orde ``

Een glossary helpt vooral bij namen, organisaties, fictieve termen en woorden die anders per scene kunnen wisselen.

Min. match

De slider loopt van 0.00 tot 1.00. Standaard staat hij op 0.85.

• Hoger: minder kans op verkeerde OpenSubtitles match.
• Lager: meer kans dat er toch iets wordt gekozen wanneer releases slecht matchen.

33. Settings > Player > Providers

De providers-sectie bevat sleutels en modelkeuzes.

OpenAI API key

Vul hier je OpenAI API key in wanneer je lokale/eigen OpenAI-routes gebruikt. Laat het veld leeg als je de bestaande key wilt behouden.

Na Save keys worden ingevoerde secrets opgeslagen en wist de app de zichtbare velden.

OpenAI text model

Standaardkeuzes in de app:

• gpt-5.4-mini
• gpt-5.4-nano
• gpt-5-mini
• gpt-5
• gpt-5-nano
• o4-mini
• gpt-4.1-mini
• gpt-4.1

De standaard is gpt-5.4-mini.

Load models haalt beschikbare modellen op via OpenAI of via VoxFrame Cloud wanneer cloud actief is.

OpenAI transcription

De huidige standaard transcriptiekeuze is:

• whisper-1

Dit is de actieve cloud/OpenAI transcriptieroute in deze build.

OpenSubtitles

Velden:

• OpenSubtitles key
• OpenSubtitles login / username
• Password

Knoppen:

• Save keys: bewaart ingevoerde providergegevens.
• Clear keys: wist lokaal opgeslagen providergegevens. Environment variables blijven beschikbaar.
• Test OpenSubtitles: doet een smoke-search op een bekende testtitel om te controleren of search werkt.

34. Settings > Player > Cache

De cache-sectie toont de subtitle cache-map. Clear cache wist de cachemap en maakt hem opnieuw aan.

Gebruik dit wanneer:

• je oude downloads of generated subtitles wilt opruimen;
• je wilt testen of een workflow echt opnieuw downloadt/genereert;
• de cache mogelijk corrupte of verouderde bestanden bevat.

35. Settings > Subtitle Tools

Deze tab bepaalt hoe repair, translation review, live translate kwaliteit en batchgedrag werken.

Repair mode

Keuzes:

• Safe: minimale repair. Geen ASR-reference, geen ontbrekende speech invoegen en geen automatische laadkeuze.
• Standard: standaard VoxFrame gedrag. Repareert tekst/timing, gebruikt ASR wanneer beschikbaar, schrijft .quality-fixed.srt en vraagt voordat de herstelde subtitle wordt geladen.
• Aggressive: strenger. Gebruikt scherpere thresholds, splitst eerder en gebruikt ASR-hulp wanneer beschikbaar. Auto-load blijft uit zodat je eerst het report kunt controleren.

Repair checkboxes

• Use local STT reference: maakt een lokale STT-referentie voor repair wanneer mogelijk.
• Insert missing speech: mag ontbrekende ASR-cues invoegen als repair dat ondersteunt.
• Report only: maakt alleen een rapport en schrijft geen herstelde subtitle.
• Ask before loading repaired subtitle: toont de keuze voordat de herstelde subtitle wordt geladen.
• Never overwrite original: de originele subtitle wordt niet overschreven.
• Always save report: er wordt altijd een report bewaard.

De laatste twee veiligheidsinstellingen worden door de app geforceerd aan gehouden.

Translation review

Instellingen:

• Live quality: kwaliteit/latency keuze voor live translate.
• Use glossary / name lock: gebruikt de glossary tijdens vertaling.
• Use scene context: gebruikt omliggende context bij gewone subtitlevertaling.
• Suggest glossary candidates: laat quality reports glossary-kandidaten aandragen.
• Quality report after translation: maakt automatisch een quality report na vertaling.
• Review suspicious cues: markeert verdachte cues voor review.
• Auto-load preferred batch result: laadt na batchvertaling automatisch de output van de gekozen doeltaal.
• Fast fallback model for live translate: gebruikt een sneller fallbackmodel wanneer live translate dreigt achter te lopen.

Live translate quality

Keuzes:

• Fast: snelste live model eerst. Goed wanneer captions vooral moeten blijven doorlopen.
• Balanced: standaard. Gebruikt gpt-5.4-mini eerst en gpt-5.4-nano als snelle fallback wanneer live translate achter dreigt te lopen.
• Better: blijft bij het betere live model en schakelt snelle fallback uit. Gebruik dit wanneer kwaliteit belangrijker is dan latency.

Reset subtitle tools

Reset subtitle tools zet deze tab terug naar de standaardinstellingen:

• repair mode Standard;
• STT-reference aan;
• missing speech invoegen aan;
• report-only uit;
• ask before loading aan;
• glossary/name lock aan;
• scene context aan;
• glossary suggestions aan;
• auto quality report uit;
• suspicious cue review uit;
• batch preferred output auto-load aan;
• live quality Balanced;
• fast fallback voor live translate aan.

36. Settings > Speech to Text

Deze tab beheert lokale STT-engines en modellen.

Fast local engine

De snelle lokale engine is Purfview Faster-Whisper.

Velden en knoppen:

• Engine: toont de engine en of hij beschikbaar is.
• Install fast engine: downloadt en installeert de engine.
• Fast model: kiest het model.
• Install selected fast model: downloadt het gekozen model.
• Source language: kiest taal of auto-detect.
• Device: kiest Auto / CUDA if possible, CUDA of CPU.
• Compute: kiest Auto, float16, int8_float16, int8 of float32.
• Purfview args: extra argumenten voor gevorderd gebruik.

Fast model keuzes:

• 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

Standaard probeert de app large-v3-turbo te kiezen wanneer dat beschikbaar is.

Source language keuzes:

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

De hardware advice regel controleert of CUDA beschikbaar is. Als device en compute op Auto staan, kan de app advies automatisch toepassen.

Fallback engine

De fallback engine is Whisper.cpp.

Velden en knoppen:

• Engine: toont Whisper.cpp en beschikbaarheidsstatus.
• Install fallback engine: downloadt de fallback engine.
• .bin model: kiest het fallback model.
• Install selected .bin: downloadt het gekozen .bin model.

Fallback model keuzes:

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

Standaard probeert de app large-v3-turbo-q5_0 te kiezen wanneer dat beschikbaar is.

Status en progress

Onderin de Settings overlay toont de app status en downloadprogress. Tijdens downloads worden knoppen tijdelijk uitgezet. Na afronden worden modelkeuzes en beschikbaarheidslabels opnieuw geladen.

37. Settings > About

De About-tab bevat versie, maker, updates, help en diagnose.

Onderdelen:

• Version: toont de appversie.
• Maker: toont William Baars / VoxFrame.
• Updates: status van updatecontrole.
• Check for updates: controleert via account/licentie of er een release beschikbaar is.
• Account: opent de online accountpagina.
• Website: opent de website.
• Help: opent de online help.
• Credits: toont gebruikte technologieen.
• Open logs: opent de logmap voor support/diagnose.
• Veilig supportlog exporteren: schrijft een opnieuw opgeschoonde supportkopie naar de map Downloads.
• Logs verwijderen: verwijdert de diagnostische logbestanden.

De helpknop opent online help zodat handleidingen kunnen worden aangepast zonder nieuwe appbuild.

38. Logs en diagnose

Gebruik Settings > About > Open logs om de logmap zelf te bekijken. Gebruik bij voorkeur Veilig supportlog exporteren wanneer je diagnostiek naar support moet sturen; dit maakt een apart, opgeschoond tekstbestand in de map Downloads. Logs verwijderen verwijdert het huidige log en de geroteerde logs.

Logs helpen bij supportvragen rond:

• OpenSubtitles search/download;
• STT/transcriptie;
• live translate;
• LAN Watch en lokale HLS-buffer;
• Chromecast/Google TV/DLNA discovery en cast-start;
• licentie/cloudstatus;
• downloads en checksumcontrole;
• subtitle repair en quality reports.

Normale logging bevat geen captiontekst, volledige remote URL's, absolute lokale paden, providerkeys, licentie-/accesstokens of paymentdetails. Remote adressen worden beperkt tot veilige diagnose-informatie en de supportexport schoont de verzamelde bestanden, ook oudere logregels, nogmaals op.

Logging is begrensd. runtime.log roteert bij ongeveer 2 MB, maximaal drie oudere geroteerde bestanden blijven bewaard en het oudste bestand wordt automatisch verwijderd.

39. Veelvoorkomende workflows

Lokale film met bestaande subtitle

1. Open de video.
2. Controleer of sidecar/embedded subtitle automatisch is gekozen.
3. Kies anders Open subtitle.
4. Gebruik CC om track, delay en positie goed te zetten.
5. Gebruik Subtitle quality check als de subtitle rommelig is.
6. Kies eventueel Choose language en daarna Translate.

Lokale film zonder subtitle of verkeerde taal

1. Open de video.
2. Kies de gewenste taal met Choose language.
3. Kies Smart Subtitle Assistant.
4. VoxFrame controleert embedded en lokale subtitles.
5. Daarna zoekt VoxFrame OpenSubtitles in de gekozen taal.
6. Als die taal ontbreekt, vertaalt VoxFrame waar mogelijk een Engelse menselijke subtitle.
7. Alleen als er geen goede menselijke bron is, wordt AI-generatie gebruikt.
8. Controleer daarna sync via CC delay, Sync with fast STT of Subtitle quality check.

Subtitle vertalen en reviewen

1. Laad een bron-subtitle.
2. Kies de doeltaal via Choose language.
3. Vul glossary/name lock in bij Settings > Player als namen belangrijk zijn.
4. Kies Translate > Translate only.
5. Kies Translation quality check.
6. Kies Export bilingual review voor bron/vertaling naast elkaar.
7. Gebruik Apply style preset of Auto split/merge voor leesbaarheid.

Taal wijzigen tijdens het kijken

1. Klik op de taalchip of Choose language.
2. Kies de nieuwe taal.
3. Bij lokale video kiest VoxFrame eerst een embedded track als die bestaat.
4. Daarna zoekt VoxFrame een lokale sidecar subtitle.
5. Als die er niet is, vraagt VoxFrame of het OpenSubtitles en eventueel Engelse vertaling mag gebruiken.
6. Bij live IPTV/live translate verandert de taal voor nieuwe live chunks zonder de stream te stoppen.

IPTV kijken met live transcript

1. Kies Open IPTV playlist.
2. Plak een playlist-URL of open een .m3u/.m3u8 bestand.
3. Kies groep en zender.
4. Start de stream.
5. Kies Live transcript / translate.
6. Kies LocalBest, LocalLight, CloudStable of CloudFilmSpeakers.
7. Kies de gesproken taal of laat die op Auto detect staan.
8. Zet Translate live captions aan als je vertaling wilt.
9. Kies de doeltaal en start. Houd rekening met ongeveer 30 seconden lokale of minimaal 60 seconden cloudbuffer, plus verwerking.
10. Gebruik het CC menu voor live delay als captions structureel te vroeg of te laat komen.

IPTV naar LAN Watch kijken

1. Start de IPTV-zender in VoxFrame.
2. Start live transcript/translate als je live subs in de LAN-player wilt.
3. Kies LAN Watch / QR web-player.
4. Scan de QR-code of open de kleine klikbare link onder de QR-code.
5. Gebruik in de web-player de instellingenknop voor extra playeropties.
6. Pauze in de web-player mag; de live buffer blijft vullen zolang LAN Watch actief is.
7. Stop LAN Watch wanneer je terug wilt naar de lokale player.

Chromecast gebruiken

1. Zorg dat de Chromecast, Google TV of DLNA-TV op hetzelfde netwerk zit.
2. Open een video of IPTV-stream.
3. Laad een externe subtitle als je subtitles mee wilt sturen.
4. Klik op de Cast-knop rechtsonder.
5. Kies het apparaat wanneer het in de lijst verschijnt.
6. Als cast niet start, gebruik LAN Watch als browserfallback of controleer firewall/netwerk.

Lokale STT voorbereiden

1. Open Settings > Speech to Text.
2. Installeer Fast local engine.
3. Kies een fast model, bijvoorbeeld large-v3-turbo.
4. Installeer het gekozen model.
5. Laat Source language op Auto detect of kies een taal.
6. Laat Device en Compute op Auto tenzij je bewust CUDA/CPU wilt sturen.
7. Installeer eventueel de Whisper.cpp fallback engine en een .bin model.
8. Open een video en kies Benchmark fast STT om de route te testen.

40. Probleemoplossing

De video opent niet

Controleer of het bestandstype wordt ondersteund. Ondersteunde lokale video extensies zijn .mp4, .mkv, .avi, .mov, .webm, .m4v en .ts.

De subtitle laadt niet

Controleer of het bestand een ondersteund subtitleformaat heeft: .srt, .vtt, .webvtt, .ass of .ssa. Als het bestand corrupt is, kan de loader het weigeren.

OpenSubtitles werkt niet

Controleer in Settings > Player > Providers:

• OpenSubtitles key;
• username/login;
• password;
• Test OpenSubtitles.

Controleer ook de minimum match. Een te hoge Min. match kan goede maar niet perfecte kandidaten weigeren. Bij HTTP 429, API rate limit exceeded of een VoxFrame Cloud HTTP 502 met OpenSubtitles-details is OpenSubtitles meestal tijdelijk aan het limiteren. Wacht even en probeer later opnieuw. Als VoxFrame een Engelse subtitle vindt, kies dan Translate from English om toch door te kunnen.

AI subtitles genereren werkt niet

Controleer:

• of de bron een lokaal videobestand is;
• of lokale STT engine/model geinstalleerd is;
• of ffmpeg beschikbaar is;
• of OpenAI/VoxFrame Cloud geconfigureerd is wanneer lokale STT niet werkt.

Vertalen werkt niet

Controleer:

• of er een translatable subtitle is;
• of bron- en doeltaal niet hetzelfde zijn;
• of OpenAI key of VoxFrame Cloud beschikbaar is;
• of Use VoxFrame Cloud past bij je accountstatus.

Translation quality check zegt dat context ontbreekt

Deze functie heeft een bron- en vertaalsubtitle nodig. Draai eerst een vertaling via Translate only, Translate + sync, batch translate of een OpenSubtitles vertaalfallback.

Live transcript verschijnt niet

Controleer:

• of de huidige bron een IPTV/live stream context is;
• of ffmpeg beschikbaar is;
• of transcriptieprovider of cloudroute werkt;
• of captions niet met C of de captions-toggle uit staan.

Live captions lopen te vroeg of te laat

Open het CC menu en pas live delay aan met -0.5s of +0.5s. Bij het startvenster kun je ook vooraf Live subtitle delay kiezen.

LAN Watch link of QR verschijnt niet

Controleer of er een video of IPTV-stream geladen is, of ffmpeg beschikbaar is en of er geen oude cast/LAN-sessie nog bezig is met stoppen. Als de QR verschijnt maar een ander apparaat de link niet opent, controleer dan dezelfde wifi/LAN, Windows Firewall, gastnetwerk en routerisolatie.

Geen subtitles in LAN Watch

Voor lokale films moet een gewone subtitle geladen zijn en captions moeten aan staan. Embedded MKV-subtitles worden niet automatisch meegestreamd; exporteer ze eerst naar SRT en laad die SRT. Voor IPTV moeten live captions actief zijn voordat LAN Watch start, zodat VoxFrame de live .vtt kan verversen.

LAN Watch hapert of loopt achter

Bij IPTV is de bron zelf soms onstabiel. VoxFrame probeert de buffer door te laten lopen en ontbrekende audio over te slaan, maar wifi, streamkwaliteit, firewallscans of te weinig schijfsnelheid kunnen HLS-segmenten vertragen. Stop LAN Watch en start opnieuw als de web-player buiten de buffer raakt.

Chromecast verschijnt niet of start niet

Controleer of Chromecast/Google TV aan staat, op hetzelfde netwerk zit en mDNS niet geblokkeerd wordt. Voor DLNA moet SSDP bereikbaar zijn. Werkt direct casten niet, probeer LAN Watch / QR web-player op de TV-browser als fallback.

Settings lijken niet opgeslagen

Veel instellingen worden automatisch opgeslagen. Bij tekstvelden gebeurt dat meestal wanneer het veld focus verliest of Settings sluit. Sluit Settings en open opnieuw om te controleren of de waarde is genormaliseerd.

41. Begrippenlijst

• ASR: Automatic Speech Recognition; spraakherkenning uit audio.
• STT: Speech to Text; hetzelfde domein als ASR, gericht op transcriptie.
• Cue: een enkele subtitle-entry met starttijd, eindtijd en tekst.
• Sidecar subtitle: los subtitlebestand naast de video.
• Embedded track: subtitletrack die in het videobestand zelf zit.
• Target language: doeltaal voor vertaling.
• Glossary/name lock: lijst met termen die tijdens vertaling vastgezet worden.
• Quality report: rapport met subtitle- of vertaalproblemen.
• Buffered sync: live route waarbij video/audio/captions via een korte buffer op dezelfde tijdlijn blijven.
• OpenSubtitles-first: eerst menselijke subtitles zoeken; AI vertalen of genereren alleen als nodig.
• LAN Watch: lokale QR/browser-player via HLS op hetzelfde wifi/LAN-netwerk.
• HLS: streamvorm met kleine videosegmenten en een playlistbestand.
• WebVTT: subtitleformaat dat browsers en cast-apparaten goed kunnen lezen.
• Chromecast / Google Cast: cast-protocol voor Chromecast en Google TV-apparaten.
• DLNA: lokaal netwerkprotocol voor sommige smart-tv's en media-renderers.
• Family filter: optionele lichte profanity-filter voor live captions en tijdelijke subtitletracks.