benoit
530c3a10b2
- Main Process spawn serveur automatiquement avec IPC sécurisé - Dashboard temps réel : stats, utilisateurs, QR Code - Configuration audio : devices, sample rate, bitrate, jitter buffer - Gestion groupes : CRUD complet via API admin - Monitoring : logs temps réel filtrables par niveau - Notifications : toast visuelles avec auto-dismiss - Packaging : electron-builder pour macOS (.dmg) et Linux (.deb/.AppImage) - Documentation : README technique, QUICKSTART, CHANGELOG, guide utilisateur Structure : - electron/main.js (333 lignes) : Main Process + spawn serveur - electron/preload.js (31 lignes) : IPC bridge sécurisé - electron/ui/index.html (187 lignes) : interface dashboard - electron/ui/styles.css (556 lignes) : dark theme - electron/ui/app.js (626 lignes) : logic frontend Total : 1733 lignes de code Lancement : ./start-desktop.sh API utilisées : /admin/stats, /admin/users, /admin/groups, /admin/config, /admin/devices/list TODO : WebSocket VU-mètres, icônes, tray menu, graphiques monitoring
2.7 KiB
2.7 KiB
PTT Live Desktop - Quick Start Guide
🚀 Lancement en 30 secondes
# Depuis la racine du projet
./start-desktop.sh
C'est tout ! L'application démarre automatiquement le serveur.
📋 Checklist Première Utilisation
1. Vérifier le serveur
✅ Statut : 🟢 Actif (coin haut-droit) ✅ Dashboard : stats doivent s'afficher sous 5s
2. Configurer l'audio
Configuration → Périphériques Audio
- Sélectionner Input Device (carte son ou micro)
- Sélectionner Output Device (haut-parleurs)
- Cliquer Appliquer
💡 Les devices sont auto-détectés depuis votre système
3. Créer des groupes (optionnel)
Groupes → ➕ Nouveau groupe
- Entrer un nom (ex: "Production")
- Bitrate par défaut : 96 kbps (voix standard)
- Sauvegarder
Les groupes sont enregistrés dans server/config/config.yaml
4. Connecter des clients
Dashboard → QR Code
- Scanner le QR Code avec smartphone
- OU copier l'URL et ouvrir dans navigateur
URL type : https://192.168.1.10:5173
🎯 Fonctionnalités Principales
Dashboard
- Stats : uptime, utilisateurs, connexions
- QR Code : connexion rapide clients
- Utilisateurs : liste en temps réel
Configuration
- Audio : devices, sample rate, bitrate, jitter buffer
- Groupes : créer/modifier/supprimer
Monitoring
- Logs : serveur en temps réel, filtrables
🐛 Problèmes Courants
Serveur ne démarre pas
Symptôme : statut reste "⚪ Arrêté"
Solutions :
-
Vérifier port 3000 libre :
lsof -i :3000 -
Vérifier LiveKit installé :
livekit-server --version # OU ls ../server/bin/livekit-server -
Voir logs dans Monitoring → Logs
QR Code ne s'affiche pas
Symptôme : zone blanche
Solutions :
- Attendre 5-10s (génération après démarrage serveur)
- Vérifier serveur actif (🟢)
- Recharger : Dashboard → cliquer nav
Pas d'audio
Symptôme : clients connectés mais pas de son
Solutions :
- Configuration → vérifier devices sélectionnés
- Vérifier permissions micro (système)
- Tester avec devices différents
⌨️ Raccourcis
Cmd/Ctrl + R: recharger interfaceCmd/Ctrl + Q: quitter appCmd/Ctrl + Shift + I: DevTools (debug)
📖 Documentation
- DESKTOP-APP.md : doc complète
- README.md : vue d'ensemble projet
- CLAUDE.md : doc développement
🆘 Support
Logs : Monitoring → Logs
DevTools : npm run dev (dans terminal)
Issues : GitHub (si open source)
Bon intercom ! 🎙️