🎵 Première Installation - Guide Complet

Suivez ce guide étape par étape pour configurer votre jukebox en quelques minutes

1
Bienvenue dans JukeBox-Cab
2
Ajout des dossiers de musique
3
Scanner initial de votre bibliothèque
4
C'est prêt !
🎵

Étape 1 : Bienvenue dans JukeBox-Cab

Configuration initiale de votre jukebox

Au premier lancement, JukeBox-Cab vous guide pour configurer votre bibliothèque musicale. Cette étape est essentielle pour profiter pleinement de l'application.

📁

Étape 2 : Ajout des dossiers de musique

Sélectionnez où se trouve votre musique

Cliquez sur '📁 Ajouter un dossier' et sélectionnez les emplacements contenant votre collection musicale. Vous pouvez ajouter plusieurs dossiers :

  • Disques durs locaux (C:\, D:\, etc.)
  • Disques externes USB
  • Dossiers réseau (NAS)
  • Plusieurs emplacements simultanément

💡 Conseils

  • 💡 Créez un sous-dossier par artiste pour que vos musiques soient détectées
  • 💡 Les sous-dossiers dans les artistes deviennent des albums
  • 💡 Ajoutez une image 'folder.jpg' dans vos dossiers pour les pochettes

⚠️ Règle essentielle : votre musique DOIT être dans des sous-dossiers

JukeBox-Cab considère chaque sous-dossier comme un artiste. Les fichiers musicaux placés directement à la racine du dossier configuré sont IGNORÉS.

✅ Ça marche

Dossier configuré : D:\Musiques
D:\Musiques
├── Queen/
│   ├── 01 - Bohemian Rhapsody.mp3
│   └── 02 - We Will Rock You.mp3
├── ABBA/
│   └── 01 - Dancing Queen.mp3
└── Daft Punk/
    └── 01 - Get Lucky.mp3
Les fichiers sont dans des sous-dossiers (Queen, ABBA, Daft Punk) → chaque sous-dossier devient un artiste

✅ Ça marche aussi

Dossier configuré : C:\
C:\
├── Queen/
│   └── A Night at the Opera/
│       └── 01 - Bohemian Rhapsody.mp3
└── ABBA/
    └── Gold/
        └── 01 - Dancing Queen.mp3
Même si le dossier configuré est la racine C:\, il contient des sous-dossiers d'artistes

❌ Ça ne marche PAS

Dossier configuré : D:\Musiques
D:\Musiques
├── Bohemian Rhapsody.mp3
├── Dancing Queen.mp3
├── Get Lucky.mp3
└── Imagine.mp3
Les fichiers sont directement dans le dossier configuré, sans sous-dossier → AUCUNE musique ne sera détectée

⚠️ Cas mixte : partiellement détecté

Dossier configuré : D:\Musiques
D:\Musiques
├── Queen/
│   └── 01 - Bohemian Rhapsody.mp3  ✅ détecté
├── ABBA/
│   └── 01 - Dancing Queen.mp3      ✅ détecté
├── Get Lucky.mp3                    ❌ ignoré
└── Imagine.mp3                      ❌ ignoré
Seuls les fichiers dans les sous-dossiers (Queen, ABBA) seront détectés. Les fichiers à la racine (Get Lucky, Imagine) seront ignorés.
En résumé : créez au minimum un sous-dossier par artiste et placez-y vos fichiers musicaux. Ne mettez jamais vos fichiers directement dans le dossier principal.

🎵 Formats Audio

MP3 FLAC WAV AAC OGG

🎬 Formats Vidéo

MP4 MKV
⚡

Étape 3 : Scanner initial de votre bibliothèque

Indexation automatique de vos fichiers

Une fois vos dossiers ajoutés, cliquez sur '🚀 Démarrer le Jukebox'. Le scanner va :

🔄 Processus :

  • Explorer récursivement tous vos dossiers
  • Détecter automatiquement les fichiers audio et vidéo
  • Extraire les métadonnées (titre, artiste, album, durée)
  • Identifier les pochettes d'albums (folder.jpg/png)
  • Créer une base de données SQLite locale
  • Organiser par Artistes → Albums → Pistes
⏱️ Durée : Variable selon la taille de votre collection cela peut aller à plusieurs minutes
⚠️ Le scan initial peut prendre du temps. Laissez l'application travailler !
🎉

Étape 4 : C'est prêt !

Votre jukebox est opérationnel

Une fois le scan terminé, vous accédez immédiatement à votre bibliothèque organisée. Naviguez entre vos artistes, albums et créez vos premières playlists !

🚀 Étapes Suivantes :

✓

Explorez vos artistes via la grille principale

✓

Ajoutez des pistes à une playlist

✓

Configurez les paramètres selon vos préférences

✓

Profitez de votre musique !

📂

📂 Structure de dossiers obligatoire

Organisez vos fichiers pour une meilleure expérience

Votre dossier de musique doit obligatoirement contenir des sous-dossiers. Les fichiers placés directement à la racine du dossier configuré ne seront pas détectés.

  • 🔴 OBLIGATOIRE : vos fichiers musicaux doivent être dans des sous-dossiers
  • 🔴 Les fichiers à la racine du dossier configuré sont IGNORÉS
  • 🟢 Chaque sous-dossier du premier niveau est considéré comme un artiste
  • 🟢 Les sous-sous-dossiers sont considérés comme des albums
Dossier configuré (ex: D:\Musiques)
├── Queen/                          ← sous-dossier = artiste
│   ├── folder.jpg                  ← pochette artiste (optionnel)
│   ├── A Night at the Opera/       ← sous-sous-dossier = album
│   │   ├── folder.jpg              ← pochette album (optionnel)
│   │   ├── 01 - Bohemian Rhapsody.mp3
│   │   └── 02 - Love of My Life.mp3
│   └── Greatest Hits/
│       └── ...
├── ABBA/                           ← autre artiste
│   └── Gold/
│       └── 01 - Dancing Queen.mp3
└── Videos/
    └── Queen - Live Aid 1985.mp4

💡 Bonnes Pratiques

  • Utilisez 'folder.jpg' ou 'folder.png' pour les pochettes
  • Nommez vos fichiers de façon cohérente (ex: '01 - Titre.mp3')
  • Les tags ID3 sont automatiquement lus
🔧

Résolution de Problèmes

Solutions aux problèmes courants

❓ Les pochettes ne s'affichent pas

Solutions :

  • Vérifiez que les fichiers 'folder.jpg' ou 'folder.png' existent
  • Assurez-vous que les images ne sont pas corrompues
  • Relancez un scan de la bibliothèque

❓ Le scan est très lent

Solutions :

  • C'est normal pour de grandes collections (patience !)
  • Vérifiez que le disque n'est pas en veille
  • Les scans suivants sont plus rapides (cache)

❓ Aucune musique détectée après le scan

Solutions :

  • Vérifiez que vos fichiers ne sont pas directement à la racine du dossier configuré : ils DOIVENT être dans des sous-dossiers (un par artiste)
  • Exemple correct : D:\Musiques\Queen\chanson.mp3 (Queen est un sous-dossier)
  • Exemple incorrect : D:\Musiques\chanson.mp3 (fichier à la racine = ignoré)
  • Consultez le Guide d'Installation pour voir la structure de dossiers obligatoire

❓ Certains fichiers ne sont pas détectés

Solutions :

  • Vérifiez le format (doit être MP3, FLAC, WAV, AAC, OGG, MP4 ou MKV)
  • Assurez-vous que les fichiers ne sont pas corrompus
  • Vérifiez les permissions du dossier
  • Si les fichiers sont à la racine du dossier configuré (et non dans un sous-dossier), ils seront ignorés

❓ La vidéo ne s'affiche pas sur le second écran

Solutions :

  • Configurez l'écran vidéo dans Paramètres → Écrans
  • Activez 'Ouvrir automatiquement la fenêtre vidéo'
  • Testez avec le bouton 'Tester la fenêtre vidéo'

🎉 Vous êtes Prêt !

Votre JukeBox-Cab est maintenant configuré. Profitez de votre musique comme jamais auparavant !

⬇️ Télécharger Maintenant 📚 Voir Toutes les Fonctionnalités

Besoin d'aide ? Consultez notre section Astuces