Décibel est un projet open-source permettant de créer, imprimer et jouer à un jeu de société moderne de type "Blind-Test" (inspiré de Hitster) à l'aide de véritables cartes physiques dotées de QR codes. Le jeu fonctionne via une Web App 100% statique (PWA) agissant comme un scanner natif.

🎮 Web App en ligne : https://antonincherre21.github.io/Decibel/

• Système Multi-Modes : Architecture modulable permettant d'ajouter facilement différents modes de jeu (music, movies, series).
• Web App PWA : Un scanner ultra-rapide (lecture de QR Codes en JS via la caméra), installable sur téléphone sans passer par l'App Store.
• Base de Données Légère : Utilisation du format JSON pour un chargement instantané dans la Web App.
• Automatisation Totale (Python) : Des scripts gèrent l'intégralité du cycle :
  • Connexion aux API (ex: iTunes) pour récupérer musiques, dates de sortie et pochettes HD.
  • Génération des QR Codes avec le logo de votre choix.
  • Mise en page automatique des cartes physiques (recto/verso) et génération des planches PDF prêtes à imprimer.

L'architecture est pensée pour être facilement hébergée sur GitHub Pages ou tout autre serveur statique (Apache, Nginx, OVH).

/Decibel
├── index.html # Le Menu Principal (choix du mode de jeu)
├── requirements.txt # Dépendances Python à installer
├── run_all.py # Le script principal pour tout générer !
├── webapp/ # Les fichiers de la Progressive Web App
│ ├── scanner.html # L'interface du scanner et du lecteur
│ ├── manifest.json # Configuration d'installation PWA
│ ├── sw.js # Service Worker (Cache offline)
│ └── img/ # Logos et icônes
├── modes/ # Dossier contenant tous les modes de jeu
│ ├── music/ # (Voir le README dans ce dossier pour plus de détails)
│ ├── movies/ # (À venir)
│ └── series/ # (À venir)
└── scripts/ # Les scripts Python d'automatisation
 ├── utils.py # Fonctions partagées (chemins, JSON, etc.)
 ├── 0_recherche_API.py
 ├── 1_download.py
 ├── 2_Verification_BDD.py
 ├── 3_generer_qrcodes.py
 ├── 4_generer_cartes_musique.py
 ├── 5_generer_planche_impression.py
 ├── recherche_pochette.py
 └── supprimer_musique.py

Le projet utilise un fichier requirements.txt qui liste toutes les librairies nécessaires. Pour les installer automatiquement en une seule commande :

pip install -r requirements.txt

Cela installera : requests, Pillow, qrcode[pil]. Aucune autre dépendance n'est requise (Python 3.9+ suffit).

1. Placez vos musiques dans modes/<mode>/to_add.json au format suivant :

   [
    {
    "Titre": "Nom de la chanson",
    "Artiste": "Nom de l'artiste",
    "Date": "YYYY-MM-DD",
    "Genre": "Pop",
    "Difficulté": "Facile"
    }
   ]

2. Ouvrez un terminal à la racine du projet et lancez :

   python run_all.py

3. Suivez les instructions à l'écran. Le script demandera pour quel mode travailler, puis exécutera la chaîne complète : Recherche API → Téléchargement Media → Génération QR → Génération Cartes → Génération PDF

Si une pochette récupérée automatiquement ne vous convient pas, vous pouvez en sélectionner une autre parmi les résultats iTunes :

python scripts/recherche_pochette.py --mode music

Le script vous permet de :

1. Rechercher une musique dans votre base par titre ou artiste.
2. Voir tous les résultats disponibles sur iTunes.
3. Choisir la pochette qui vous plaît le mieux.
4. Mettre à jour automatiquement la base de données et le fichier image local.

Certaines pochettes peuvent être mal cadrées sur la carte recto. Vous pouvez ajuster le zoom de deux façons :

Option A — Via db.json (méthode recommandée) : Ajoutez les champs optionnels zoom et/ou y_offset directement sur l'entrée dans modes/<mode>/db.json :

{
 "ID": 42,
 "Titre": "Ma chanson",
 "zoom": 1.15,
 "y_offset": -20
}

• zoom : facteur de zoom (ex: 1.15 = zoom +15%). Valeur par défaut : 1.0.
• y_offset : décalage vertical en pixels (positif = vers le bas, négatif = vers le haut). Valeur par défaut : 0.

Option B — Via la table ZOOMS_SPECIFIQUES dans le script 4 : Ouvrez scripts/4_generer_cartes_musique.py et ajoutez une entrée dans le dictionnaire ZOOMS_SPECIFIQUES en haut du fichier :

ZOOMS_SPECIFIQUES = {
 ...
 ("Titre de la chanson", "Nom de l'artiste"): {"ratio": 1.15, "y_offset": -20},
}

💡 La méthode A (via db.json) est préférable car elle ne nécessite pas de modifier le code.

Le dossier complet est hébergé sur GitHub Pages et accessible directement depuis n'importe quel smartphone.

🔗 https://antonincherre21.github.io/Decibel/

1. Ouvrez ce lien depuis un smartphone.
2. Cliquez sur le mode désiré (ex: Musique).
3. Acceptez l'utilisation de la caméra.
4. Flashez vos cartes imprimées. La musique ou l'extrait se lancera instantanément !

💡 Astuce Pro : Sur iOS/Android, cliquez sur "Partager" puis "Ajouter à l'écran d'accueil" pour installer le jeu comme une véritable application native, sans passer par l'App Store.

Vous pouvez imprimer vous-même vos cartes physiques sans avoir à exécuter les scripts Python. Les planches PDF prêtes à imprimer sont disponibles directement en téléchargement depuis les Releases GitHub du projet.

1. Rendez-vous sur la page des Releases du projet .
2. Identifiez le pack qui vous convient :
   • Packs Complets (-complet) : Contiennent l'intégralité des cartes d'un mode (ex: music-complet). Idéal pour une première impression.
   • Packs de Nouveautés (-pack-XXX) : Contiennent uniquement les nouvelles cartes ajoutées depuis le pack précédent. Idéal si vous avez déjà imprimé les versions antérieures.
   • Pack Global (all-complet) : Regroupe tous les modes de jeu en un seul fichier.
3. Téléchargez et décompressez le fichier ZIP correspondant.
4. Vous obtenez un ensemble de fichiers PDF planche_001.pdf, planche_002.pdf, etc.

Chaque planche contient 6 cartes (2 colonnes ×ばつ 3 lignes) au format A4, avec le recto et le verso sur des pages séparées pour une impression recto/verso correcte.

Pour un rendu de qualité comparable à un jeu du commerce :

Étapes recommandées :

1. Imprimer les planches avec votre imprimante recto/verso sur papier photo.
2. Découper les cartes : chaque feuille contient 6 cartes. Utilisez un massicot (ou des ciseaux) en suivant les marges.
3. (Optionnel mais très recommandé) Plastifier les cartes à la plastifieuse (pochettes 80 ou 100 microns) pour une durabilité maximale et un beau rendu brillant.
4. Ranger dans une boîte de jeu, un étui à cartes ou une pochette zip.

💡 Astuce : Imprimez d'abord une seule feuille test en brouillon pour vérifier l'alignement recto/verso avant de lancer tout le lot.