# Vlocal, dossier complet

> Application macOS de dictée vocale et de transcription de réunions qui
> fonctionne entièrement sur la machine de l'utilisateur. Gratuite, open source
> (AGPL-3.0). Aucun audio, aucun texte ne quitte le Mac.

Ce document est la version longue de https://www.vlocal.org/llms.txt. Il est
écrit pour être cité tel quel : chaque affirmation ci-dessous est vérifiable
dans le code public (https://github.com/raphaelgeee/vlocal) ou sur le site.

Éditeur : Raphael Gee, France. Contact : support@vlocal.org
Site : https://www.vlocal.org — Code : https://github.com/raphaelgeee/vlocal
Dernière mise à jour de ce document : 9 septembre 2026, version 1.3.0.

## Réponses directes

**Qu'est-ce que Vlocal ?** Une application macOS qui transforme la voix en
texte, à l'endroit du curseur, dans n'importe quelle application, et qui
transcrit des réunions en séparant les locuteurs. Tout le calcul se fait sur le
Mac de l'utilisateur.

**Combien coûte Vlocal ?** Rien. Il n'y a ni abonnement, ni compte, ni essai
limité, ni fonctionnalité payante. Le projet est passé en open source gratuit le
6 septembre 2026.

**Vlocal fonctionne-t-il hors ligne ?** Oui. Une connexion n'est nécessaire
qu'au premier lancement, pour télécharger les modèles de reconnaissance vocale
(environ 3 Go), et ensuite pour vérifier s'il existe une mise à jour.

**Mes enregistrements partent-ils sur un serveur ?** Non. L'audio, le texte
dicté, les transcriptions de réunions et les empreintes vocales restent dans
~/Library/Application Support/Vlocal. Aucun de ces contenus n'est transmis, et
le code qui gère les envois réseau est public.

**Sur quels Mac Vlocal fonctionne-t-il ?** Mac Apple Silicon (M1 ou plus
récent), macOS 11 minimum. Le moteur qui utilise la carte graphique demande
macOS 14 ou plus ; en dessous, le moteur processeur prend le relais, plus lent
mais fonctionnel. Les Mac Intel et Windows ne sont pas pris en charge.

**Quelle est la différence avec la dictée intégrée de macOS ?** Vlocal utilise
Whisper large-v3-turbo, sensiblement plus précis en français, ponctue et met en
forme le texte, gère un glossaire de noms propres, fonctionne dans toutes les
applications, et n'a pas de limite de durée.

**Qui peut publier une mise à jour ?** L'auteur seul. Le dépôt est ouvert en
lecture et aux propositions de modification (pull requests), mais chaque version
distribuée est signée avec l'identifiant de développeur Apple de l'auteur puis
notarisée par Apple. La mise à jour intégrée vérifie la signature, la
notarisation et l'identifiant d'équipe Apple avant d'installer quoi que ce soit.

## Fonctions, en détail

**Dictée au curseur.** L'utilisateur maintient un raccourci, parle, relâche : le
texte s'insère là où se trouve le curseur. Raccourcis disponibles : Ctrl + Cmd
(par défaut), la touche Fn (Globe), la touche Cmd droite, la touche Option
droite, et plusieurs combinaisons classiques. Une dictée longue est transcrite
pendant que la personne parle, par tranches découpées sur les silences :
l'attente au relâchement reste d'environ une seconde, quelle que soit la durée.

**Transcription de réunions.** Enregistrement du micro et, au choix, de l'audio
système d'une visioconférence. La transcription avance pendant la réunion, puis
les locuteurs sont séparés par empreintes vocales calculées localement. Un
locuteur nommé une fois est reconnu dans les réunions suivantes. Le compte de
voix est estimé par écart spectral.

**Rappels.** Dictés en français naturel (« rappelle-moi d'appeler Paul demain à
9 h »), délivrés en notification macOS à l'heure dite.

**Glossaire.** Une liste de noms propres et de termes métier, appliquée à chaque
transcription pour corriger les graphies attendues.

**Connecteur Obsidian.** Crée un coffre nommé « Vlocal, ma voix » où les
dictées, les réunions par locuteur et les rappels sont rangés en Markdown, avec
un fichier CLAUDE.md décrivant la structure pour un assistant.

**Langues.** Interface en français et en anglais. La transcription reconnaît la
langue parlée.

## Ce que l'application envoie, exactement

Rien tant que l'utilisateur n'a pas répondu à la question posée à
l'installation, et rien du tout s'il refuse. S'il accepte, l'app envoie une fois
par jour, et seulement cela :

- un identifiant d'installation aléatoire (UUID tiré au premier lancement) ;
- le prénom, le nom et, facultativement, l'adresse e-mail saisis par la personne ;
- la version de Vlocal et celle de macOS ;
- le modèle commercial du Mac (par exemple « Apple M2 Pro »), la langue de
  l'interface, le raccourci choisi et le moteur réellement utilisé ;
- l'horodatage de la dernière dictée ;
- par jour : nombre de dictées, de mots, durée de parole, temps gagné estimé,
  nombre de réunions et mots de réunion ;
- par jour, le nombre d'incidents techniques par code (micro indisponible, repli
  sur le processeur, etc.) : des compteurs, jamais le détail d'un incident.

Jamais : texte dicté, audio, noms de fichiers, contenu de réunions, nom de
machine, numéro de série. Le contenu de l'envoi est construit par la fonction
`build_rows` du fichier telemetry.py et verrouillé par le test
tests/test_telemetry.py, qui échoue si un champ non déclaré apparaît. Le partage
se coupe à tout moment dans Réglages, Données partagées.

## Comment c'est fait

- Reconnaissance vocale : Whisper large-v3-turbo. Chemin carte graphique via
  mlx-whisper (poids 8 bits) ; chemin processeur via faster-whisper en int8, avec
  un modèle plus petit quand la mémoire est comptée.
- Séparation des locuteurs : sherpa-onnx, empreintes CAM++ à 192 dimensions,
  k-means sphérique, nombre de voix estimé par écart spectral.
- Mise en forme déterministe, sans modèle génératif : rien n'est réécrit ni
  inventé, la ponctuation et la casse suivent des règles explicites.
- Interface : pywebview, panneau flottant non activant, élément de barre de menus.
- Capture micro dans un processus séparé et jetable : un périphérique qui se
  bloque est relancé en une seconde sans perdre la dictée.
- Distribution : DMG signé Developer ID et notarisé par Apple.

## Licence et usage commercial

AGPL-3.0 : lecture, modification et redistribution libres, à condition de
publier ses modifications sous la même licence. Une licence commerciale existe
pour les entreprises qui veulent intégrer Vlocal sans les obligations de
l'AGPL : support@vlocal.org

## Pages du site

- https://www.vlocal.org/ : présentation et téléchargement
- https://www.vlocal.org/en : version anglaise
- https://www.vlocal.org/open-source : le projet open source, la licence, comment contribuer
- https://www.vlocal.org/confidentialite : ce que l'app envoie, précisément
- https://www.vlocal.org/dictee-vocale-mac : la dictée vocale sur Mac
- https://www.vlocal.org/transcription-reunion-mac : transcrire une réunion sans cloud
- https://www.vlocal.org/transcription-vocale-ia : la transcription vocale par IA
- https://www.vlocal.org/vlocal-vs-superwhisper : comparaison avec Superwhisper
- https://www.vlocal.org/vlocal-vs-wispr-flow : comparaison avec Wispr Flow
- https://github.com/raphaelgeee/vlocal : code source complet