Téléverser les fichiers vers "/"

2026-04-07 11:24:39 +00:00 · 2026-04-07 11:24:39 +00:00 · f95bce07d7
commit f95bce07d7
1 changed files with 537 additions and 0 deletions
--- a/README.md
+++ b/README.md
@ -0,0 +1,537 @@
+# 🎙️ TranscribeStation
+
+**Gestionnaire de transcription audio** avec support natif des pédaliers Olympus.  
+Interface inspirée de Philips SpeechExec et Olympus ODMS.
+
+> **JT-Tools by Johnny** — développé pour **H3Campus**
+
+![Python](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python)
+![PyQt6](https://img.shields.io/badge/PyQt6-6.5%2B-green?logo=qt)
+![Licence](https://img.shields.io/badge/Licence-MIT-yellow)
+![Version](https://img.shields.io/badge/Version-1.0.0-informational)
+![Plateforme](https://img.shields.io/badge/Plateforme-Linux%20%7C%20Windows-lightgrey)
+
+---
+
+## Sommaire
+
+- [Fonctionnalités](#fonctionnalités)
+- [Capture d'écran](#capture-décran)
+- [Prérequis](#prérequis)
+- [Installation](#installation)
+- [Configuration du pédalier](#configuration-du-pédalier-udev)
+- [Utilisation](#utilisation)
+- [Raccourcis clavier](#raccourcis-clavier)
+- [Formats audio supportés](#formats-audio-supportés)
+- [Paramètres](#paramètres)
+- [Compilation en binaire](#compilation-en-binaire)
+- [Architecture](#architecture)
+- [Limitations connues](#limitations-connues)
+- [Dépannage](#dépannage)
+
+---
+
+## Fonctionnalités
+
+| Catégorie | Détails |
+|-----------|---------|
+| **Lecteur audio** | Lecture, pause, stop, rembobinage, avance rapide, vitesse (0.5× → 2.0×) |
+| **Volume** | Slider toolbar + muet, raccourcis `+` / `-` / `M` |
+| **Forme d'onde** | Waveform interactive (clic pour se positionner) via NumPy + SoundFile |
+| **Navigation** | Fichier précédent / suivant depuis la toolbar et le clavier |
+| **Gestion fichiers** | Navigation par dossiers, ajout manuel, filtres par statut |
+| **Statuts** | À faire · En cours · Suspendu · Terminé — persistés entre sessions |
+| **Pédaliers** | RS27H/N · RS28H/N · RS31H/N — reconnexion automatique si débranché |
+| **Persistance** | Base de données JSON locale (`.transcribe_station.json`) par dossier |
+| **Interface** | Thème sombre, toolbar emoji, séparateur redimensionnable, barre de statut |
+| **Raccourcis** | 15 raccourcis clavier couvrant transport, volume, vitesse et navigation |
+| **Compilation** | Binaire autonome Linux + Windows via `build.py` (PyInstaller) |
+| **Raccourcis OS** | Entrée GNOME (`.desktop` + icône XDG) et menu Démarrer Windows (`.lnk`) |
+
+---
+
+## Capture d'écran
+
+```
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  📂 ➕ 💾  │  ⏮️ ⏪️ ▶️ ⏩️ ⏭️ ⏹️  │  ⏫ ⏬  │  🔇 ══════  │  ⚙️ ❓   🦶 Connecté │
+├─────────────┬────────────────────────────────────────────────────────────────┤
+│ 📋 Dictées  │  Nom du fichier     N°   Auteur   Type    Durée   Statut       │
+│  📥 À faire │  ▌ DICT0070.wav     69   DUPONT   LETTRE  05:00   À faire      │
+│  🔵 En cours│  ▌ DICT0007.wav     55   MARTIN   GEN.    12:30   Terminé      │
+│  ✅ Terminé │  ▌ DICT0008.wav     56   MARTIN   GEN.    08:15   En cours     │
+│  ⏸ Suspendu │                                                                │
+│             │                                                                │
+│ 📨 Dossiers │                                                                │
+│  📂 2024-Q4 │                                                                │
+│  📂 2025-Q1 │                                                                │
+├─────────────┴────────────────────────────────────────────────────────────────┤
+│  ▓▓▓▓▓▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  ← waveform interactive      │
+│  01:23 ────────●─────────────────────────────── 05:00                        │
+│  Vitesse: 1.0×   Volume: ████████░░░   🦶 RS27H/N connecté                  │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Prérequis
+
+### Système (Debian 12 / 13)
+
+```bash
+sudo apt-get install -y \
+    python3 python3-pip python3-venv \
+    libhidapi-dev libhidapi-hidraw0 libusb-1.0-0 \
+    gstreamer1.0-plugins-good \
+    gstreamer1.0-plugins-bad \
+    gstreamer1.0-plugins-ugly \
+    gstreamer1.0-libav \
+    fonts-noto-color-emoji
+```
+
+> **GStreamer** est requis par PyQt6 QtMultimedia pour lire l'audio sous Linux.  
+> **fonts-noto-color-emoji** assure le rendu des emojis dans la toolbar.
+
+### Dépendances Python
+
+| Paquet | Version min | Rôle | Optionnel |
+|--------|-------------|------|-----------|
+| `PyQt6` | 6.5 | Interface graphique + lecteur audio | Non |
+| `numpy` | 1.24 | Traitement du signal pour la waveform | Oui |
+| `soundfile` | 0.12 | Lecture des fichiers audio (waveform) | Oui |
+| `hid` | 1.0.5 | Communication USB HID avec le pédalier | Oui |
+| `Pillow` | 9.0 | Génération des icônes (compilation uniquement) | Oui |
+
+> Sans `numpy`/`soundfile` : la waveform ne s'affiche pas, le reste fonctionne.  
+> Sans `hid` : le support pédalier est désactivé (avertissement au démarrage).
+
+---
+
+## Installation
+
+### Méthode rapide (script automatisé)
+
+```bash
+git clone https://github.com/h3campus/transcribe-station.git
+cd transcribe-station
+chmod +x install.sh
+./install.sh
+```
+
+Le script `install.sh` effectue 6 étapes avec sortie colorée :
+
+1. Installation des dépendances système (`apt-get`) incluant `libhidapi` et `fonts-noto-color-emoji`
+2. Création de l'environnement virtuel Python (`.venv/`)
+3. Mise à jour de `pip`
+4. Installation des paquets Python — `PyQt6`, `numpy`, `soundfile`, `hid` (avec fallback `hidapi`)
+5. Configuration udev pour le pédalier + ajout au groupe `plugdev`
+6. Création du script `launch.sh`
+
+### Méthode manuelle
+
+```bash
+# 1. Environnement virtuel
+python3 -m venv .venv
+source .venv/bin/activate
+
+# 2. Dépendances Python
+pip install PyQt6 numpy soundfile hid
+
+# 3. Lancer
+python transcribe_station.py
+```
+
+### Lancement
+
+```bash
+./launch.sh
+# ou
+source .venv/bin/activate && python transcribe_station.py
+```
+
+---
+
+## Configuration du pédalier (udev)
+
+Sans règle udev, l'accès au périphérique HID nécessite les droits root.
+
+### Créer la règle
+
+```bash
+sudo tee /etc/udev/rules.d/99-olympus-pedal.rules << 'EOF'
+SUBSYSTEM=="hidraw", ATTRS{idVendor}=="07b4", MODE="0666", GROUP="plugdev"
+EOF
+
+sudo udevadm control --reload-rules
+sudo udevadm trigger
+```
+
+### Ajouter votre utilisateur au groupe `plugdev`
+
+```bash
+sudo usermod -aG plugdev $USER
+# Déconnectez-vous et reconnectez-vous pour que le groupe soit actif
+```
+
+### Vérifier la détection
+
+```bash
+python3 -c "
+import hid
+for d in hid.enumerate():
+    if d['vendor_id'] == 0x07B4:
+        print(f\"PID={hex(d['product_id'])}  {d.get('product_string','?')}\")
+"
+```
+
+Ou depuis l'application : **Périphérique → Détecter les périphériques**.
+
+### Correspondance VID/PID
+
+| Modèle | Vendor ID | Product ID |
+|--------|-----------|------------|
+| RS27H/N | `0x07B4` | `0x0110` |
+| RS28H/N | `0x07B4` | `0x0111` |
+| RS31H/N | `0x07B4` | `0x0112` |
+
+> ⚠️ Ces Product IDs sont approximatifs. Utilisez la détection automatique puis
+> ajustez dans **Outils → Paramètres → Pédalier**.
+
+### Comportement des pédales
+
+| Pédale | Appui court | Maintenu |
+|--------|-------------|---------|
+| **Gauche** (rewind) | Reculer 3 s | Rembobinage continu — pause auto, reprise au relâché |
+| **Centre** (play) | Lecture / Pause | — |
+| **Droite** (forward) | Avancer 3 s | Avance rapide continue |
+
+---
+
+## Utilisation
+
+### Toolbar
+
+| Bouton | Action |
+|--------|--------|
+| 📂 | Ouvrir un dossier (`Ctrl+O`) |
+| ➕ | Ajouter des fichiers (`Ctrl+Shift+O`) |
+| 💾 | Enregistrer la liste (`Ctrl+S`) |
+| ⏮️ | Aller au début (`Home`) |
+| ⏪️ | Reculer 3 s (`←`) |
+| ▶️ | Lecture / Pause (`Espace`) |
+| ⏩️ | Avancer 3 s (`→`) |
+| ⏭️ | Aller à la fin (`End`) |
+| ⏹️ | Stop (`S`) |
+| ⏫ | Fichier précédent (`Ctrl+↑`) |
+| ⏬ | Fichier suivant (`Ctrl+↓`) |
+| 🔇 | Muet / Actif (`M`) |
+| `══` | Slider volume (`+` / `-`) |
+| ⚙️ | Paramètres (`Ctrl+,`) |
+| ❓ | À propos |
+
+### Ouvrir un dossier
+
+**Fichier → Ouvrir un dossier** ou `Ctrl+O`
+
+L'application scanne automatiquement les fichiers audio du dossier.  
+Un fichier `.transcribe_station.json` est créé pour mémoriser les statuts.
+
+### Lire un fichier
+
+**Double-clic** sur une ligne du tableau, ou sélection + `Espace`.  
+Le statut passe automatiquement à **En cours** à l'ouverture.
+
+### Changer le statut d'un fichier
+
+**Clic droit** sur une ligne → **Changer le statut**
+
+| Couleur | Statut | Description |
+|---------|--------|-------------|
+| 🟡 | À faire | Non encore traité |
+| 🔵 | En cours | Appliqué automatiquement à l'ouverture |
+| ⚪ | Suspendu | Traitement interrompu |
+| 🟢 | Terminé | Transcription complète |
+
+### Sauvegarder
+
+`Ctrl+S` ou **Fichier → Enregistrer la liste**.  
+Sauvegarde automatique également à la fermeture de l'application.
+
+---
+
+## Raccourcis clavier
+
+### Transport
+
+| Raccourci | Action |
+|-----------|--------|
+| `Espace` | Lecture / Pause |
+| `S` | Stop |
+| `←` | Reculer de 3 s |
+| `→` | Avancer de 3 s |
+| `Home` | Aller au début |
+| `End` | Aller à la fin |
+
+### Volume & Vitesse
+
+| Raccourci | Action |
+|-----------|--------|
+| `+` | Volume + 10 % |
+| `-` | Volume − 10 % |
+| `M` | Muet / Actif |
+| `]` | Vitesse + (0.5× → 2.0×) |
+| `[` | Vitesse − |
+
+### Navigation fichiers
+
+| Raccourci | Action |
+|-----------|--------|
+| `Ctrl+↑` | Fichier précédent dans la liste |
+| `Ctrl+↓` | Fichier suivant dans la liste |
+
+### Application
+
+| Raccourci | Action |
+|-----------|--------|
+| `Ctrl+O` | Ouvrir un dossier |
+| `Ctrl+Shift+O` | Ajouter des fichiers |
+| `Ctrl+S` | Enregistrer la liste |
+| `Ctrl+,` | Paramètres |
+| `Ctrl+Q` | Quitter |
+
+---
+
+## Formats audio supportés
+
+| Format | Extension | Waveform | Lecture |
+|--------|-----------|----------|---------|
+| WAV | `.wav` | ✅ | ✅ |
+| MP3 | `.mp3` | ✅ | ✅ |
+| FLAC | `.flac` | ✅ | ✅ |
+| OGG Vorbis | `.ogg` | ✅ | ✅ |
+| MP4 / M4A | `.mp4` `.m4a` | ✅ | ✅ |
+| Olympus DSS | `.dss` | ❌ | ⚠️ selon codec GStreamer |
+| Olympus DS2 | `.ds2` | ❌ | ⚠️ selon codec GStreamer |
+
+> Conversion DSS/DS2 recommandée avant utilisation :
+> ```bash
+> ffmpeg -i fichier.dss fichier.wav
+> ```
+
+---
+
+## Paramètres
+
+**Outils → Paramètres** (`Ctrl+,`)
+
+### Onglet Pédalier
+
+| Paramètre | Description |
+|-----------|-------------|
+| Activer le support pédalier | Active/désactive la lecture HID au démarrage |
+| Modèle | Profil VID/PID prédéfini (RS27H/N, RS28H/N, RS31H/N) |
+| Vendor ID / Product ID | Valeurs hexadécimales personnalisables |
+| Délai rembobinage/avance | Durée du saut clavier en ms (défaut : 3 000 ms) |
+| Détecter | Lance la détection des périphériques Olympus connectés |
+
+### Onglet Général
+
+| Paramètre | Description |
+|-----------|-------------|
+| Auteur par défaut | Pré-rempli pour les nouveaux fichiers importés |
+| Lecture auto à la sélection | Lance la lecture dès qu'un fichier est sélectionné |
+
+---
+
+## Compilation en binaire
+
+Le script `build.py` produit un **exécutable autonome** (PyInstaller `--onefile`) et installe les raccourcis système sur Linux et Windows.
+
+### Prérequis supplémentaires
+
+```bash
+pip install pyinstaller Pillow
+```
+
+### Commandes disponibles
+
+```bash
+# Build + installation raccourcis (OS auto-détecté)
+python build.py
+
+# Build Linux uniquement + raccourci GNOME
+python build.py --linux
+
+# Build Windows uniquement + raccourci Menu Démarrer
+python build.py --windows
+
+# Les deux (Linux natif + Windows via Wine si disponible)
+python build.py --both
+
+# Build sans créer de raccourcis
+python build.py --no-install
+
+# Installer le raccourci sans recompiler (binaire déjà présent)
+python build.py --install-only
+
+# Supprimer le raccourci GNOME
+python build.py --uninstall
+
+# Nettoyer les artefacts (build/ dist/ icon.*)
+python build.py --clean
+```
+
+### Raccourcis créés — Linux (GNOME)
+
+| Élément | Emplacement |
+|---------|-------------|
+| Icône PNG 256 px | `~/.local/share/icons/hicolor/256x256/apps/TranscribeStation.png` |
+| Entrée applications | `~/.local/share/applications/TranscribeStation.desktop` |
+| Raccourci bureau | `~/Bureau/TranscribeStation.desktop` |
+
+Le fichier `.desktop` contient `Exec`, `Icon`, `Categories=Audio;AudioVideo;`, `StartupWMClass` et `Keywords`. Les caches `update-desktop-database` et `gtk-update-icon-cache` sont mis à jour automatiquement.
+
+### Raccourcis créés — Windows (Menu Démarrer & Bureau)
+
+| Raccourci | Emplacement |
+|-----------|-------------|
+| Menu Démarrer | `%APPDATA%\Microsoft\Windows\Start Menu\Programs\TranscribeStation.lnk` |
+| Bureau | `%USERPROFILE%\Desktop\TranscribeStation.lnk` |
+
+Les fichiers `.lnk` sont créés via **PowerShell + WScript.Shell** avec l'icône embarquée dans l'`.exe` (`IconLocation = exe,0`).
+
+En cross-compilation depuis Linux, un script `dist/windows/install_shortcut.ps1` est généré pour exécution sur la machine cible :
+
+```powershell
+powershell -ExecutionPolicy Bypass -File dist\windows\install_shortcut.ps1
+```
+
+### Build Windows sans Wine (machine Windows native)
+
+Copiez `transcribe_station.py` + `dist/build_windows.bat` sur la machine Windows et double-cliquez sur `build_windows.bat`. Le script fait tout en 4 étapes : dépendances pip, génération icône, PyInstaller, raccourcis.
+
+---
+
+## Architecture
+
+```
+transcribe_station.py
+│
+├── APP_NAME / APP_VERSION / APP_AUTHOR   Métadonnées (v1.0.0, Mars 2026)
+├── PEDAL_PROFILES                        VID/PID RS27H · RS28H · RS31H
+├── COLORS / STYLESHEET                   Thème sombre centralisé
+│
+├── DictationStatus (Enum)    TODO / IN_PROGRESS / SUSPENDED / DONE
+├── DictationFile (dataclass) Modèle fichier + sérialisation JSON
+│
+├── FootPedalWorker (QThread) Boucle HID non-bloquante, reconnexion auto ×2 s
+├── WaveformWidget (QWidget)  Rendu QPainter, seek par clic souris
+├── PlayerPanel (QWidget)     QMediaPlayer + transport + volume + vitesse + pédalier
+│   ├── toggle_play / stop_playback / toggle_mute
+│   ├── volume_up / volume_down / set_volume
+│   └── speed_up / speed_down
+├── DictationTable            Table + monospace sur colonnes numériques + menu clic droit
+├── FolderTree (QTreeWidget)  Arbre navigation + compteurs statuts (TODO/EN COURS/DONE)
+├── SettingsDialog (QDialog)  Onglets Pédalier + Général
+└── MainWindow (QMainWindow)  Orchestration, persistance, raccourcis clavier
+    ├── _prev_file / _next_file   Navigation Ctrl+↑/↓
+    └── _build_toolbar()          14 boutons emoji Noto Color Emoji + slider volume
+
+build.py
+├── generate_icons()               icon.png (256 px XDG) + icon.ico (multi-tailles)
+├── build_linux()                  PyInstaller onefile → dist/linux/
+├── build_windows()                PyInstaller windowed → dist/windows/
+├── install_linux_shortcut()       .desktop + icône XDG + Bureau + mise à jour caches
+└── install_windows_shortcut()     PowerShell WScript.Shell → .lnk ×2
+```
+
+**Source de vérité unique** : `DictationTable._files` — toutes les opérations
+(ajout, sauvegarde, stats, affichage) passent par cette seule liste.
+
+---
+
+## Limitations connues
+
+- **DSS/DS2** : formats propriétaires sans codec libre standard. Conversion recommandée : `ffmpeg -i in.dss out.wav`
+
+- **Waveform** : le chargement de fichiers > 200 MB peut bloquer l'UI quelques secondes (pas de thread dédié dans cette version).
+
+- **Reconnaissance vocale** : non intégrée. Compatible avec tout moteur externe (Whisper, Vosk, DeepSpeech…) en copier-coller.
+
+- **Multi-fenêtre** : une seule instance par processus.
+
+- **PID pédalier** : les Product IDs inclus sont approximatifs — à confirmer avec la détection automatique.
+
+---
+
+## Dépannage
+
+### Le pédalier n'est pas détecté
+
+```bash
+# Vérifier que le device USB est visible
+lsusb | grep -i "07b4\|olympus"
+
+# Vérifier les permissions hidraw
+ls -la /dev/hidraw*
+
+# Tester en root (contournement udev)
+sudo python transcribe_station.py
+```
+
+### Pas de son
+
+```bash
+# Vérifier les codecs GStreamer
+gst-inspect-1.0 | grep -i "mp3\|wav\|flac"
+
+# Installer les codecs manquants
+sudo apt-get install gstreamer1.0-plugins-ugly gstreamer1.0-libav
+```
+
+### Les emojis toolbar ne s'affichent pas
+
+```bash
+sudo apt-get install fonts-noto-color-emoji
+# Redémarrer l'application
+```
+
+### Erreur à l'import de `hid`
+
+```bash
+sudo apt-get install libhidapi-dev libhidapi-hidraw0
+pip install hid
+# Alternative :
+pip install hidapi
+```
+
+### La waveform ne s'affiche pas
+
+```bash
+pip install numpy soundfile
+```
+
+### Le raccourci GNOME n'apparaît pas dans les applications
+
+```bash
+update-desktop-database ~/.local/share/applications
+gtk-update-icon-cache -f -t ~/.local/share/icons/hicolor
+# Déconnectez-vous / reconnectez-vous si nécessaire
+```
+
+### Le binaire PyInstaller ne se lance pas
+
+```bash
+# Vérifier les librairies manquantes
+ldd dist/linux/TranscribeStation | grep "not found"
+
+# Lancer avec logs
+dist/linux/TranscribeStation 2>&1 | head -50
+```
+
+---
+
+## Licence
+
+MIT — © Mars 2026 H3Campus / JT-Tools by Johnny  
+Voir [LICENSE](LICENSE) pour les détails.