Guide utilisateur détaillé

1. À quoi sert ce guide

Ce guide explique VoxFrame Subtitle Player du début à la fin. Il suit l'interface actuelle: écran principal, contrôles 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 réglages.

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

Nouveautés de la version 1.0.4

• Fichier > Historique mémorise jusqu'à cinq vidéos locales et chaînes IPTV ouvertes récemment. Cette liste peut être effacée manuellement.
• Le style d'affichage SRT choisi est conservé. Pour les captions IPTV, il est possible de choisir un fond sombre ou un fond transparent avec un contour sombre.
• Si un fournisseur IPTV cesse temporairement de fournir le média, VoxFrame maintient la session de buffer limitée, affiche un message d'interruption du fournisseur dans la langue d'interface choisie et se reconnecte automatiquement. Les segments d'interruption ne sont pas transcrits. Après la reprise, le média et les sous-titres live continuent sur la même timeline du buffer.
• Après Stop LAN Watch, le player local reprend à la position distante correspondante. Cast utilise environ quarante secondes de réserve initiale pour IPTV, n'affiche la bannière de transfert que pendant la session Cast et reprend la lecture PC bufferisée à la position correspondante après Stop Cast.
• La fermeture du player supprime les buffers temporaires LAN, Cast et HLS. L'historique Fichier séparé reste conservé jusqu'à son effacement manuel.
• Les pistes de sous-titres PGS/image sont détectées avant le traitement du texte. VoxFrame explique qu'il ne s'agit pas de sous-titres texte au lieu de tenter silencieusement de les traduire ou de les exporter. L'updater vérifie aussi plus strictement les installateurs et affiche plus clairement la progression et le résultat.

2. Démarrer l'app

Démarre VoxFrame Subtitle Player avec le raccourci fourni ou la commande de lancement. Après le démarrage, tu vois l'écran vide du player avec le titre VoxFrame Subtitle Player et le bouton Open video.

Quand aucune vidéo n'est encore chargée, tu peux commencer de trois façons:

1. Clique sur Open video dans l'écran vide.
2. Clique sur Open video dans le menu du player.
3. Glisse un fichier vidéo dans la fenêtre.

L'app accepte actuellement les vidéos 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'écran principal donne la priorité à la vidéo. La vidéo est centrale; les contrôles apparaissent en overlay. Pendant le visionnage, les contrôles disparaissent automatiquement après quelques secondes. Bouge la souris, clique ou touche la fenêtre pour les afficher de nouveau.

La barre du haut montre le nom de la vidéo 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 contrôles en bas sont:

• Progress slider: glisser sur la timeline pour se déplacer dans une vidéo locale.
• Play/Pause: démarre ou met en pause.
• Stop: arrête la lecture et ferme la vidéo 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 durée totale.
• Subtitle status: montre le sous-titre actif ou No subtitles.
• Stop current task: apparaît pendant les tâches AI/STT/traduction.
• Volume: ouvre le menu volume.
• CC: ouvre le menu des pistes de sous-titres.
• Captions toggle: active ou désactive les captions.
• Speed: ouvre les choix de vitesse.
• Player menu: ouvre les actions principales.
• Fullscreen: active ou quitte le plein écran.

4. Raccourcis clavier

L'app prend en charge ces raccourcis quand une vidéo est chargée:

• Space: lecture/pause.
• Media Play/Pause: lecture/pause sur les claviers avec touches média.
• 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 écran.
• M: couper ou rétablir le son.
• C: activer ou désactiver les captions.
• Esc: ferme d'abord les menus ou réglages ouverts; en plein écran, revient à la fenêtre normale.
• Ctrl+O: ouvrir une vidéo.

Quand aucune vidéo n'est chargée, Ctrl+O fonctionne quand même. Les autres raccourcis attendent qu'un média soit ouvert.

5. Ouvrir une vidéo locale

Utilise Open video pour choisir une vidéo locale. Tu peux aussi glisser une vidéo dans la fenêtre. Quand la vidéo s'ouvre:

1. L'app affiche brièvement un statut de chargement.
2. Le moteur vidéo ouvre le fichier.
3. L'app vérifie si des réglages ont déjà été mémorisés pour cette vidéo.
4. S'il n'y a pas de mémoire vidéo et que la source est locale, l'app cherche un sous-titre sidecar à côté du fichier vidéo.

Les sous-titres sidecar sont détectés automatiquement quand:

• le sous-titre a le même nom de base que la vidéo, par exemple Movie.mkv et Movie.srt; ou
• il y a exactement un fichier sous-titre utilisable dans le même 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 mémorise plusieurs choix par vidéo. Quand tu rouvres la même vidéo, l'app restaure si possible:

• chemin du sous-titre chargé;
• délai de sous-titre;
• captions activées ou désactivées;
• langue de sous-titre choisie;
• langue cible de traduction;
• preset de style de sous-titre;
• texte glossary/name-lock;
• réglage 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 sauvegardés comme sous-titres restaurables normaux. Si un chemin live transcript vient du dossier live temporaire, il est ignoré lors de la réouverture.

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 vidéo.

Après chargement:

• le sous-titre devient visible si les captions sont activées;
• l'app essaie de détecter la langue depuis le nom de fichier ou les infos de piste;
• le délai de sous-titre revient à zéro;
• l'analyse de sync est recalculée;
• le choix est mémorisé dans la mémoire vidéo.

Si le fichier ne peut pas être lu, l'app signale que le sous-titre n'a pas pu être chargé.

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 génère seulement si nécessaire.
• Translate: ouvre les actions de traduction.
• Sync: lance Fast-STT-Sync si vidéo locale et sous-titre sont disponibles.
• Live: ouvre live transcript/translate pour IPTV/live streams.
• Language: ouvre le choix de langue.

Le menu Translate avancé s'ouvre à côté de ce hub; le Subtitle Assistant reste visible. Retour ou Esc revient d'un niveau. X ferme les deux menus.

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

Délai de sous-titre

Les contrôles sont -0.5s et +0.5s. Utilise -0.5s si le texte arrive trop tard et +0.5s s'il arrive trop tôt. Pour les captions live, les mêmes boutons règlent le décalage live.

Position du sous-titre

La position de sous-titre déplace les sous-titres normaux plus haut ou plus bas. C'est utile si le texte recouvre les contrôles, les graphismes TV ou des captions incrustées.

9. Activer et désactiver les captions

Utilise le bouton captions ou appuie sur C. Désactiver les captions ne décharge pas le sous-titre:

• la lecture continue;
• les sous-titres chargés restent disponibles;
• seul l'affichage est masqué;
• le choix est mémorisé par vidéo.

Quand les captions sont réactivées, l'app montre la dernière piste choisie ou le dernier sous-titre chargé.

10. Volume

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

M coupe ou rétablit 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 à la session player actuelle.

12. Plein écran

Utilise le bouton plein écran ou appuie sur F. En plein écran, le player cache le chrome de fenêtre normal et garde la vidéo au centre.

Appuie de nouveau sur Esc ou F pour revenir à la fenêtre normale.

13. Le menu du player

Le menu du player est regroupé en modes clairs, pour éviter 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 autorisé par le compte, les actions prises en charge passent par la route cloud au lieu de tes propres clés 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 recommandée pour les films et séries. Un clic tente toute la chaîne sous-titre dans le bon ordre.

L'ordre est human-first:

1. VoxFrame cherche sur OpenSubtitles un sous-titre humain dans la langue cible.
2. S'il manque, VoxFrame cherche un sous-titre humain anglais. Tu choisis de le traduire ou de le conserver comme sous-titre anglais.
3. Si OpenSubtitles ne fournit rien d'utilisable, VoxFrame vérifie les pistes locales et embedded. Une piste embedded sans label de langue peut être traduite vers la langue cible avec détection automatique de la langue source.
4. Seulement si aucune source humaine ou embedded utilisable n'existe et si la génération est autorisée, VoxFrame crée un sous-titre depuis l'audio.
5. Quand c'est possible, une étape sync ou quality suit pour mieux adapter le sous-titre à la vidéo.

Pendant recherche, téléchargement, traduction ou génération, l'UI affiche le statut, une durée 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 mémoire vidéo.

Si tu changes de langue pendant un film local, VoxFrame vérifie 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 nécessaire.

Pour IPTV/live translate, la nouvelle langue est envoyée 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 première étape en ligne pour les vidéos locales, avant la génération AI.

Avec Player Pro seul, cette fonction utilise ta propre clé API OpenSubtitles et ton compte facultatif configuré dans Settings > Player > Providers. Seul un droit Cloud Plus/Cloud Pro actif peut utiliser le proxy VoxFrame Cloud mesuré avec la clé serveur de VoxFrame. Ces identifiants serveur ne sont jamais livrés au player.

Workflow typique:

1. L'app crée une identité vidéo avec hash, taille, titre, année et nom de release quand possible.
2. L'app cherche sur OpenSubtitles dans la langue cible.
3. Les candidats sont notés avec hash, nom de release et qualité de match.
4. Le meilleur résultat est chargé si la confidence est suffisante.
5. La source apparaît dans le statut, par exemple OpenSubtitles match.

Si aucun résultat cible n'est assez bon, VoxFrame cherche d'abord un sous-titre humain anglais comme source. S'il est trouvé, VoxFrame demande si tu veux le traduire vers la langue choisie. Si tu ne choisis pas la traduction, le sous-titre anglais reste chargé.

Si OpenSubtitles ne fournit rien d'utilisable, l'app peut selon les réglages:

• trouver un sous-titre humain anglais et le traduire vers la langue cible;
• utiliser un sous-titre local ou embedded;
• traduire une piste embedded sans label de langue fiable avec détection automatique de la langue source;
• seulement ensuite générer un sous-titre depuis l'audio.

Si OpenSubtitles est temporairement surchargé ou indisponible, VoxFrame attend brièvement et réessaie automatiquement un nombre limité de fois. Un deuxième clic manuel ne devrait pas être nécessaire. Le player affiche un message clair de disponibilité du fournisseur au lieu de détails techniques de limite. Si OpenSubtitles reste indisponible, le flux continue avec un sous-titre anglais, local ou embedded, puis seulement avec la génération AI.

Si Cloud expire, devient invalide ou est désactivé, le player n'a aucun accès à la clé serveur de VoxFrame. Utilise tes propres identifiants ou renouvelle Cloud.

17. Générer des AI subtitles

Generate AI subtitles est le fallback quand une vidéo locale n'a pas de sous-titre humain utilisable. Dans Smart Subtitle Assistant, cette route arrive seulement après 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 déjà, VoxFrame doit le traduire au lieu de transcrire.

18. Traduire des sous-titres

Translate traduit le sous-titre chargé ou la meilleure source trouvée vers la langue cible. Pour un film local, la source préférée est un sous-titre humain anglais quand aucun bon sous-titre cible n'existe.

Le menu Translate avancé s'ouvre à côté du Subtitle Assistant; le menu principal reste visible. Retour et Esc reviennent à l'Assistant, tandis que X ferme les menus.

Sources possibles: SRT/VTT externe, piste embedded exportable, résultat OpenSubtitles anglais ou live transcript. Si source et cible sont la même langue, VoxFrame saute la traduction.

Translate only et Translate + sync

Translate only écrit la traduction dans un nouveau fichier puis le charge. Translate + sync tente ensuite une sync assistée par ASR avec la STT locale rapide. Si la sync n'est pas disponible ou échoue, la traduction reste disponible et VoxFrame indique honnêtement que la sync n'a pas été appliquée. Un résultat n'est annoncé comme synchronisé que si cette étape réussit vraiment.

La sortie contient le code langue dans le nom de fichier, par exemple .ro.srt, pour reconnaître la version plus tard. Les SRT terminés reçoivent la ligne Subs by VoxFramePlayer. pour début/fin.

Batch translate all

Batch translate all reste limité à NL, EN, DE, FR, ES et IT. VoxFrame demande confirmation avant de commencer. Si certaines langues échouent, tous les fichiers créés avec succès restent conservés; le résultat indique les langues non terminées.

Translation quality check

Translation quality check compare source et traduction du dernier contexte de traduction. Après le rapport, un écran de résultat permet d'ouvrir directement le rapport ou son dossier.

Export bilingual review

Export bilingual review écrit des fichiers HTML et CSV avec source et traduction côte à côte. L'écran de résultat permet d'ouvrir la review ou le dossier de sortie.

Auto split/merge

Auto split/merge restructure vraiment les cues: il peut séparer les cues longs et fusionner des cues courts consécutifs adaptés. Le nombre de cues, la répartition du texte et les limites de timing peuvent donc changer. Le résultat est écrit dans un nouveau fichier; la source reste intacte.

19. Vérifier et améliorer les sous-titres

Le menu Tools contient deux actions volontairement différentes:

• Check subtitle analyse le sous-titre actuel et écrit seulement un rapport. Le sous-titre n'est pas modifié et aucun .quality-fixed.srt n'est créé.
• Improve subtitle applique les règles de repair choisies et écrit le résultat dans un nouveau .quality-fixed.srt. L'original n'est jamais écrasé.

Choisis d'abord Tools > Subtitle tool settings... pour régler le mode repair, la référence STT, la parole manquante, la suppression SDH et les listes de mots.

Workflow typique:

1. L'app vérifie qu'un sous-titre est chargé.
2. Selon les réglages, elle crée une référence STT locale.
3. Le service repair analyse erreurs, avertissements et points réparables.
4. L'app écrit toujours un rapport.
5. Seul Improve subtitle peut écrire un sous-titre réparé; il s'appelle .quality-fixed.srt.
6. La preview montre résumé et exemples avant que tu choisisses quoi faire.

La preview peut montrer:

• nombre d'erreurs/avertissements avant repair;
• nombre d'erreurs/avertissements après repair;
• nombre de changements, comme corrections texte, corrections timing, cues supprimées et parole manquante insérée;
• fichier de sortie;
• exemples compacts avant/après.

Actions de preview:

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

20. Sync with fast STT

Sync with fast STT essaie d'aligner le sous-titre chargé avec une référence STT locale rapide.

Conditions:

• une vidéo locale est chargée;
• un sous-titre est chargé;
• le moteur STT local rapide et le modèle choisi sont disponibles.

Cette action n'est pas une traduction. Elle analyse le timing de la parole et écrit un sous-titre synchronisé 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 vidéo actuelle. L'app utilise ffmpeg pour créer un fragment audio de benchmark puis lance les réglages Purfview/Faster-Whisper choisis.

Le résultat est sauvegardé comme dernier statut fast STT et visible dans Settings > Speech to Text.

22. Exporter des sous-titres

Export subtitle sauvegarde le sous-titre actuellement chargé 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 vidéo locale avec pistes embedded, tu peux exporter une piste en SRT:

1. Ouvre la vidéo.
2. Ouvre le menu CC.
3. Choisis la piste embedded à 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.

Pendant la conversion ASS/SSA vers SRT, VoxFrame supprime seulement les wrappers <font ...> propres au format. Une taille ASS comme 71 ne peut donc pas devenir une taille SRT absolue qui remplit l'écran. Le texte en italique, gras et souligné avec <i>, <b> et <u> reste intact; la taille visible suit ensuite le réglage normal des sous-titres VoxFrame.

L'app utilise l'extension source comme extension proposée. S'il n'y a pas de sous-titre normal chargé 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 sauvegardées par ce bouton d'export normal.

23. Ouvrir une playlist IPTV

Choisis Open IPTV playlist dans le menu du player.

L'app ouvre la fenêtre 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.

Après 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 chaînes. Tu peux:

• chercher par nom de chaîne, groupe, tvg-id ou URL;
• revenir à 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 prévu pour IPTV ou autres live streams. L'app lit l'audio en continu, crée des segments texte et les affiche comme captions. Si live translate est actif, le texte est traduit vers la langue cible.

La fenêtre 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 synchronisé utilisé pour un stream distant;
• Live subtitle delay: ajoute un délai d'affichage supplémentaire;
• Target language: choisit la langue cible quand la traduction est active.

Les profils actuellement visibles sont:

• LocalBest: qualité locale recommandée. L'audio reste sur ce PC et le profil utilise la meilleure configuration live locale validée;
• LocalLight: configuration locale plus légère pour un PC/GPU moins puissant. Elle utilise les réglages vocaux locaux actuels; choisis au besoin un modèle plus petit dans Settings > Speech to Text;
• DirectOpenAi: utilise ta propre clé API OpenAI enregistrée pour une transcription live directe avec horodatage des mots. OpenAI te facture cet usage; aucun crédit VoxFrame Cloud n'est utilisé;
• CloudStable: qualité cloud recommandée, avec des blocs audio de 10 secondes traités par le proxy VoxFrame Cloud;
• CloudFilmSpeakers: blocs de 12 secondes pour davantage de contexte de dialogue. Malgré son nom, ce profil **n'identifie, ne nomme et ne marque pas** les intervenants.

DirectOpenAi apparaît seulement quand VoxFrame Cloud est désactivé et qu'une clé API OpenAI personnelle est enregistrée. Les profils cloud sont visibles seulement si le compte autorise VoxFrame Cloud. Chaque bloc audio est alors envoyé par HTTPS à VoxFrame et traité par OpenAI derrière le proxy VoxFrame. L'app ne reçoit pas de credentials provider pour ce workflow: le traitement reste derrière le proxy VoxFrame. La consommation audio est comptée seulement après une transcription réussie; la traduction live est facturée séparément.

Pour un stream distant, la lecture synchronisée reste normalement environ 30 secondes derrière 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 éventuelle. Ce sont des profils bufferisés orientés qualité, pas des captions sans délai.

Choisis la langue parlée explicitement quand tu la connais: la reconnaissance est en général plus prévisible. Detection automatique reste disponible si la langue source est inconnue. Langue parlée 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 disparaît ou si la chaîne ne fournit pas de parole utilisable, la chaîne live continue à attendre et bufferiser. Le rattrapage est borné: si le traitement dépasse trop la fenêtre de lecture, VoxFrame peut sauter proprement un bloc audio déjà trop tardif au lieu de laisser le délai et la mémoire augmenter sans limite. Cela peut créer un court trou dans les captions sur un PC surchargé ou une connexion instable.

Le statut indique l'état du workflow:

• Listening: la session fonctionne et attend une parole exploitable;
• No speech yet: des blocs ont été vérifiés sans parole claire; ce n'est pas automatiquement une erreur;
• Degraded: une partie du workflow est temporairement limitée; les captions source restent actives si la traduction ne suit pas;
• Reconnecting: VoxFrame effectue une tentative de reconnexion bornée;
• Failed: le workflow live s'est arrêté à cause d'un problème technique.

Si tu changes de langue cible, la nouvelle langue est utilisée pour les nouveaux blocs sans redémarrer le stream. Les captions déjà affichées ne changent pas.

26. LAN Watch / QR web-player

LAN Watch / QR web-player crée un player navigateur local pour téléphone, tablette, laptop, navigateur Smart TV ou autre appareil sur le même Wi-Fi/LAN. VoxFrame affiche un QR code et, dessous, un petit lien cliquable. L'URL est aussi copiée dans le presse-papiers.

Pour les films locaux, LAN Watch démarre à la position actuelle. Les sous-titres externes SRT/VTT normaux peuvent être envoyés 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 crée un buffer live HLS séparé avec environ 15 secondes de délai et des segments d'environ 5 secondes. La pause dans le web-player n'arrête pas le buffer serveur; il continue à se remplir. Dans la durée disponible, tu peux revenir en arrière et continuer depuis cette position.

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

27. Chromecast / Cast

Chromecast / Cast ouvre le menu cast. VoxFrame cherche sur le même réseau les Chromecast, Google TV et renderers DLNA. Le PC et l'appareil cast doivent être 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 être envoyés 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 être exportés ou chargés comme SRT si tu veux les caster de façon fiable.

28. Family filter

Family filter: off/on est un filtre famille léger. 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 contrôle parental strict. Il travaille sur le texte de sous-titre/caption et ne peut pas retirer une parole incrustée dans la vidéo 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 tâche en cours.

Si un overlay live caption est actif, l'arrêt efface l'overlay et stoppe l'état de session live.

30. Ouvrir et fermer Settings

Ouvre Settings depuis le menu du player.

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

Les réglages sont sauvegardés de plusieurs façons:

• checkboxes immédiatement après changement;
• listes déroulantes immédiatement après changement;
• champs texte quand le champ perd le focus;
• choix de modèles STT locaux immédiatement après changement.

Le côté gauche contient:

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

31. Settings > Account

Cet onglet gère activation de licence, statut compte, achats, téléchargements et usage Premium Cloud.

License

Champs et boutons:

• Status: montre l'état actuel de la licence, par exemple active, expirée ou en attente.
• Activation key: champ pour une clé d'activation VoxFrame.
• Account e-mail: adresse e-mail de compte optionnelle.
• Server: montre la base API utilisée par l'app.
• Device: montre le statut de l'appareil.
• Activate: active la clé saisie sur cet appareil.
• Refresh license: actualise le statut de licence en ligne.
• Log out: efface les données locales du compte et essaie de désactiver l'appareil côté serveur.

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

Purchase

La section achat montre l'état 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 a un prix de base unique de 24,95 EUR hors TVA. Les prix des plans Cloud sont également hors TVA. Stripe affiche le total final TVA applicable comprise avant le paiement. Après confirmation du paiement, le même player installé est automatiquement activé en Player Pro. Aucun player Pro séparé n'est installé. Les données de licence sont également envoyées à l'e-mail du compte pour récupération ou réinstallation.

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'après ce choix. Un achat Cloud direct admissible déverrouille aussi Player Pro automatiquement; il n'est pas nécessaire d'acheter Player séparément au préalable. 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 réinitialisation mensuelle plafonnée.

Récupérer un achat

Retrieve purchase vérifie si un paiement Stripe terminé est prêt à être lié à l'app.

Utilise-le après le retour depuis la page de succès Stripe ou quand le navigateur t'a renvoyé vers l'app.

Mises à jour

Boutons:

• Verifier les mises a jour: demande au serveur si une mise à jour est disponible pour ce compte.
• Telecharger la mise a jour: télécharge une mise à jour autorisée quand disponible et vérifie la checksum et la signature Windows.

Ces boutons de mise à jour dans le player nécessitent une licence active et fonctionnent seulement quand le serveur propose une mise à jour pour ce compte. L'installateur public signé reste disponible sur la page officielle sans connexion; l'achat et l'activation ont lieu ensuite dans ce player installé.

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 résumé 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 créer de portail Stripe, l'app ouvre la page de compte VoxFrame en fallback et affiche un statut sous le bouton.

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

32. Settings > Player

L'onglet Player contient comportement, langues préférées, style de sous-titre, glossary, seuil de match, clés provider et cache.

Player behavior

Réglages:

• App language: langue de l'interface. Choix: English, Nederlands, Deutsch, Français.
• 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: génère un sous-titre quand aucun bon match n'existe.
• Auto-translate: traduit automatiquement quand le workflow le permet.
• Preferred languages: codes langue séparés 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 sélection automatique.

Subtitle style

Choix de style:

• Balanced
• Compact
• Reading
• Large

Glossary / name lock

Utilise une règle par ligne:

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

Le glossary peut être utilisé pendant traduction et review qualité.

33. Settings > Player > Providers

La section provider contient clés API et données de connexion.

Champs:

• OpenAI API key: ta propre clé OpenAI. Laisse vide pour conserver une clé sauvegardée.
• OpenAI text model: modèle pour traduction/sélection texte.
• Load models: actualise les choix de modèles.
• OpenAI transcription: choix du modèle de transcription.
• OpenSubtitles key: clé API OpenSubtitles.
• OpenSubtitles login: nom d'utilisateur.
• Password: mot de passe OpenSubtitles. Laisse vide pour conserver le mot de passe stocké.

Boutons:

• Save keys: sauvegarde les réglages provider saisis.
• Clear keys: supprime les clés provider sauvegardées.
• Test OpenSubtitles: valide ta propre clé API avec une recherche directe. Si le nom d'utilisateur et le mot de passe sont tous deux enregistrés, VoxFrame valide d'abord la connexion au compte, puis l'acceptation du token par la recherche.

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 clés provider restent utiles pour les routes locales ou propres clés.

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 téléchargements ou sous-titres générés;
• tu veux tester si un workflow télécharge/génère vraiment de nouveau;
• le cache peut contenir des fichiers corrompus ou obsolètes.

35. Settings > Subtitle Tools

Cet onglet contrôle repair, translation review, qualité live translate et comportement batch.

Repair mode

Choix:

• Safe: repair minimal. Pas de référence ASR, pas d'insertion de parole manquante et pas de choix de chargement automatique.
• Standard: comportement VoxFrame par défaut. Répare texte/timing, utilise ASR quand disponible, écrit .quality-fixed.srt et demande avant chargement.
• Aggressive: plus strict. Utilise des seuils plus durs, coupe plus tôt et utilise aide ASR si disponible. Auto-load reste désactivé pour vérifier le rapport d'abord.

Checkboxes repair

• Use local STT reference: crée une référence STT locale si possible.
• Insert missing speech: peut insérer des cues ASR manquants quand repair le permet.
• Report only: crée seulement un rapport et n'écrit pas de sous-titre réparé.
• Ask before loading repaired subtitle: demande avant de charger le sous-titre réparé.
• Never overwrite original: le sous-titre original n'est jamais écrasé.
• Always save report: un rapport est toujours sauvegardé.

Les deux derniers réglages de sécurité sont forcés par l'app.

Translation review

Réglages:

• Live quality: choix qualité/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: crée automatiquement un quality report après traduction.
• Review suspicious cues: marque les cues suspects pour review.
• Auto-load preferred batch result: charge automatiquement la sortie de la langue cible choisie après batch.
• Fast fallback model for live translate: utilise un modèle fallback plus rapide quand live translate risque de prendre du retard.

Live translate quality

Choix:

• Fast: modèle live le plus rapide d'abord. Utile quand les captions doivent surtout continuer.
• Balanced: défaut. 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 modèle live et désactive le fallback rapide. À utiliser quand qualité compte plus que latence.

Reset subtitle tools

Reset subtitle tools remet cet onglet aux valeurs par défaut:

• repair mode Standard;
• référence STT activée;
• insertion de parole manquante activée;
• report-only désactivé;
• ask before loading active;
• glossary/name lock actif;
• scene context actif;
• suggestions glossary actives;
• quality report automatique désactivé;
• suspicious cue review désactivée;
• batch preferred output auto-load actif;
• live quality Balanced;
• fallback rapide pour live translate actif.

36. Settings > Speech to Text

Cet onglet gère les moteurs STT locaux et les modèles.

Fast local engine

Le moteur local rapide est Purfview Faster-Whisper.

Champs et boutons:

• Engine: montre le moteur et sa disponibilité.
• Install fast engine: télécharge et installe le moteur.
• Fast model: choisit le modèle.
• Install selected fast model: télécharge le modèle choisi.
• Source language: choisit langue ou auto-détection.
• Device: choisit Auto / CUDA if possible, CUDA ou CPU.
• Compute: choisit Auto, float16, int8_float16, int8 ou float32.
• Purfview args: arguments supplémentaires pour usage avancé.

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 défaut 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 vérifie 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: télécharge le moteur fallback.
• .bin model: choisit le modèle fallback.
• Install selected .bin: télécharge le modèle .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 défaut 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 téléchargement. Pendant les téléchargements, les boutons sont temporairement désactivés. Ensuite, les choix de modèles et labels de disponibilité sont rechargés.

37. Settings > About

L'onglet About contient version, créateur, mises à jour, aide et diagnostics.

Éléments:

• Version: montre la version de l'app.
• Organisation: montre VoxFrame.
• Contact: ouvre un e-mail vers support@voxframeplayer.com.
• Updates: statut de vérification des mises à jour.
• Check for updates: vérifie 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 utilisées.
• Open logs: ouvre le dossier logs pour support/diagnostic.
• Export safe support log: crée dans Downloads une copie de support nettoyée 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 être mis à jour sans nouveau build de l'app.

38. Logs et diagnostics

Utilise Settings > About > Open logs pour examiner toi-même le dossier. Pour envoyer un diagnostic au support, préfère Export safe support log: il crée un fichier texte distinct et nettoyé dans Downloads. Delete logs efface le log actuel ainsi que les logs issus de la rotation.

Les logs aident au diagnostic: ouverture vidéo, chargement sous-titre, OpenSubtitles, hash, nom de release, confidence, disponibilité fournisseur, 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 complètes, les chemins locaux absolus, les clés provider, les tokens de licence/accès ou les données de paiement. Les adresses distantes sont réduites aux informations de diagnostic sûres; l'export de support nettoie encore une fois tous les fichiers collectés, y compris les anciennes lignes.

La taille des logs est bornée. 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 vidéo ou chaîne IPTV, langue parlée, langue cible, local/IPTV/LAN Watch/Chromecast, sous-titre actif, message d'erreur exact, cloud ou clés provider personnelles et action cliquée.

39. Workflows fréquents

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 vérifie embedded/local, cherche OpenSubtitles, traduit depuis l'anglais si nécessaire et génère seulement en dernier recours.
5. Vérifie l'info source/confidence.

Changer de langue pendant un film

1. Choisis la nouvelle langue cible.
2. VoxFrame vérifie 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 nécessaire.

Regarder IPTV via LAN Watch

1. Lance IPTV et vérifie que la chaîne 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 à environ 15 secondes de délai live.
6. Arrête LAN Watch quand tu veux revenir au player local.

Utiliser Chromecast

1. Assure-toi que Chromecast, Google TV ou TV DLNA est sur le même réseau.
2. Ouvre vidéo 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. Dépannage

OpenSubtitles ne trouve rien

Vérifie titre, année, nom de release et langue cible. Si aucun résultat cible n'est assez bon, cherche ou autorise une source anglaise puis traduis-la.

OpenSubtitles est temporairement surchargé

VoxFrame attend d'abord brièvement et réessaie automatiquement un nombre limité de fois sans afficher de limite technique de requêtes. Si ces essais échouent, le player vérifie les sous-titres anglais, locaux et embedded. Choisis Translate from English ou Translate embedded subtitle pour continuer, ou conserve la source trouvée sans traduction.

La traduction reste en anglais

Vérifie le chip de langue et le hub CC/subtitle. Si source et cible sont la même 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 être exportés et chargés. Pour IPTV, les live captions doivent être actives avant LAN Watch.

Chromecast n'apparaît pas ou ne démarre pas

Vérifie que Chromecast/Google TV est allumé, sur le même réseau et que mDNS/SSDP n'est pas bloqué. 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 génère seulement si nécessaire.
• OpenSubtitles-first: chercher d'abord des sous-titres humains; AI en fallback.
• LAN Watch: player QR/browser local via HLS sur le même réseau Wi-Fi/LAN.
• HLS: format streaming avec petits segments et playlist.
• Chromecast / Google Cast: protocole cast pour Chromecast et Google TV.
• DLNA: protocole réseau local pour certaines TV et media renderers.
• Family filter: filtre léger optionnel pour profanity dans captions/subtitles.
• Confidence: indication de fiabilité d'une source ou d'un match.