Aller au contenu
Petal

SolutionsMac8 min de lecture

VoiceInk ne transcrit pas : trouver la cause de l'échec

VoiceInk ne transcrit pas ? Vérifiez la capture du micro, puis le mode et le modèle, puis l'étape du collage, avec les diagnostics officiels de VoiceInk.

Publié par Optimal Apps, l’éditeur de Petal.

Sur cette page

Quand VoiceInk ne transcrit pas, l'échec se situe dans l'une de ces trois étapes : la capture du micro, l'étape du modèle ou l'étape du collage. Le guide officiel de VoiceInk, « Transcription Failing or No Output », les vérifie dans cet ordre. Vérifiez d'abord Micro et Accessibilité dans Réglages Système > Confidentialité et sécurité, puis redémarrez VoiceInk. Ouvrez ensuite Audio dans la barre latérale de VoiceInk et vérifiez l'entrée. Vérifiez enfin que le mode actif utilise un modèle de transcription valide, et que ce modèle est téléchargé dans AI Models. Si le texte apparaît dans VoiceInk mais pas dans votre app, le problème vient de l'étape du collage.

Liste de solutions rapides

Symptôme Étape en échec Solution
L'enregistreur n'affiche aucun niveau audio Capture Sélectionnez le micro dans Audio ; vérifiez Son > Entrée
Aucun résultat après un changement d'autorisation Capture Redémarrez VoiceInk
Le nouveau micro n'est pas dans la liste Capture Cliquez sur Refresh Microphones
Le mode ne donne aucun résultat Modèle Activez le mode et choisissez un modèle valide
Le modèle local ne donne rien Modèle Téléchargez-le dans AI Models ; vérifiez les fichiers .bin importés
Le modèle cloud échoue Modèle Vérifiez la clé d'API et le réseau
Le texte apparaît dans VoiceInk, pas dans votre app Collage Suivez le guide sur le collage
Le texte est faux, pas absent Modèle Essayez un autre modèle ; ajoutez du vocabulaire (Vocabulary)

Étape 1 : diagnostiquer en trois parties pourquoi VoiceInk ne transcrit pas

Faites un test avant de modifier les réglages.

  1. Ouvrez TextEdit et cliquez dans un nouveau document.
  2. Utilisez votre raccourci VoiceInk et dites une phrase claire.
  3. Regardez l'enregistreur pendant que vous parlez, puis cherchez le résultat dans l'historique de VoiceInk.

Situez ensuite l'échec :

  • Le niveau audio ne bouge pas. L'étape de capture échoue. Passez à l'étape 2.
  • Le niveau bouge, mais VoiceInk n'affiche aucun texte. L'étape du modèle échoue. Passez à l'étape 4.
  • VoiceInk affiche le texte, mais TextEdit reste vide. L'étape du collage échoue. Passez à l'étape 6.

Étape 2 : vérifier les autorisations

La documentation de VoiceInk liste trois autorisations :

  • Micro est obligatoire pour enregistrer.
  • Accessibilité est nécessaire pour un collage fiable et pour le contexte du texte sélectionné.
  • Enregistrement de l'écran n'est nécessaire que si un mode utilise le contexte de l'écran.
  1. Ouvrez Réglages Système > Confidentialité et sécurité > Micro et vérifiez que VoiceInk est activé.
  2. Ouvrez Réglages Système > Confidentialité et sécurité > Accessibilité et vérifiez que VoiceInk est activé.
  3. Redémarrez VoiceInk après chaque changement. La documentation de VoiceInk indique que cette étape est nécessaire.

Si vous avez compilé VoiceInk depuis le code source ou installé une nouvelle version, l'interrupteur peut rester activé et échouer quand même. macOS lie l'autorisation Accessibilité à la signature du code de l'app, et une nouvelle signature ne correspond plus à l'ancienne autorisation. Le ticket GitHub #530 de VoiceInk donne la solution : exécutez tccutil reset Accessibility com.prakashjoshipax.VoiceInk dans Terminal, rouvrez VoiceInk et accordez de nouveau l'autorisation Accessibilité.

Pour un guide général, lisez l'autorisation du micro sur Mac.

Étape 3 : vérifier l'entrée audio

  1. Dans la barre latérale de VoiceInk, ouvrez Audio.
  2. Utilisez Selected Microphone pour choisir un appareil. Vous pouvez aussi utiliser Priority Order pour que VoiceInk passe d'un appareil à l'autre quand l'un d'eux manque.
  3. Si vous venez de brancher un nouvel appareil, cliquez sur Refresh Microphones.
  4. Ouvrez Réglages Système > Son > Entrée, parlez et vérifiez que le niveau d'entrée bouge pour le même appareil.

Pourquoi ça marche : VoiceInk enregistre depuis l'appareil sélectionné dans l'app. Si cet appareil est débranché, en veille ou en sourdine, le modèle reçoit du silence et ne renvoie rien.

VoiceInk conseille le micro intégré du Mac ou un micro externe dédié plutôt que le micro d'un casque sans fil. Les casques Bluetooth passent souvent dans un mode de faible qualité pour le micro. Consultez la dictée avec un micro Bluetooth sur Mac.

Il existe aussi un signalement ouvert (ticket GitHub #916) où VoiceInk enregistrait un audio entièrement silencieux sur une configuration, et n'enregistrait correctement que si la dictée macOS tournait en même temps. Si votre indicateur de niveau bouge dans les réglages Son mais que VoiceInk enregistre du silence, mentionnez ce ticket dans votre signalement.

Étape 4 : vérifier le mode actif

Les modes définissent le modèle et la sortie que VoiceInk utilise. Un mode mal réglé est une cause fréquente d'absence de résultat.

  1. Ouvrez Modes dans la barre latérale.
  2. Vérifiez que le mode que vous utilisez est activé.
  3. Vérifiez qu'il utilise un modèle de transcription valide, et que le fournisseur ou le modèle local est disponible.
  4. Vérifiez que le réglage de langue correspond à votre langue parlée.
  5. Vérifiez le type de sortie : Paste insère le texte, Respond affiche une réponse dans l'enregistreur et Custom Command envoie le texte à votre commande. Avec Respond, aucun texte n'arrive dans votre app, et c'est voulu.

Étape 5 : réparer un modèle VoiceInk qui ne se charge pas

Ouvrez AI Models et vérifiez le modèle utilisé par le mode.

Modèles locaux

  • Vérifiez que le modèle est téléchargé.
  • Pour un fichier Whisper .bin importé, vérifiez que le fichier existe toujours et reste lisible. Si vous l'avez déplacé ou supprimé, importez-le de nouveau.
  • Les modèles en streaming uniquement exigent le mode Real-time. Les fichiers importés exigent un modèle qui prend en charge le traitement par lot.
  • Apple Speech nécessite macOS 26 ou une version ultérieure, avec la ressource de langue installée.
  • L'amélioration VoiceInk Refine exige une puce Apple, au moins 16 Go de RAM et un modèle Refine téléchargé.

Sur les Mac Intel, la documentation de VoiceInk indique que la transcription dans le cloud fonctionne en général mieux, car les modèles locaux y sont lents. Un modèle lent peut donner l'impression qu'il n'y a aucun résultat.

Fournisseurs cloud

  • Vérifiez que la clé d'API est définie et que le fournisseur prend en charge la transcription.
  • Pour un modèle personnalisé, vérifiez le chemin de l'endpoint, la clé d'API et le nom du modèle. VoiceInk précise que l'enregistrement du réglage ne teste pas la connexion : une faute de frappe n'échoue qu'au moment de la transcription.
  • Vérifiez le réseau. Dans le ticket GitHub #1010, un utilisateur sur un réseau d'entreprise voyait une erreur de transcription. La cause était un modèle cloud sélectionné par erreur. La solution a été de télécharger le modèle local et de le choisir dans les modes.

Étape 6 : isoler un problème de collage

Si VoiceInk affiche la transcription mais que votre app reste vide, la transcription fonctionne. C'est le collage qui échoue. Le guide de VoiceInk sur le presse-papiers donne ces étapes :

  1. Vérifiez que le mode utilise la sortie Paste.
  2. Cliquez dans le champ cible avant d'enregistrer.
  3. Vérifiez l'autorisation Accessibilité (étape 2).
  4. Ouvrez Settings > Pasting et passez Paste Method de Default à AppleScript.
  5. Si l'ancien contenu du presse-papiers est collé, augmentez le Restore Delay. Il est de 2 secondes par défaut, de 250 ms à 5 secondes.

Le guide complet se trouve dans VoiceInk ne colle pas le texte.

Étape 7 : si le texte est faux plutôt qu'absent

Si VoiceInk transcrit mais que le texte contient des erreurs :

  • Essayez un autre modèle dans le mode. La documentation de VoiceInk conseille Parakeet V3 pour une dictée locale rapide sur les Mac compatibles.
  • Ajoutez des corrections fixes dans Word Replacements et les noms importants dans Vocabulary.
  • Rapprochez-vous du micro et réduisez le bruit de fond.

Étape 8 : recueillir des diagnostics

Si aucune étape ne fonctionne, utilisez Diagnostics and Support dans VoiceInk pour recueillir les informations système ou exporter les journaux. Relisez les journaux avant de les partager, puis signalez le problème sur le GitHub de VoiceInk ou à son assistance.

Petal : une version signée et gratuite avec des modèles sur l'appareil

Le code source de VoiceInk est sous licence GPL v3, et vous pouvez le compiler vous-même gratuitement. La version signée et prête à l'emploi est vendue sous forme de licence à achat unique. Si vous voulez une version signée et prête à l'emploi sans payer, Petal pour Mac est une option. Il est gratuit et open source (MIT), et édité par Optimal Apps, l'éditeur de ce site. Le téléchargement sur GitHub Releases est signé avec un Developer ID et se met à jour par Sparkle : les autorisations macOS restent donc liées à la même signature d'une version à l'autre.

Voici comment Petal gère les trois mêmes étapes :

  • Capture. Choisissez l'appareil dans Settings > Recording > Microphone, ou gardez Default pour suivre le système.
  • Modèle. Téléchargez un modèle vocal dans Settings > Models. Parakeet 110M est le modèle léger recommandé pour l'anglais. Parakeet 0.6B V3 couvre 25 langues européennes, dont le français, Whisper Large V3 Turbo couvre 99 langues, et Apple Speech ne demande aucun téléchargement. Tous tournent sur votre Mac. Petal garde le besoin en RAM de son modèle par défaut sous 8 Go.
  • Collage. Petal colle le texte dans l'app au premier plan et restaure votre presse-papiers 700 ms plus tard : les apps Electron lentes reçoivent donc le bon texte. Si Accessibilité est désactivée, Petal copie la transcription à la place.

Chaque enregistrement et chaque transcription sont enregistrés dans l'historique, et Transcribe Again relance l'audio enregistré. Le nettoyage du texte avec Petal W1 tourne aussi sur votre Mac. Petal nécessite macOS 26.2 ou une version ultérieure.

Pour une comparaison détaillée, lisez Petal ou VoiceInk ou l'alternative à VoiceInk sur Mac.

En résumé

  1. Faites un test pour trouver l'étape qui échoue : capture, modèle ou collage.
  2. Vérifiez les autorisations Micro et Accessibilité, puis redémarrez VoiceInk.
  3. Après une nouvelle compilation, réinitialisez l'autorisation Accessibilité avec tccutil.
  4. Sélectionnez le micro dans Audio et vérifiez le niveau dans les réglages Son.
  5. Vérifiez que le mode est activé, utilise un modèle valide et la sortie Paste.
  6. Vérifiez que le modèle est téléchargé, ou que la clé cloud et le réseau fonctionnent.
  7. Si le texte apparaît dans VoiceInk mais pas dans votre app, réparez l'étape du collage.

Questions

Pourquoi VoiceInk ne transcrit-il rien ?

La documentation de VoiceInk cite cinq causes courantes : une autorisation macOS manquante, le mauvais micro, un mode avec des réglages inattendus, un modèle local trop lent pour le Mac, ou le délai de collage dans l'app cible. Vérifiez-les dans cet ordre.

Pourquoi VoiceInk ne donne aucun résultat avec un modèle local ?

Vérifiez que le modèle est téléchargé dans AI Models et sélectionné dans le mode actif. Pour un fichier Whisper .bin importé, vérifiez que le fichier existe toujours et reste lisible. Les modèles en streaming uniquement exigent le mode Real-time.

VoiceInk a-t-il besoin d'Internet ?

Pas avec un modèle local téléchargé. Un fournisseur de transcription dans le cloud a besoin d'Internet et d'une clé d'API valide. Si la transcription échoue sur un réseau d'entreprise, vérifiez que le mode n'utilise pas un modèle cloud par erreur.

Existe-t-il une alternative gratuite et signée à VoiceInk ?

Petal pour Mac est gratuit et open source, et sa version sur GitHub est signée. Il exécute Parakeet, Whisper, Qwen3 ASR et d'autres modèles vocaux sur votre Mac.

SolutionsMac

VoiceInk ne colle pas le texte : les solutions

VoiceInk ne colle pas le texte ou colle l'ancien presse-papiers ? Passez Paste Method sur AppleScript, allongez Restore Delay, réinitialisez Accessibilité.

SolutionsMac

Dictée Mac dans la mauvaise langue : solutions

La dictée Mac écrit dans la mauvaise langue ? Ajoutez votre langue dans Clavier > Dictée, changez-la en dictant, vérifiez la source de saisie et le modèle.