Guide utilisateur detaille

1. A quoi sert ce guide

Ce guide explique VoxFrame Subtitle Player du debut a la fin. Il suit l'interface actuelle: ecran principal, controles du player, hub CC/subtitle, menu du player, Smart Subtitle Assistant, OpenSubtitles-first, traduction, captions IPTV live, LAN Watch/player web QR, Chromecast/Cast, filtre famille, compte/cloud et reglages.

L'interface utilise souvent le mot anglais subtitle. Ici, sous-titre designe les fichiers et pistes normaux. Caption designe le texte affiche pendant la lecture, surtout pour IPTV live.

2. Démarrer l'app

Demarre VoxFrame Subtitle Player avec le raccourci fourni ou la commande de lancement. Apres le demarrage, tu vois l'ecran vide du player avec le titre VoxFrame Subtitle Player et le bouton Open video.

Quand aucune video n'est encore chargee, tu peux commencer de trois facons:

1. Clique sur Open video dans l'ecran vide.
2. Clique sur Open video dans le menu du player.
3. Glisse un fichier video dans la fenetre.

L'app accepte actuellement les videos locales avec ces extensions: .mp4, .mkv, .avi, .mov, .webm, .m4v et .ts.

Pour les sous-titres, l'app accepte .srt, .vtt, .webvtt, .ass et .ssa.

3. L'écran principal

L'ecran principal donne la priorite a la video. La video est centrale; les controles apparaissent en overlay. Pendant le visionnage, les controles disparaissent automatiquement apres quelques secondes. Bouge la souris, clique ou touche la fenetre pour les afficher de nouveau.

La barre du haut montre le nom de la video ou du stream. La barre du bas contient la timeline, l'heure, les boutons de lecture, le statut sous-titre et les menus.

Les principaux controles en bas sont:

• Progress slider: glisser sur la timeline pour se deplacer dans une video locale.
• Play/Pause: demarre ou met en pause.
• Stop: arrete la lecture et ferme la video actuelle dans le player.
• Back 10 seconds: recule de 10 secondes.
• Forward 10 seconds: avance de 10 secondes.
• Time: affiche la position actuelle et la duree totale.
• Subtitle status: montre le sous-titre actif ou No subtitles.
• Stop current task: apparait pendant les taches AI/STT/traduction.
• Volume: ouvre le menu volume.
• CC: ouvre le menu des pistes de sous-titres.
• Captions toggle: active ou desactive les captions.
• Speed: ouvre les choix de vitesse.
• Player menu: ouvre les actions principales.
• Fullscreen: active ou quitte le plein ecran.

4. Raccourcis clavier

L'app prend en charge ces raccourcis quand une video est chargee:

• Space: lecture/pause.
• Media Play/Pause: lecture/pause sur les claviers avec touches media.
• Left: reculer de 10 secondes.
• Right: avancer de 10 secondes.
• Up: augmenter le volume de 5 pour cent.
• Down: baisser le volume de 5 pour cent.
• F: plein ecran.
• M: couper ou retablir le son.
• C: activer ou desactiver les captions.
• Esc: ferme d'abord les menus ou reglages ouverts; en plein ecran, revient a la fenetre normale.
• Ctrl+O: ouvrir une video.

Quand aucune video n'est chargee, Ctrl+O fonctionne quand meme. Les autres raccourcis attendent qu'un media soit ouvert.

5. Ouvrir une vidéo locale

Utilise Open video pour choisir une video locale. Tu peux aussi glisser une video dans la fenetre. Quand la video s'ouvre:

1. L'app affiche brièvement un statut de chargement.
2. Le moteur video ouvre le fichier.
3. L'app verifie si des reglages ont deja ete memorises pour cette video.
4. S'il n'y a pas de memoire video et que la source est locale, l'app cherche un sous-titre sidecar a cote du fichier video.

Les sous-titres sidecar sont detectes automatiquement quand:

• le sous-titre a le meme nom de base que la video, par exemple Movie.mkv et Movie.srt; ou
• il y a exactement un fichier sous-titre utilisable dans le meme dossier.

S'il y a plusieurs sous-titres dans le dossier et que l'app ne peut pas choisir avec certitude, elle ne charge rien automatiquement. Charge alors le bon fichier avec Open subtitle.

6. Mémoire vidéo par fichier

VoxFrame memorise plusieurs choix par video. Quand tu rouvres la meme video, l'app restaure si possible:

• chemin du sous-titre charge;
• delai de sous-titre;
• captions activees ou desactivees;
• langue de sous-titre choisie;
• langue cible de traduction;
• preset de style de sous-titre;
• texte glossary/name-lock;
• reglage minimum match;
• dernier contexte de traduction, pour que quality check et bilingual review puissent relier source et traduction.

Les sous-titres live transcript ne sont pas sauvegardes comme sous-titres restaurables normaux. Si un chemin live transcript vient du dossier live temporaire, il est ignore lors de la reouverture.

7. Ouvrir des sous-titres manuellement

Choisis Open subtitle dans le menu du player pour charger un fichier sous-titre. L'app lit le fichier avec le subtitle loader et le charge dans le moteur video.

Apres chargement:

• le sous-titre devient visible si les captions sont activees;
• l'app essaie de detecter la langue depuis le nom de fichier ou les infos de piste;
• le delai de sous-titre revient a zero;
• l'analyse de sync est recalculee;
• le choix est memorise dans la memoire video.

Si le fichier ne peut pas etre lu, l'app signale que le sous-titre n'a pas pu etre charge.

8. Le menu CC/subtitle

Clique sur CC pour ouvrir le menu sous-titre. Dans le build actuel, ce menu est aussi le hub compact Subtitle Assistant. Tu y vois les pistes, le statut, la source, la confidence et les actions rapides.

En haut, VoxFrame affiche:

• le sous-titre ou la piste active;
• des infos source/confidence comme OpenSubtitles match, hash/nom de release, translated, AI generated, synced ou quality-fixed;
• la promesse OpenSubtitles first - translate/generate only if needed;
• la langue cible via le chip de langue.

Les boutons rapides sont:

• Smart Subtitle Assistant: cherche d'abord des sous-titres humains, puis traduit ou genere seulement si necessaire.
• Translate: ouvre les actions de traduction.
• Sync: lance Fast-STT-Sync si video locale et sous-titre sont disponibles.
• Live: ouvre live transcript/translate pour IPTV/live streams.
• Language: ouvre le choix de langue.

Sous le hub, tu peux choisir une piste embedded ou externe, couper les captions, modifier le delai et ajuster la position verticale.

Delai de sous-titre

Les controles sont -0.5s et +0.5s. Utilise -0.5s si le texte arrive trop tard et +0.5s s'il arrive trop tot. Pour les captions live, les memes boutons reglent le decalage live.

Position du sous-titre

La position de sous-titre deplace les sous-titres normaux plus haut ou plus bas. C'est utile si le texte recouvre les controles, les graphismes TV ou des captions incrustees.

9. Activer et désactiver les captions

Utilise le bouton captions ou appuie sur C. Desactiver les captions ne decharge pas le sous-titre:

• la lecture continue;
• les sous-titres charges restent disponibles;
• seul l'affichage est masque;
• le choix est memorise par video.

Quand les captions sont reactivees, l'app montre la derniere piste choisie ou le dernier sous-titre charge.

10. Volume

Clique sur le bouton volume pour ouvrir le menu volume. Tu peux deplacer le slider ou utiliser les raccourcis clavier.

M coupe ou retablit le son. Up et Down ajustent le volume par pas de 5 pour cent.

11. Vitesse de lecture

Clique sur Speed pour choisir la vitesse de lecture. Les choix actuels sont:

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

L'app affiche la valeur actuelle sur le bouton speed. Les changements s'appliquent a la session player actuelle.

12. Plein écran

Utilise le bouton plein ecran ou appuie sur F. En plein ecran, le player cache le chrome de fenetre normal et garde la video au centre.

Appuie de nouveau sur Esc ou F pour revenir a la fenetre normale.

13. Le menu du player

Le menu du player est regroupe en modes clairs, pour eviter une longue liste technique.

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

Quand VoxFrame Cloud est actif et autorise par le compte, les actions prises en charge passent par la route cloud au lieu de tes propres cles provider.

Smart Subtitle / Live Mode

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

Cast Mode / Guardian

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

LAN Watch et Chromecast utilisent tous deux une base HLS locale. LAN Watch est le player QR/browser; Chromecast envoie la lecture vers un appareil cast.

14. Smart Subtitle Assistant

Smart Subtitle Assistant est la route recommandee pour les films et series. Un clic tente toute la chaine sous-titre dans le bon ordre.

L'ordre est human-first:

1. VoxFrame verifie les pistes embedded et les fichiers SRT/VTT locaux.
2. VoxFrame cherche ensuite sur OpenSubtitles dans la langue cible.
3. Si aucun bon resultat cible n'existe, VoxFrame cherche un sous-titre humain anglais et le traduit vers la langue cible.
4. Seulement si aucune source humaine utilisable n'existe, VoxFrame genere avec STT/AI.

En cas de limite OpenSubtitles, par exemple HTTP 429, API rate limit exceeded ou VoxFrame Cloud HTTP 502, VoxFrame affiche la raison et propose le fallback utile: traduire depuis l'anglais si une source anglaise existe.

Pendant recherche, telechargement, traduction ou generation, l'UI affiche le statut, une duree approximative ou la progression.

15. Choisir la langue cible

Utilise Choose language ou le chip de langue dans le hub CC/subtitle. Langues prises en charge: NL, EN, DE, FR, ES, IT, PT, PL, TR, AR, SV, NO, DA, FI, RO, CS, HU, EL, RU, UK, JA, KO, ZH, HI et ID.

La langue influence OpenSubtitles, traduction, live translate, batch translate et memoire video.

Si tu changes de langue pendant un film local, VoxFrame verifie d'abord les pistes embedded, puis les fichiers SRT/VTT locaux. Si rien ne correspond, l'app demande si elle doit chercher: OpenSubtitles d'abord, puis traduction depuis l'anglais si necessaire.

Pour IPTV/live translate, la nouvelle langue est envoyee au workflow live. Le stream doit continuer pendant que les nouvelles captions arrivent.

16. Utiliser OpenSubtitles

VoxFrame cherche d'abord des sous-titres humains. OpenSubtitles est donc la premiere etape en ligne pour les videos locales, avant la generation AI.

Workflow typique:

1. L'app cree une identite video avec hash, taille, titre, annee et nom de release quand possible.
2. L'app cherche sur OpenSubtitles dans la langue cible.
3. Les candidats sont notes avec hash, nom de release et qualite de match.
4. Le meilleur resultat est charge si la confidence est suffisante.
5. La source apparait dans le statut, par exemple OpenSubtitles match.

Si aucun resultat cible n'est assez bon, VoxFrame cherche d'abord un sous-titre humain anglais comme source. La generation AI reste le dernier recours. Si HTTP 429 ou API rate limit exceeded apparait, la limite OpenSubtitles est atteinte.

17. Generer des AI subtitles

Generate AI subtitles est le fallback quand une video locale n'a pas de sous-titre humain utilisable. Dans Smart Subtitle Assistant, cette route arrive seulement apres embedded/local, OpenSubtitles cible et source humaine anglaise.

L'app peut utiliser STT locale rapide via Purfview Faster-Whisper, Whisper.cpp en fallback ou transcription cloud. Si un sous-titre humain anglais existe deja, VoxFrame doit le traduire au lieu de transcrire.

18. Traduire des sous-titres

Translate traduit le sous-titre charge ou la meilleure source trouvee vers la langue cible. Pour un film local, la source preferee est un sous-titre humain anglais quand aucun bon sous-titre cible n'existe.

Sources possibles: SRT/VTT externe, piste embedded exportable, resultat OpenSubtitles anglais ou live transcript. Si source et cible sont la meme langue, VoxFrame saute la traduction.

La sortie contient le code langue dans le nom de fichier, par exemple .ro.srt, pour reconnaitre la version plus tard. Les SRT termines recoivent la ligne Subs by VoxFramePlayer. pour debut/fin.

Batch translate all reste limite a NL, EN, DE, FR, ES et IT. Les traductions normales une par une acceptent davantage de langues.

19. Subtitle quality check et repair

Subtitle quality check verifie le sous-titre charge pour les problemes courants. Le comportement exact depend de Settings > Subtitle Tools.

Workflow typique:

1. L'app verifie qu'un sous-titre est charge.
2. Selon les reglages, elle cree une reference STT locale.
3. Le service repair analyse erreurs, avertissements et points reparables.
4. L'app ecrit toujours un rapport.
5. Si un sous-titre repare est ecrit, il s'appelle .quality-fixed.srt.
6. La preview montre resume et exemples avant que tu choisisses quoi faire.

La preview peut montrer:

• nombre d'erreurs/avertissements avant repair;
• nombre d'erreurs/avertissements apres repair;
• nombre de changements, comme corrections texte, corrections timing, cues supprimees et parole manquante inseree;
• fichier de sortie;
• exemples compacts avant/apres.

Actions de preview:

• Open report: ouvre le fichier rapport.
• Only save: sauvegarde le sous-titre repare sans le charger.
• Load repaired subtitle: charge le sous-titre repare dans le player si disponible.
• Close: ferme la preview.

20. Sync with fast STT

Sync with fast STT essaie d'aligner le sous-titre charge avec une reference STT locale rapide.

Conditions:

• une video locale est chargee;
• un sous-titre est charge;
• le moteur STT local rapide et le modele choisi sont disponibles.

Cette action n'est pas une traduction. Elle analyse le timing de la parole et ecrit un sous-titre synchronise quand la correspondance est assez fiable.

21. Benchmark fast STT

Benchmark fast STT teste la vitesse de la route STT locale rapide sur un court fragment audio de la video actuelle. L'app utilise ffmpeg pour creer un fragment audio de benchmark puis lance les reglages Purfview/Faster-Whisper choisis.

Le resultat est sauvegarde comme dernier statut fast STT et visible dans Settings > Speech to Text.

22. Exporter des sous-titres

Export subtitle sauvegarde le sous-titre actuellement charge vers un fichier que tu choisis. Pour un sous-titre externe normal, l'app copie le fichier sous-titre existant.

Pour un MKV ou une autre video locale avec pistes embedded, tu peux exporter une piste en SRT:

1. Ouvre la video.
2. Ouvre le menu CC.
3. Choisis la piste embedded a conserver, par exemple Dutch (subrip) (embedded).
4. Ouvre le menu du player.
5. Choisis Export subtitle.
6. Choisis l'emplacement. L'app exporte la piste embedded choisie en .srt.

L'app utilise l'extension source comme extension proposee. S'il n'y a pas de sous-titre normal charge ni de piste embedded choisie, ou si la source n'existe plus, l'app affiche un message.

Les captions live d'IPTV/live transcript ne sont pas sauvegardees par ce bouton d'export normal.

23. Ouvrir une playlist IPTV

Choisis Open IPTV playlist dans le menu du player.

L'app ouvre la fenetre Open IPTV playlist. Tu peux:

• coller une URL M3U/M3U8 et choisir Load URL;
• choisir un fichier local .m3u ou .m3u8 avec Open file;
• fermer avec Cancel.

Apres chargement, l'app ouvre le channel picker.

24. Choisir des chaînes IPTV

Le channel picker montre d'abord les groupes quand ils existent. Tu peux:

• chercher par groupe;
• ouvrir un groupe avec Open group;
• double-cliquer ou utiliser Enter;
• choisir Other playlist pour charger une autre playlist;
• choisir Cancel pour revenir.

Dans un groupe, ou quand il n'y a pas de groupes, l'app montre les chaines. Tu peux:

• chercher par nom de chaine, groupe, tvg-id ou URL;
• revenir a la vue groupes avec Back to groups;
• ouvrir le stream choisi avec Open stream;
• double-cliquer ou utiliser Enter.

25. IPTV live transcript / translate

Live transcript / translate est prevu pour IPTV ou autres live streams. L'app lit l'audio en continu, cree des segments texte et les affiche comme captions. Si live translate est actif, le texte est traduit vers la langue cible.

La fenetre live contient notamment:

• Translate live captions: active la traduction live;
• Configuration des sous-titres: choisit le profil de transcription;
• Langue parlee: choisit explicitement la langue source; utilise Detection automatique si elle est inconnue;
• Buffer mode: montre le mode live synchronise utilise pour un stream distant;
• Live subtitle delay: ajoute un delai d'affichage supplementaire;
• Target language: choisit la langue cible quand la traduction est active.

Les profils actuellement visibles sont:

• LocalBest: qualite locale recommandee. L'audio reste sur ce PC et le profil utilise la meilleure configuration live locale testee;
• LocalLight: configuration locale plus legere pour un PC/GPU moins puissant. Elle utilise les reglages vocaux locaux actuels; choisis au besoin un modele plus petit dans Settings > Speech to Text;
• DirectOpenAi: utilise ta propre cle API OpenAI enregistree pour une transcription live directe avec horodatage des mots. OpenAI te facture cet usage; aucun credit VoxFrame Cloud n'est utilise;
• CloudStable: qualite cloud recommandee, avec des blocs audio de 10 secondes traites par le proxy VoxFrame Cloud;
• CloudFilmSpeakers: blocs de 12 secondes pour davantage de contexte de dialogue. Malgre son nom, ce profil **n'identifie, ne nomme et ne marque pas** les intervenants.

DirectOpenAi apparait seulement quand VoxFrame Cloud est desactive et qu'une cle API OpenAI personnelle est enregistree. Les profils cloud sont visibles seulement si le compte autorise VoxFrame Cloud. Chaque bloc audio est alors envoye par HTTPS a VoxFrame et traite par OpenAI derriere le proxy VoxFrame. L'app ne recoit pas de credentials provider pour ce workflow: le traitement reste derriere le proxy VoxFrame. La consommation audio est comptee seulement apres une transcription reussie; la traduction live est facturee separement.

Pour un stream distant, la lecture synchronisee reste normalement environ 30 secondes derriere le direct avec un profil local ou DirectOpenAi, et au moins 60 secondes avec un profil cloud, plus le temps de transcription et de traduction eventuelle. Ce sont des profils bufferises orientes qualite, pas des captions sans delai.

Choisis la langue parlee explicitement quand tu la connais: la reconnaissance est en general plus previsible. Detection automatique reste disponible si la langue source est inconnue. Langue parlee et langue cible sont deux choix distincts.

Le player local principal reste live. Pendant IPTV normal, il ne doit pas devenir un DVR local avec 10 minutes de retour. LAN Watch a son propre buffer HLS, mais le player local garde le comportement live.

Si l'IPTV hache, si l'audio disparait ou si la chaine ne fournit pas de parole utilisable, la chaine live continue a attendre et bufferiser. Le rattrapage est borne: si le traitement depasse trop la fenetre de lecture, VoxFrame peut sauter proprement un bloc audio deja trop tardif au lieu de laisser le delai et la memoire augmenter sans limite. Cela peut creer un court trou dans les captions sur un PC surcharge ou une connexion instable.

Le statut indique l'etat du workflow:

• Listening: la session fonctionne et attend une parole exploitable;
• No speech yet: des blocs ont ete verifies sans parole claire; ce n'est pas automatiquement une erreur;
• Degraded: une partie du workflow est temporairement limitee; les captions source restent actives si la traduction ne suit pas;
• Reconnecting: VoxFrame effectue une tentative de reconnexion bornee;
• Failed: le workflow live s'est arrete a cause d'un probleme technique.

Si tu changes de langue cible, la nouvelle langue est utilisee pour les nouveaux blocs sans redemarrer le stream. Les captions deja affichees ne changent pas.

26. LAN Watch / QR web-player

LAN Watch / QR web-player cree un player navigateur local pour telephone, tablette, laptop, navigateur Smart TV ou autre appareil sur le meme Wi-Fi/LAN. VoxFrame affiche un QR code et, dessous, un petit lien cliquable. L'URL est aussi copiee dans le presse-papiers.

Pour les films locaux, LAN Watch demarre a la position actuelle. Les sous-titres externes SRT/VTT normaux peuvent etre envoyes comme WebVTT. Les sous-titres embedded MKV ne sont pas automatiquement streamables; exporte-les d'abord en SRT et charge ce fichier.

Pour IPTV/live stream, LAN Watch cree un buffer live HLS separe avec environ 15 secondes de delai et des segments d'environ 5 secondes. La pause dans le web-player n'arrete pas le buffer serveur; il continue a se remplir. Dans la duree disponible, tu peux revenir en arriere et continuer depuis cette position.

La limite de cache LAN Watch est 10 GB. Quand tu arretes LAN Watch ou fermes le player, VoxFrame supprime directement le buffer temporaire. Les live captions peuvent suivre si elles etaient actives avant le lancement de LAN Watch.

27. Chromecast / Cast

Chromecast / Cast ouvre le menu cast. VoxFrame cherche sur le meme reseau les Chromecast, Google TV et renderers DLNA. Le PC et l'appareil cast doivent etre visibles; VPN, firewall ou routeur peuvent bloquer mDNS/SSDP.

Quand tu choisis Chromecast ou Google TV, VoxFrame lance un stream HLS local et envoie une commande LOAD au Chromecast Default Media Receiver. Les sous-titres WebVTT peuvent etre envoyes si un sous-titre externe ou une piste exportable existe comme fichier.

Chromecast n'est pas LAN Watch: LAN Watch est QR/browser, Chromecast est une lecture cast directe. Les sous-titres embedded MKV doivent d'abord etre exportes ou charges comme SRT si tu veux les caster de facon fiable.

28. Family filter

Family filter: off/on est un filtre famille leger. Quand il est actif, VoxFrame essaie d'adoucir ou masquer les gros mots dans les live captions et les sous-titres AI/traduits.

Le filtre est optionnel et n'est pas un controle parental strict. Il travaille sur le texte de sous-titre/caption et ne peut pas retirer une parole incrustee dans la video ou l'audio.

29. Arrêter les tâches AI/STT/live

Quand AI, STT, traduction ou live transcript tourne, le player affiche Stop current task. Clique dessus pour annuler la tache en cours.

Si un overlay live caption est actif, l'arret efface l'overlay et stoppe l'etat de session live.

30. Ouvrir et fermer Settings

Ouvre Settings depuis le menu du player.

La fenetre Settings est un overlay dans l'app. Ferme-la avec le bouton de fermeture ou Esc.

Les reglages sont sauvegardes de plusieurs facons:

• checkboxes immediatement apres changement;
• listes deroulantes immediatement apres changement;
• champs texte quand le champ perd le focus;
• choix de modeles STT locaux immediatement apres changement.

Le cote gauche contient:

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

31. Settings > Account

Cet onglet gere activation de licence, statut compte, achats, telechargements et usage Premium Cloud.

License

Champs et boutons:

• Status: montre Demo, Trial, Licensed, Expired ou Pending.
• Activation key: champ pour une cle d'activation VoxFrame.
• Account e-mail: adresse e-mail de compte optionnelle.
• Server: montre la base API utilisee par l'app.
• Device: montre le statut de l'appareil.
• Activate: active la cle saisie sur cet appareil.
• Refresh license: actualise le statut de licence en ligne.
• Log out: efface les donnees locales du compte et essaie de desactiver l'appareil cote serveur.

L'app stocke le license token localement via le credential store. Ne partage pas de logs ou captures contenant des cles d'activation.

Purchase

La section achat montre l'etat Stripe et les plans disponibles.

Premium options

Cartes de plan:

• Player License
• Cloud Plus
• Cloud Pro

Pour Player License, Acheter Player ouvre Stripe checkout directement si l'app dispose d'un license token ou d'un e-mail de compte. Si les deux manquent, l'app demande d'abord l'e-mail de compte.

La licence Player coute 24,95 EUR une seule fois. Apres confirmation du paiement, la meme Demo installee passe automatiquement a Player Pro. Aucun player Pro separe n'est installe. Les donnees de licence sont egalement envoyees a l'e-mail du compte pour recuperation ou reinstallation.

Pour les plans cloud, l'app demande d'abord le type de paiement:

• Monthly
• One-time
• Yearly

Pour Cloud Plus/Pro, Stripe ne s'ouvre qu'apres ce choix. Un achat Cloud direct admissible deverrouille aussi Player Pro automatiquement; il n'est pas necessaire d'acheter Player separement au prealable. Le droit Cloud reste distinct du droit Player Pro permanent. One-time est un pass Cloud de 30 jours. Yearly one-time dure 365 jours avec une reinitialisation mensuelle plafonnee.

Récupérer un achat

Retrieve purchase verifie si un paiement Stripe termine est pret a etre lie a l'app.

Utilise-le apres le retour depuis la page de succes Stripe ou quand le navigateur t'a renvoye vers l'app.

Downloads

Boutons:

• Check release: demande au serveur si une release est disponible pour ce compte.
• Download release: telecharge une release autorisee quand disponible et verifie la checksum si possible.

Ces boutons dependent de la licence et fonctionnent seulement quand le serveur propose une release pour ce compte.

Premium Cloud

Options et champs:

• Use VoxFrame Cloud for premium API usage: active les routes cloud quand l'entitlement l'autorise.
• Plan: montre le plan actuel.
• Credits/minutes: montre le solde local.
• Usage: montre le resume d'usage.
• Refresh usage: charge l'usage actuel.
• Manage account: essaie d'ouvrir le Stripe billing portal quand il est disponible pour cette licence. Si le serveur ne peut pas creer de portail Stripe, l'app ouvre la page de compte VoxFrame en fallback et affiche un statut sous le bouton.

Quand Cloud est active, les fonctions prises en charge utilisent la route VoxFrame Cloud au lieu de tes propres cles provider, tant que licence et token cloud sont valides.

32. Settings > Player

L'onglet Player contient comportement, langues preferees, style de sous-titre, glossary, seuil de match, cles provider et cache.

Player behavior

Reglages:

• App language: langue de l'interface. Choix: English, Nederlands, Deutsch, Francais.
• Automatically search: cherche automatiquement des sous-titres quand possible.
• Auto-pick best subtitle: charge automatiquement le meilleur sous-titre.
• Create SRT when no match exists: genere un sous-titre quand aucun bon match n'existe.
• Auto-translate: traduit automatiquement quand le workflow le permet.
• Preferred languages: codes langue separes par virgules pour la recherche, par exemple nl,en.
• Subtitle style: preset de style pour formatage de sous-titres.
• Glossary / name lock: mots ou traductions qui doivent rester stables.
• Min. match: confiance minimale pour selection automatique.

Subtitle style

Choix de style:

• Balanced
• Compact
• Reading
• Large

Glossary / name lock

Utilise une regle par ligne:

• un nom a conserver, par exemple VoxFrame
• ou une traduction fixe, par exemple The Order = De Orde

Le glossary peut etre utilise pendant traduction et review qualite.

33. Settings > Player > Providers

La section provider contient cles API et donnees de connexion.

Champs:

• OpenAI API key: ta propre cle OpenAI. Laisse vide pour conserver une cle sauvegardee.
• OpenAI text model: modele pour traduction/selection texte.
• Load models: actualise les choix de modeles.
• OpenAI transcription: choix du modele de transcription.
• OpenSubtitles key: cle API OpenSubtitles.
• OpenSubtitles login: nom d'utilisateur.
• Password: mot de passe OpenSubtitles. Laisse vide pour conserver le mot de passe stocke.

Boutons:

• Save keys: sauvegarde les reglages provider saisis.
• Clear keys: supprime les cles provider sauvegardees.
• Test OpenSubtitles: valide identifiants et cle API OpenSubtitles.

Quand Use VoxFrame Cloud est actif et que ton compte autorise la route cloud, l'app utilise VoxFrame Cloud pour les actions prises en charge. Les cles provider restent utiles pour les routes locales ou propres cles.

34. Settings > Player > Cache

La section cache montre le dossier de cache sous-titres. Clear cache supprime le dossier cache et le recrée.

Utilise ceci quand:

• tu veux nettoyer anciens telechargements ou sous-titres generes;
• tu veux tester si un workflow telecharge/genere vraiment de nouveau;
• le cache peut contenir des fichiers corrompus ou obsoletes.

35. Settings > Subtitle Tools

Cet onglet controle repair, translation review, qualite live translate et comportement batch.

Repair mode

Choix:

• Safe: repair minimal. Pas de reference ASR, pas d'insertion de parole manquante et pas de choix de chargement automatique.
• Standard: comportement VoxFrame par defaut. Repare texte/timing, utilise ASR quand disponible, ecrit .quality-fixed.srt et demande avant chargement.
• Aggressive: plus strict. Utilise des seuils plus durs, coupe plus tot et utilise aide ASR si disponible. Auto-load reste desactive pour verifier le rapport d'abord.

Checkboxes repair

• Use local STT reference: cree une reference STT locale si possible.
• Insert missing speech: peut inserer des cues ASR manquants quand repair le permet.
• Report only: cree seulement un rapport et n'ecrit pas de sous-titre repare.
• Ask before loading repaired subtitle: demande avant de charger le sous-titre repare.
• Never overwrite original: le sous-titre original n'est jamais ecrase.
• Always save report: un rapport est toujours sauvegarde.

Les deux derniers reglages de securite sont forces par l'app.

Translation review

Reglages:

• Live quality: choix qualite/latence pour live translate.
• Use glossary / name lock: utilise le glossary pendant traduction.
• Use scene context: utilise le contexte voisin pendant la traduction normale.
• Suggest glossary candidates: permet aux quality reports de proposer des candidats glossary.
• Quality report after translation: cree automatiquement un quality report apres traduction.
• Review suspicious cues: marque les cues suspects pour review.
• Auto-load preferred batch result: charge automatiquement la sortie de la langue cible choisie apres batch.
• Fast fallback model for live translate: utilise un modele fallback plus rapide quand live translate risque de prendre du retard.

Live translate quality

Choix:

• Fast: modele live le plus rapide d'abord. Utile quand les captions doivent surtout continuer.
• Balanced: defaut. Utilise gpt-5.4-mini d'abord et gpt-5.4-nano comme fallback rapide si live translate risque de prendre du retard.
• Better: reste sur le meilleur modele live et desactive le fallback rapide. A utiliser quand qualite compte plus que latence.

Reset subtitle tools

Reset subtitle tools remet cet onglet aux valeurs par defaut:

• repair mode Standard;
• reference STT activee;
• insertion de parole manquante activee;
• report-only desactive;
• ask before loading active;
• glossary/name lock actif;
• scene context actif;
• suggestions glossary actives;
• quality report automatique desactive;
• suspicious cue review desactive;
• batch preferred output auto-load actif;
• live quality Balanced;
• fallback rapide pour live translate actif.

36. Settings > Speech to Text

Cet onglet gere les moteurs STT locaux et les modeles.

Fast local engine

Le moteur local rapide est Purfview Faster-Whisper.

Champs et boutons:

• Engine: montre le moteur et sa disponibilite.
• Install fast engine: telecharge et installe le moteur.
• Fast model: choisit le modele.
• Install selected fast model: telecharge le modele choisi.
• Source language: choisit langue ou auto-detection.
• Device: choisit Auto / CUDA if possible, CUDA ou CPU.
• Compute: choisit Auto, float16, int8_float16, int8 ou float32.
• Purfview args: arguments supplementaires pour usage avance.

Choix fast model:

• 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

Par defaut l'app essaie de choisir large-v3-turbo quand il est disponible.

Choix source language:

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

La ligne hardware advice verifie si CUDA est disponible. Si device et compute sont sur Auto, l'app peut appliquer le conseil automatiquement.

Fallback engine

Le moteur fallback est Whisper.cpp.

Champs et boutons:

• Engine: montre Whisper.cpp et son statut.
• Install fallback engine: telecharge le moteur fallback.
• .bin model: choisit le modele fallback.
• Install selected .bin: telecharge le modele .bin choisi.

Choix fallback model:

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

Par defaut l'app essaie de choisir large-v3-turbo-q5_0 quand disponible.

Statut et progression

En bas de l'overlay Settings, l'app montre statut et progression de telechargement. Pendant les telechargements, les boutons sont temporairement desactives. Ensuite, les choix de modeles et labels de disponibilite sont recharges.

37. Settings > About

L'onglet About contient version, createur, mises a jour, aide et diagnostics.

Elements:

• Version: montre la version de l'app.
• Maker: montre William Baars / VoxFrame.
• Updates: statut de verification des mises a jour.
• Check for updates: verifie via compte/licence si une release est disponible.
• Account: ouvre la page compte en ligne.
• Website: ouvre le site.
• Help: ouvre l'aide en ligne.
• Credits: montre les technologies utilisees.
• Open logs: ouvre le dossier logs pour support/diagnostic.
• Export safe support log: cree dans Downloads une copie de support nettoyee une seconde fois.
• Delete logs: supprime les fichiers de diagnostic actuels et archives.

Le bouton help ouvre l'aide en ligne pour que les guides puissent etre mis a jour sans nouveau build de l'app.

38. Logs et diagnostics

Utilise Settings > About > Open logs pour examiner toi-meme le dossier. Pour envoyer un diagnostic au support, prefere Export safe support log: il cree un fichier texte distinct et nettoye dans Downloads. Delete logs efface le log actuel ainsi que les logs issus de la rotation.

Les logs aident au diagnostic: ouverture video, chargement sous-titre, OpenSubtitles, hash, nom de release, confidence, rate-limits, traduction, STT, quality check, live transcript, LAN Watch, buffer HLS local, Chromecast/Google TV/DLNA discovery, compte, licence et routes cloud.

Le logging normal ne contient pas le texte des captions, les URL distantes completes, les chemins locaux absolus, les cles provider, les tokens de licence/acces ou les donnees de paiement. Les adresses distantes sont reduites aux informations de diagnostic sures; l'export de support nettoie encore une fois tous les fichiers collectes, y compris les anciennes lignes.

La taille des logs est bornee. runtime.log effectue une rotation vers 2 MB, conserve au maximum trois anciens fichiers et supprime automatiquement le plus ancien.

Si quelque chose ne fonctionne pas, note video ou chaine IPTV, langue parlee, langue cible, local/IPTV/LAN Watch/Chromecast, sous-titre actif, message d'erreur exact, cloud ou cles provider personnelles et action cliquee.

39. Workflows frequents

Regarder un film local avec le meilleur sous-titre

1. Ouvre le film avec Open video.
2. Choisis la langue cible dans le hub CC/subtitle.
3. Choisis Smart Subtitle Assistant.
4. VoxFrame verifie embedded/local, cherche OpenSubtitles, traduit depuis l'anglais si necessaire et genere seulement en dernier recours.
5. Verifie l'info source/confidence.

Changer de langue pendant un film

1. Choisis la nouvelle langue cible.
2. VoxFrame verifie les pistes embedded et fichiers SRT/VTT locaux.
3. Si rien ne correspond, confirme la recherche.
4. VoxFrame cherche OpenSubtitles et traduit depuis l'anglais si necessaire.

Regarder IPTV via LAN Watch

1. Lance IPTV et verifie que la chaine joue.
2. Lance live captions si tu veux des sous-titres dans le player LAN web.
3. Choisis LAN Watch / QR web-player.
4. Scanne le QR code ou clique le lien dessous.
5. Attends-toi a environ 15 secondes de delai live.
6. Arrete LAN Watch quand tu veux revenir au player local.

Utiliser Chromecast

1. Assure-toi que Chromecast, Google TV ou TV DLNA est sur le meme reseau.
2. Ouvre video ou IPTV.
3. Charge un sous-titre externe si tu veux caster des sous-titres.
4. Ouvre Chromecast / Cast et choisis l'appareil cible.

40. Depannage

OpenSubtitles ne trouve rien

Verifie titre, annee, nom de release et langue cible. Si aucun resultat cible n'est assez bon, cherche ou autorise une source anglaise puis traduis-la.

OpenSubtitles affiche HTTP 429 ou API rate limit exceeded

La limite OpenSubtitles est atteinte. Attends, reessaie plus tard ou traduis depuis un sous-titre anglais disponible.

La traduction reste en anglais

Verifie le chip de langue et le hub CC/subtitle. Si source et cible sont la meme langue reconnue, VoxFrame saute la traduction. Sinon, charge la source anglaise et lance Translate vers la langue choisie.

Pas de sous-titres dans LAN Watch

LAN Watch peut envoyer les SRT/VTT externes normaux. Les sous-titres embedded MKV doivent d'abord etre exportes et charges. Pour IPTV, les live captions doivent etre actives avant LAN Watch.

Chromecast n'apparait pas ou ne demarre pas

Verifie que Chromecast/Google TV est allume, sur le meme reseau et que mDNS/SSDP n'est pas bloque. Teste LAN Watch / QR web-player comme fallback.

41. Glossaire

• Smart Subtitle Assistant: flow qui cherche d'abord des sous-titres humains, puis traduit ou genere seulement si necessaire.
• OpenSubtitles-first: chercher d'abord des sous-titres humains; AI en fallback.
• LAN Watch: player QR/browser local via HLS sur le meme reseau Wi-Fi/LAN.
• HLS: format streaming avec petits segments et playlist.
• Chromecast / Google Cast: protocole cast pour Chromecast et Google TV.
• DLNA: protocole reseau local pour certaines TV et media renderers.
• Family filter: filtre leger optionnel pour profanity dans captions/subtitles.
• Confidence: indication de fiabilite d'une source ou d'un match.