Guides : installer et lancer

Paquets natifs pour Debian 12 et 13, Ubuntu 22.04 et 24.04, Fedora 42, openSUSE Leap 15.6 et Arch Linux. Deux chemins d’installation ; un seul est retenu par machine.

# Debian 12 et 13, Ubuntu 22.04 et 24.04 et leurs dérivées
sudo apt install ./whispskrid_1.0.1_all.deb

# Fedora 42
sudo dnf install ./whispskrid-1.0.1-1.fc42.noarch.rpm

# openSUSE Leap 15.6
sudo zypper install ./whispskrid-1.0.1-1.leap156.noarch.rpm

# Arch Linux
sudo pacman -U whispskrid-1.0.1-1-any.pkg.tar.zst

git clone https://github.com/RonanDavalan/whispskrid.git
cd whispskrid
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/whispskrid --diagnose

Langues de dictée

Quatre langues sont prises en charge : anglais, français, allemand et espagnol. Un même modèle Whisper multilingue les couvre toutes — il n’y a pas un modèle par langue. La langue active est choisie par -l, sinon la langue du système, sinon l’autodétection de Whisper.

whispskrid -l fr

Le modèle vit dans ~/.local/share/whispskrid/whisper-models/. La commande le télécharge et vérifie qu’il se charge :

whispskrid --download-model base

Au premier lancement sans modèle, elle propose ce même téléchargement. Modèles disponibles : tiny, base (défaut), small, medium, large-v3.

Piloter une session

WhispSkrid fonctionne en appui-pour-parler : on tient une touche, on parle, on relâche ; le texte transcrit est injecté dans la fenêtre active. Il n’y a aucune coupure automatique — le seul garde-fou est capture.max_seconds (défaut 300). La touche par défaut est le Maj droit (shift_r), réglable par hotkeys.push_to_talk.

L’écouteur de touche local (pynput) n’atteint que les fenêtres X11 et XWayland. Sous Wayland, ou pour un raccourci global du bureau, on lie plutôt ces sous-commandes, transmises à la session en cours par la socket de contrôle :

whispskrid --dictate       # démarrer la capture
whispskrid --dictate-stop  # arrêter, transcrire, injecter
whispskrid --toggle        # l'un ou l'autre selon l'état
whispskrid --cancel        # jeter la capture en cours

Un raccourci de bureau ne transmet pas le maintien de touche : sur cette voie, --dictate et --dictate-stop encadrent la dictée. La ponctuation n’est pas à dicter — Whisper ponctue et met les majuscules de phrase seul.

whispskrid --diagnose indique le type de session, le moteur d’injection, le périphérique audio, l’état du backend et du modèle, puis quitte.

Wayland et X11

Le texte est injecté par le presse-papiers : il faut donc un moteur de frappe et un outil de presse-papiers. Le moteur est sondé une seule fois au démarrage : ydotool d’abord (niveau du pilote, via le démon ydotoold), puis xdotool, puis le mode dégradé (texte laissé dans le terminal, aucune frappe envoyée). L’outil de presse-papiers est wl-clipboard sous Wayland (toujours requis) et xclip sous X11. Les paquets natifs les tirent ; une installation depuis les sources les ajoute elle-même. Sans outil de presse-papiers, le collage réinsère le dernier contenu copié à la main. ydotool, quand il est le moteur retenu, demande le démon ydotoold et l’appartenance au groupe input (déconnexion / reconnexion après l’ajout). L’écouteur pynput n’atteint que les fenêtres X11 et XWayland ; sous Wayland, liez les sous-commandes ci-dessus aux réglages de raccourcis de votre bureau pour toutes les fenêtres.

Référence complète

Chaque clé de configuration, la cascade de recherche du modèle et le socket de contrôle sont documentés dans le docs/ du projet : configuration.md et la page de manuel whispskrid(1), dans les quatre langues. Voir Architecture pour la façon dont les pièces s’assemblent.