# Installer NoComprendo 2.X sur Ubuntu

> Basé sur le wiki officiel du projet : [invent.kde.org/beroot/nocomprendo — Install on Debian](https://invent.kde.org/beroot/nocomprendo/-/wikis/debian_install)
> et sur une session de dépannage réelle sur Ubuntu (septembre 2026).

NoComprendo est un outil de commande vocale, de dictée et de synthèse vocale (Text-to-Speech) pour Linux, développé par Bruno Anselme. Il utilise :
- **Vosk** pour la reconnaissance vocale,
- **dotool** pour simuler les entrées clavier/souris (compatible X11/Wayland),
- **svox-pico** / eSpeak pour la synthèse vocale.

---

## 1. Prérequis

### 1.1 Installer dotool (simulation clavier/souris)

```bash
git clone https://git.sr.ht/~geb/dotool
cd dotool
./build.sh
sudo ./build.sh install
```

Autoriser dotool à créer des périphériques d'entrée virtuels via une règle udev :

```bash
sudo udevadm control --reload && sudo udevadm trigger && sudo usermod -a -G input USER_NAME
```

> Remplace `USER_NAME` par ton nom d'utilisateur (ex. `staline`).

**Redémarre ton ordinateur** pour que les nouvelles règles udev prennent effet. Sans ce redémarrage, seuls le lancement de programmes et les méta-commandes fonctionneront — pas le contrôle du clavier/de la souris.

### 1.2 Installer l'environnement Qt6

```bash
sudo apt install qt6-base-dev qt6-multimedia-dev qt6-tools-dev qt6-l10n-tools
```

### 1.3 Installer Vosk (reconnaissance vocale)

Sur Ubuntu, la bibliothèque Vosk s'installe via pip et fournit `libvosk.so`, mais **pas** le header C `vosk_api.h`, nécessaire à la compilation :

```bash
pip3 install vosk
```

Télécharger ensuite le header manquant depuis le dépôt officiel et le copier dans le même dossier que `libvosk.so` :

```bash
wget https://raw.githubusercontent.com/alphacep/vosk-api/master/src/vosk_api.h -P /tmp/
sudo cp /tmp/vosk_api.h /usr/local/lib/python3.12/dist-packages/vosk/
```

> Adapte le chemin (`python3.12`) à ta version de Python — vérifie-le avec la commande de la section 2.2.

---

## 2. Compilation

### 2.1 Récupérer et préparer les sources

```bash
tar zxvf nocomprendo-2.x.tar.gz
cd nocomprendo-2.x
```

### 2.2 Localiser libvosk.so

```bash
sudo find / -name "libvosk.so" 2>/dev/null
```

Résultat typique sur Ubuntu (pip, install système) :
```
/usr/local/lib/python3.12/dist-packages/vosk/libvosk.so
```

### 2.3 Adapter `nocomprendo.pro`

Le fichier `.pro` d'origine référence un chemin Fedora/RedHat (`/usr/lib64/libvosk.so.0`) qui n'existe pas sur Ubuntu, et ne définit **aucun `INCLUDEPATH`** vers le header `vosk_api.h` — c'est la cause de l'erreur `fatal error: vosk_api.h: Aucun fichier ou dossier de ce nom` (que vous aurez en suivant la documentation initiale du développeur)

Remplacer :
```qmake
LIBS += /usr/lib64/libvosk.so.0
# LIBS += -lvosk
# For debians check libvosk.so location. May be next line
# LIBS += /usr/lib/python3.10/site-packages/vosk/libvosk.so
```

par (en adaptant le chemin trouvé à l'étape 2.2) :
```qmake
LIBS += /usr/local/lib/python3.12/dist-packages/vosk/libvosk.so
INCLUDEPATH += /usr/local/lib/python3.12/dist-packages/vosk
```

### 2.4 Compiler

Utiliser `qmake6` (et non `qmake`, au cas où `qmake5` serait aussi présent sur le système) :

```bash
qmake6
make
```

### 2.5 Problème de traduction (.qm manquant)

Erreur possible :
```
RCC: Error in 'qmake_qmake_qm_files.qrc': Cannot find file '.../.qm/nocomprendo_fr_FR.qm'
```

Le fichier de traduction compilé (`.qm`) n'est pas généré automatiquement par `lrelease` générique sur certaines configs Ubuntu. Solution :

```bash
# Si "lrelease" seul échoue avec "could not find a Qt installation"
/usr/lib/qt6/bin/lrelease nocomprendo_fr_FR.ts

# Déplacer le fichier généré dans le dossier attendu par le build
mkdir -p .qm
mv nocomprendo_fr_FR.qm .qm/

# Relancer la compilation (sans make clean)
make
```

### 2.6 Installer l'application

```bash
sudo make install
```

### 2.7 Créer le dossier des modèles de langue Vosk

```bash
sudo mkdir -p /usr/share/vosk-models/
sudo chmod 777 /usr/share/vosk-models/
```

### 2.8 Lancer NoComprendo

```bash
./nocomprendo
```

---

#

## 3. Utilisation de NoComprendo

### 3.1 Premier démarrage — modèle de langue

Au premier lancement, NoComprendo se connecte à **alphacephei.com** et propose de télécharger un modèle de langue Vosk. Pour le français, deux options principales :
- **`fr`** : modèle complet, plus précis mais plus lourd (~1.4 Go)
- **`small-fr`** : modèle léger, plus rapide mais moins précis.

L'application propose aussi de choisir la langue de l'interface (`fr_FR` ou `en_US`) au premier démarrage.

### 3.2 Dictée vocale

- Clique sur l'icône du **micro** dans l'interface et parle distinctement.
- Vosk transcrit la parole en texte au fur et à mesure.
- Commandes de ponctuation orales disponibles : *« point »*, *« virgule »*, *« point à la ligne »*, etc.
- Pour démarrer rapidement : dire *« Je commence à dicter »*.
- Si seule la dictée t'intéresse (pas les commandes vocales), tu peux désactiver les groupes de commandes dans les réglages.

### 3.3 Commandes vocales

- NoComprendo est livré avec des **groupes de commandes de démonstration**, orientés pour l'environnement KDE/Plasma — à vérifier et adapter selon ton propre environnement (GNOME sur Ubuntu par défaut, par exemple).
- Chaque commande associe une phrase prononcée à une action : raccourci clavier, lancement de programme, etc.
- Pour modifier une commande : **double-clic dessus**, puis ré-enregistrer la nouvelle formulation.

### 3.4 Conseils pour une bonne reconnaissance

- Vosk fonctionne mieux avec des **phrases syntaxiquement correctes** plutôt que des mots isolés.
  - Préférer *« Fermer la fenêtre »* à *« fermer fenêtre »*.
- Le résultat exact peut varier selon le modèle (`fr` vs `small-fr`) : par exemple *« Fermez la fenêtre »* ou *« Fermé la fenêtre »* pour la même intention.
- Articuler distinctement, éviter les commandes monosyllabiques et les mots proches phonétiquement (homophonies).
- Ne pas taper au clavier pendant que l'écoute vocale est active (peut perturber la reconnaissance).

### 3.5 Synthèse vocale (Text-to-Speech)

- Fonctionne en copiant du texte dans le presse-papier, puis en demandant à NoComprendo de le vocaliser.
- Six langues disponibles pour la synthèse vocale au moment de la rédaction de cette doc.

### 3.6 Fonctionnement hors-ligne

Reconnaissance et synthèse vocales sont effectuées **entièrement hors-ligne** — aucune donnée vocale n'est envoyée à des serveurs tiers.

---

## 4. Ressources

- Wiki officiel (installation Debian/Ubuntu) : https://invent.kde.org/beroot/nocomprendo/-/wikis/debian_install
- Dépôt Vosk (header et sources) : https://github.com/alphacep/vosk-api
- dotool : https://git.sr.ht/~geb/dotool