Installation TimeVox
Guide complet pour installer TimeVox sur votre Raspberry Pi 0 2W
Installation automatique en une seule commande. Durée totale : 50 minutes
Matériel requis
Vérifiez que vous disposez de tout le matériel nécessaire avant de commencer
Téléphone à cadran
Obligatoire
- Téléphone à Cadran
- Vintage
- A trouver en vide grenier
Raspberry Pi 0 2W
Obligatoire
- Processeur quad-core ARM Cortex-A53
- 512 Mo de RAM LPDDR2
- WiFi 802.11n intégré
- Bluetooth 4.2
- Amazon.fr
Carte micro SD
Obligatoire
- Capacité : 16 Go minimum
- Classe 10 ou plus
- Marque fiable (SanDisk, Samsung...)
- Amazon.fr
Module RTC DS3231
Recommandé
- Horodatage précis des messages
- Fonctionne sans internet
- Interface I2C
- Amazon.fr
- Aliexpress
Amplificateur MAX98357A
Recommandé
- Amplificateur I2S
- 3 watts de puissance
- Excellente qualité audio
- Amazon.fr
- Aliexpress
Écran OLED 128x64
Recommandé
- Interface I2C
- Affichage des informations
- Très utile pour le debug
- Amazon.fr
- Aliexpress
Micro USB
Recommandé
- Micro écravate avec préampli
- Ou micro USB standard
- Détection automatique
- Amazon.fr
- Aliexpress
💰 Coût total estimé
Guide pas à pas
Suivez ces étapes dans l'ordre pour une installation réussie
Étape 1 : Préparer la carte SD
Flasher Raspberry Pi OS Lite 32 bits avec la configuration de base
🔽 1. Télécharger et installer Raspberry Pi Imager
Téléchargez l'outil officiel de Raspberry Pi Foundation :
⚙️ 2. Configuration avec Raspberry Pi Imager
Suivez ces étapes dans l'ordre :
🤖 Choisir le modèle
Cliquez sur "Choisir le modèle"
→ Sélectionnez "Raspberry Pi 0 2W"
💿 Choisir l'OS
Cliquez sur "Choisir l'OS"
→ Sélectionnez "Raspberry Pi OS (other)"
→ Puis "Raspberry Pi OS Lite (32-bit)"
💾 Choisir le stockage
Cliquez sur "Choisir le stockage"
→ Sélectionnez votre carte micro SD
⚙️ Configuration avancée
Cliquez sur "Suivant"
→ Cliquez sur "Modifier les réglages"
→ Configurez les paramètres suivants :
📋 Paramètres à configurer :
| Paramètre | Valeur | Description |
|---|---|---|
| Nom d'hôte | timevox |
Nom du Pi sur le réseau |
| Activer SSH | ✅ Oui | Connexion à distance obligatoire |
| Nom d'utilisateur | timevox |
Utilisateur principal du système |
| Mot de passe | Votre choix | 🔒 Notez-le précieusement ! |
| Configurer WiFi | ✅ Oui | Connexion internet nécessaire |
| SSID | Nom de votre réseau | Nom du WiFi |
| Mot de passe WiFi | Clé WiFi | 🔑 Vérifiez bien l'orthographe |
| Pays WiFi | FR |
France (pour les fréquences) |
| Locale | fr_FR.UTF-8 |
Français (optionnel) |
| Timezone | Europe/Paris |
Fuseau horaire français |
🔥 3. Écriture sur la carte SD
- Vérifiez une dernière fois tous vos paramètres
- Cliquez sur "Enregistrer" pour sauvegarder la configuration
- Cliquez sur "Oui" pour confirmer
- Raspberry Pi Imager va :
- 📥 Télécharger automatiquement Raspberry Pi OS Lite
- 🔥 Flasher la carte SD
- ⚙️ Appliquer vos configurations
- ✅ Vérifier l'intégrité
- Patientez environ 5-10 minutes selon votre connexion
- Une fois terminé, éjectez proprement la carte SD
Étape 2 : Premier démarrage
Connecter et accéder au Raspberry Pi via SSH
🔌 1. Premier démarrage du Raspberry Pi
- Insérez la carte SD dans le Raspberry Pi 0 2W
- Connectez l'alimentation micro USB (5V 2A minimum)
- Patientez 2-3 minutes - le premier démarrage est plus long
- Observez les LEDs :
- 🔴 LED rouge : alimentation (doit rester allumée)
- 🟢 LED verte : activité (clignote pendant le boot)
- Attendez la connexion WiFi - la LED verte cessera de clignoter
🌐 2. Trouver l'adresse IP du Raspberry Pi
Une fois le Pi connecté au WiFi, vous devez identifier son adresse IP sur votre réseau :
🔍 Méthode recommandée : Angry IP Scanner
Outil gratuit et simple pour scanner votre réseau :
- Téléchargez la version Win/Mac/linux et installez Angry IP Scanner
- Lancez le logiciel
- Cliquez sur "Démarrer" pour scanner votre réseau
- Cherchez dans la liste :
- Nom : "timevox" ou "raspberrypi"
- Fabricant : "Raspberry Pi Foundation"
- Notez l'adresse IP (ex:
192.168.1.42)
🏠 Méthode alternative : Interface web du routeur
- Accédez à l'interface de votre box (192.168.1.1 ou 192.168.0.1)
- Cherchez la section "Appareils connectés" ou "DHCP"
- Recherchez un appareil nommé "timevox" ou "raspberrypi"
- Notez son adresse IP (ex: 192.168.1.42)
📡 Méthode hostname (si mDNS fonctionne)
Fonctionne sur la plupart des réseaux modernes, mais pas toujours fiable.
🔐 3. Connexion SSH avec PuTTY
Une fois l'IP identifiée, connectez-vous au Raspberry Pi :
Windows avec PuTTY (Recommandé)
PuTTY est un client SSH gratuit et simple :
- Téléchargez et installez PuTTY
- Lancez PuTTY
- Dans "Host Name" : saisissez l'IP du Pi (ex:
192.168.1.42) - Port : 22 (par défaut)
- Connection type : SSH
- Cliquez sur "Open"
- Acceptez le certificat (première connexion)
- Login : timevox
- Mot de passe : celui configuré dans Raspberry Pi Imager
timevox@timevox:~ $
Étape 3 : Installation TimeVox
Exécuter le script d'installation automatique
🚀 Installation automatique de TimeVox
Une seule commande suffit pour installer tout le système :
curl -sSL https://raw.githubusercontent.com/Didtho/timevox/main/install.sh | bash
📋 Instructions d'installation :
- Copiez la commande ci-dessus (bouton "Copier")
- Collez-la dans votre terminal SSH (PuTTY)
- Appuyez sur Entrée pour lancer l'installation
- Patientez environ 10-15 minutes
- L'installation est entièrement automatique
📋 Le script va automatiquement :
- ✅ Mettre à jour le système Raspberry Pi OS
- 📦 Installer Python 3.9+ et pip
- 🎵 Installer FFmpeg pour le traitement audio
- 📚 Installer les bibliothèques Python (pygame, pydub...)
- ⚙️ Configurer les services systemd (démarrage auto)
- 🔧 Activer I2C, SPI et GPIO
- 📁 Créer la structure de dossiers TimeVox
- 🎛️ Configurer l'audio et les périphériques
- 🚀 Activer le service TimeVox au démarrage
🔄 Redémarrage final
Une fois l'installation terminée, redémarrez le système :
sudo reboot
📝 Logs d'installation (optionnel)
Si vous souhaitez suivre l'installation en détail :
Étape 4 : Test et personnalisation
Vérifier le fonctionnement et personnaliser selon vos besoins
🔌 1. Insérer la clé USB
Préparez une clé USB pour stocker les messages :
- Formatez une clé USB en FAT32 ou exFAT
- Insérez-la dans le Raspberry Pi
- Le système va automatiquement créer la structure :
🎵 2. Ajouter une annonce
Créez votre première annonce personnalisée :
- Enregistrez un fichier audio MP3 avec votre annonce
- Copiez-le dans le dossier
Annonce/de la clé USB - Le système choisira aléatoirement parmi les fichiers disponibles
📞 3. Premier test
Testez votre installation :
⚙️ 4. Configuration avancée
Personnalisez votre TimeVox via le menu 0000 :
🔧 Dépannage
Solutions aux problèmes les plus courants
🚫 Pas de connexion SSH
Causes possibles :
- SSH pas activé dans Raspberry Pi Imager
- Mauvais nom d'utilisateur/mot de passe
- WiFi mal configuré
Solutions :
- Vérifiez la LED WiFi (doit être allumée)
- Testez avec un câble Ethernet temporaire
- Reflashez la carte avec les bons paramètres
🔇 Pas de son
Vérifications :
- Amplificateur MAX98357A bien connecté
- Volume configuré (par défaut 2%)
- Fichier d'annonce présent sur USB
Test de diagnostic :
🎤 Enregistrement muet
Vérifications :
- Micro USB bien détecté
- Permissions audio correctes
- Niveau d'entrée suffisant
Test micro :
⏰ Mauvais horodatage
Solutions :
- Installer un module RTC DS3231
- Synchroniser l'heure via WiFi
- Vérifier la timezone
Commande de sync :
🆘 Besoin d'aide ?
Si vous rencontrez des difficultés, plusieurs ressources sont disponibles :
Installation terminée ?
Découvrez maintenant toutes les fonctionnalités avancées de TimeVox