📖 Documentation

Guide d'utilisation — Tania Dictée

Tout ce qu'il faut savoir pour dicter en franglais dans n'importe quelle app Windows, 100% local. F6 → parle → texte collé. C'est vraiment tout.


🚀 Étape 1

Installation

Tania Dictée est en beta privée — l'installeur .exe 1-clic arrive à l'été 2026. En attendant, la version open source s'installe en ~10 minutes.

Prérequis système

1

Windows 10 ou 11 (64-bit)

Tania Dictée est buildée Windows-first. Mac et Linux ne sont pas supportés en v1.

2

Python 3.10+ installé

Télécharge Python sur python.org. Coche "Add Python to PATH" pendant l'installation. Pas nécessaire avec l'installeur .exe (beta fermée).

3

GPU recommandé (mais pas obligatoire)

Avec une carte NVIDIA, la transcription est quasi instantanée (<1s). Sans GPU, ça tourne quand même sur le CPU — juste 2-3× plus lent (~3s de délai).

4

Micro fonctionnel

N'importe quel micro — casque, micro externe, micro intégré. Testa-le dans les paramètres son Windows avant de continuer.

Installation depuis GitHub (version open source)

# 1. Clone le repo
git clone https://github.com/elboKazQC/tania-dictee.git
cd tania-dictee

# 2. Crée l'environnement virtuel
python -m venv .venv
.venv\Scripts\activate

# 3. Installe les dépendances
pip install -r requirements.txt

# 4. Lance l'app
python app.py
⚙️ Étape 2

Première configuration

Deux minutes pour paramétrer, et c'est réglé.

1

Choisir ton micro

Au premier lancement, une liste de micros s'affiche dans la console. Entre le numéro correspondant à ton micro et confirme.

2

Tester le hotkey F6

Ouvre n'importe quelle app texte (Bloc-notes, VS Code, Gmail dans Chrome). Clique dans la zone de texte pour placer ton curseur. Pèse F6, dis « test de micro », relâche F6. Le texte devrait coller là où ton curseur était.

3

Ajouter tes premiers mots au glossaire (optionnel)

Ouvre le fichier glossary.txt à la racine du projet. Ajoute un mot par ligne. Exemple : useEffect, useState, NextJS. Aucun redémarrage requis.

⌨️ Utilisation

Le hotkey F6

F6 est le cœur de Tania Dictée. Tout le flow tient en un geste :

F6 appuyé🎙 micro actiftu parles
F6 relâché⚡ transcription (<1s avec GPU)texte collé dans l'app active

Comment ça marche exactement

🎯

Curseur = destination du texte

Le texte se colle exactement où ton curseur est positionné dans la fenêtre active. Clique d'abord dans la zone de texte que tu veux remplir, ensuite F6.

Maintiens F6 pendant toute la dictée

F6 maintenu = micro ouvert. F6 relâché = enregistrement terminé, transcription démarre. Tu peux dicter 30 secondes d'un coup ou juste 3 mots — ça marche pareil.

🔁

Répète autant que tu veux

F6 → phrase → colle. F6 → phrase → colle. Pas de limite. Chaque F6 est indépendant — tu peux dicter par petites rafales.

🍁 Franglais

Dicter en franglais

C'est l'avantage clé sur tous les concurrents. Tu n'as pas à choisir entre français et anglais avant de parler — Tania Dictée détecte la langue segment par segment dans la même phrase.

❌ Les autres (Wispr, Dragon)

Langue = session entière

Tu démarres en français, tout reste en français. "useEffect" sort "utilisez Effet". Tu passes 30s à corriger après chaque phrase.

✅ Tania Dictée

Langue = segment par segment

FR et EN dans la même phrase, sans switcher de mode. "Ajoute un useEffect qui gère le loading" sort propre en un seul F6.

Exemples réels

Ce que tu dis (franglais naturel) :
"Crée un composant Button avec un prop onClick qui dispatch un event vers le parent"

Ce qui sort :
Crée un composant Button avec un prop onClick qui dispatch un event vers le parent

——

"Ajoute un useEffect qui fetch les données du endpoint slash users"
Ajoute un useEffect qui fetch les données du endpoint /users

"Le state loading passe à false quand le fetch est done"
Le state loading passe à false quand le fetch est done

Conseils pour de meilleurs résultats

💡

Parle naturellement, sans ralentir

Whisper performe mieux avec un débit naturel. Pas besoin de détacher chaque syllabe ou de parler "fort". Ton rythme habituel, c'est parfait.

💡

Noms de fonctions : dis-les comme tu les lis

"use effect" (deux mots) → sort "useEffect" grâce au glossaire. "get user by id" → sort "getUserById". Pas besoin d'épeler.

💡

Ponctuation : dicte-la si nécessaire

Dis "point" → ".", "virgule" → ",", "ouvrir parenthèse" → "(". Pour les blocs de code, mieux vaut pas dicter la syntaxe — dicte l'intention en prose et laisse Copilot finir.

📖 Glossaire

Glossaire perso — tes mots toujours bien écrits

Whisper est entraîné sur l'anglais et le français génériques. Des mots tech FR-QC spécifiques ou tes noms de projets peuvent mal sortir. Le glossaire corrige ça.

Comment ajouter un mot

Ouvre le fichier glossary.txt à la racine du projet. Un mot ou expression par ligne :

# glossary.txt — exemples
useEffect
useState
NextJS
Tania Dictée
Noovelia
OpenClaw
TailwindCSS
shadcn
trpc
Zustand
pinia
FastAPI

Comment ça marche en coulisses

Whisper reçoit les mots du glossaire comme "tokens préférés" au moment de la transcription. Si tu dis "NextJS" et que c'est dans ton glossaire, Whisper va favoriser cette orthographe exacte plutôt que "Next J.S." ou "Next géé esse".

Quand utiliser le glossaire

Noms propres tech

Libs, frameworks, noms de projets, noms de variables récurrentes — tout ce que tu uses souvent et que Whisper écorche.

Acronymes et jargon métier

APIs, termes de ton domaine, abréviations internes. Si tu travailles en santé, en finance, en droit — ajoute ton vocab spécialisé.

Mots courants bien reconnus

Pas besoin d'ajouter "bonjour", "useState" s'il sort déjà bien, ou les mots français du dictionnaire standard. Le glossaire c'est pour les exceptions, pas le vocabulaire de base.

🔒 Sécurité

Confidentialité — ta voix reste chez toi

C'est l'argument central de Tania Dictée : 100% local. Pas de serveurs, pas de logs, pas de compte cloud requis pour la transcription.

❌ Wispr Flow / Dragon cloud

Ton audio file sur leurs serveurs

Ta voix transite par leurs API. Tes mots de passe dictés, tes prompts sensibles, ton code propriétaire — tout ça passe par leur infra.

✅ Tania Dictée

Zéro transit réseau pour la voix

L'audio est capturé en RAM, traité par Whisper local, transcrit en texte — tout reste en mémoire sur ton PC. Aucune donnée envoyée.

Ce qui se passe techniquement

MicroRAM (audio brut)Whisper localtextePresse-papiercolled dans ton app

Rien ne sort de ce circuit. Pas de logging fichier, pas d'appel réseau.

Exceptions (licences et updates)

La validation de licence et les mises à jour nécessitent une connexion internet. Mais ça ne concerne jamais l'audio — c'est juste un handshake de licence (clé chiffrée). La transcription fonctionne hors ligne complet.

Pourquoi c'est important pour ton code

🔐

Code propriétaire et secret de client

Si tu travailles sur des projets clients ou du code propriétaire, tu peux dicter librement — ta logique business ne passe pas par des serveurs tiers.

🔑

Mots de passe et tokens (à éviter quand même)

Techniquement, l'audio reste local. Mais ne dicte jamais tes mots de passe — pas parce que Tania les envoie quelque part, mais parce que le texte collé dans une mauvaise fenêtre = risque d'exposition accidentelle.

🏷️ Licences

Licences et activation

Deux plans disponibles. Simples, honnêtes, pas de surprise.

One-shot · 1 an
49$
CAD, une fois · 3 machines
  • Toutes les fonctionnalités
  • 3 machines max
  • 1 an d'updates inclus
  • Hors ligne après activation

Q Comment activer ma licence ?

Après achat via Lemon Squeezy, tu reçois un email avec ta clé de licence. Au premier lancement, Tania Dictée te demande cette clé. Entre-la une fois — elle est sauvegardée, tu n'auras plus jamais à la rentrer.

Q Est-ce que ça marche hors ligne ?

La transcription est 100% hors ligne. La validation de licence se fait au premier lancement et une fois toutes les 30 jours. Si t'as pas de connexion pendant 30 jours — une grace period s'applique et ça continue de fonctionner.

Q Je change de PC — comment transférer ma licence ?

Email à casaubonvincent@gmail.com avec ta clé et le nom de la machine à libérer. On réactive en 24h. (Plan One-shot : 3 machines max. Pro : illimité, pas besoin de nous contacter.)

Q Politique de remboursement ?

14 jours, remboursement complet si ça fait pas ce qu'on promet. Aucune question. Email à casaubonvincent@gmail.com.

🔧 Dépannage

Dépannage

Les problèmes les plus fréquents et comment les régler en 2 minutes.

🎙 Le micro n'est pas détecté / aucun son enregistré

Vérifie d'abord : Paramètres Windows → Son → Onglet Enregistrement → ton micro est bien là et pas "Désactivé".

Ensuite : Quand tu lances python app.py, une liste de micros disponibles s'affiche. Entre le bon numéro.

Toujours rien : Va dans Paramètres → Confidentialité → Microphone → active l'accès pour les applications de bureau. Windows bloque parfois les apps Python par défaut.

🐢 La transcription est trop lente (plus de 5 secondes)

Sans GPU NVIDIA : Normal — CPU seul prend 3-6s. Pour aller plus vite, tu peux utiliser un modèle plus petit. Édite app.py et change MODEL_SIZE = "large-v3" pour "medium" ou "small". Qualité un peu moindre, mais 2× plus rapide.

Avec GPU mais quand même lent : Vérifie que CUDA est bien installé. Lance python test_cuda.py (inclus dans le repo) — il confirme si Whisper utilise bien ton GPU.

❌ Le texte ne se colle pas dans l'app

Vérifie que ton curseur est bien dans une zone de texte avant d'appuyer sur F6. Si ton curseur est dans la barre d'adresse du navigateur ou une zone non-texte, le coller ne va nulle part.

Certaines apps corporate bloquent le coller automatique (ex. : Teams en entreprise avec DLP activé, certains VPNs). Dans ce cas, le texte est dans ton presse-papier — Ctrl+V manuel fonctionne.

🔤 Mes mots techniques sortent mal

Solution immédiate : Ajoute le mot dans glossary.txt, un par ligne. Actif au prochain F6.

Exemples courants qui trippent Whisper : "useEffect" → "utilisez Effet", "useState" → "use état", "GitHub" → "get hub". Tous corrigibles via le glossaire.

Pour les acronymes : Dis-les comme des mots, pas épelés. "A-P-I" (épelé) → Whisper hésite. "api" (prononcé comme un mot) → sort "API" propre.

🔑 Ma clé de licence ne fonctionne pas

Vérifie : Pas d'espace en début ou fin de clé quand tu la copies. La clé est sensible à la casse.

Toujours bloqué : Email à casaubonvincent@gmail.com avec ta clé et ta commande Lemon Squeezy — on règle ça en 24h.

📬 Support

Contact support

T'as un problème pas couvert ici ? Une idée d'amélioration ? Un bug à reporter ? Envoie un email — on répond en 24-48h.

Rejoindre la waitlist

Pas encore client et tu veux être avisé quand l'installeur 1-clic sort ?

✉ Rejoindre la waitlist