Depannage

« Local Transcriber ne peut pas etre ouvert »

C’est Gatekeeper de macOS. L’app est signee et notariee par Apple, mais Gatekeeper peut tout de meme afficher ce message au premier lancement.

Solution : Faites un clic droit sur l’app dans Applications → selectionnez Ouvrir → cliquez sur Ouvrir dans la boite de dialogue. Vous n’avez besoin de faire cela qu’une seule fois.

Aucun audio n’est capture

Si l’app commence a enregistrer mais qu’aucun texte n’apparait :

1. Verifiez l’autorisation du microphone. Allez dans Reglages du systeme → Confidentialite et securite → Microphone et assurez-vous que Local Transcriber est active.
2. Verifiez l’autorisation de reconnaissance vocale. Allez dans Reglages du systeme → Confidentialite et securite → Reconnaissance vocale et assurez-vous que Local Transcriber est active.
3. Redemarrez l’app apres avoir accorde les autorisations — macOS ne detecte parfois les changements d’autorisations qu’apres un redemarrage de l’app.
4. Verifiez votre sortie audio. L’app capture l’audio systeme depuis la sortie audio de votre Mac. Si vous acheminez l’audio via un peripherique externe que macOS ne reconnait pas comme sortie par defaut, la capture audio systeme peut ne pas fonctionner.

Un seul cote de l’appel est capture

Si vous voyez votre propre voix mais pas celle de l’autre personne (ou inversement) :

• Audio systeme (l’autre personne) provient de la sortie audio de votre Mac. Assurez-vous que l’audio de l’appel est diffuse via les haut-parleurs de votre Mac ou un casque connecte a votre Mac.
• Audio du microphone (votre voix) provient du microphone que votre Mac utilise. Verifiez dans Reglages du systeme → Son → Entree que le bon microphone est selectionne.

La transcription est imprecise

La reconnaissance vocale sur l’appareil est performante mais pas parfaite. Voici ce qui peut aider :

• Parlez clairement et evitez de marmonner.
• Reduisez le bruit de fond — fermez les fenetres, coupez les notifications.
• Utilisez un casque avec micro — cela fournit le signal audio le plus net.
• Attendez le post-traitement — la transcription en direct est un brouillon. Le post-traitement (qui s’execute automatiquement a l’arret) ameliore significativement la precision.

Le post-traitement semble bloque

Le post-traitement prend generalement de 10 a 30 secondes pour une reunion de 30 minutes. S’il semble bloque :

1. Verifiez l’etat. Regardez la barre laterale — elle affiche « Traitement en cours » avec un indicateur rotatif pendant le travail.
2. Verifiez le journal. Ouvrez le Terminal et executez :

   tail -f ~/.transcriber/engine.log

   Cela montre ce que l’app fait en temps reel.
3. La premiere execution est plus lente. La premiere fois que vous enregistrez, l’app telecharge les modeles vocaux (~50 Mo). Cela ne se produit qu’une seule fois.

Les modeles ne se chargent pas

Au premier lancement, l’app telecharge les modeles de reconnaissance vocale et de diarisation sur l’appareil. Cela necessite une connexion internet. Si les modeles ne se chargent pas :

1. Verifiez votre connexion internet — les modeles sont telecharges depuis les serveurs d’Apple.
2. Verifiez l’espace disque disponible — les modeles necessitent environ 200 Mo d’espace libre.
3. Redemarrez l’app — le telechargement sera relance au prochain lancement.

Une fois telecharges, les modeles sont mis en cache et l’app fonctionne entierement hors ligne.

L’app n’apparait pas dans la barre de menus

Local Transcriber affiche une icone de microphone dans la barre de menus de macOS. Si vous ne la voyez pas :

• Verifiez le debordement de la barre de menus. Si vous avez beaucoup d’elements dans la barre de menus, macOS peut en masquer certains. Cherchez un chevron > dans la barre de menus.
• Assurez-vous que l’app est en cours d’execution. Verifiez dans le Moniteur d’activite que « Local Transcriber » ou « Transcriber » apparait.

Le CLI ne fonctionne pas

Si la commande transcriber est introuvable apres l’installation :

1. Ouvrez une nouvelle fenetre de terminal — la mise a jour du PATH necessite une nouvelle session de shell.
2. Reinstallez — allez dans Transcriber → Installer le CLI et la competence d’agent… dans le menu de l’app.
3. Verifiez le lien symbolique — executez ls -la /usr/local/bin/transcriber pour verifier qu’il existe et pointe vers le bundle de l’app.

Besoin d’aide supplementaire ?

Consultez le journal du moteur pour des diagnostics detailles :

tail -100 ~/.transcriber/engine.log

Si vous rencontrez toujours des problemes, ouvrez un ticket sur GitHub avec la sortie de journal pertinente.