Découvrez comment XiaoMusic transforme votre enceinte XiaoAI, la libérant des contraintes de lecture en ligne pour devenir un puissant lecteur de musique locale. Ce projet open-source en Python vous permet de gérer votre bibliothèque musicale personnelle et d'intégrer des téléchargements automatiques via yt-dlp, offrant ainsi une liberté musicale sans précédent.

Fonctionnalités clés de XiaoMusic 🎵

XiaoMusic réinvente l'utilisation de votre enceinte intelligente en proposant une gestion avancée et une lecture de musique personnalisée. Profitez d'une expérience utilisateur enrichie grâce à des commandes vocales intuitives et à une intégration transparente de vos sources musicales.

Contrôle vocal avancé

• "Joue ma musique" : Lance la lecture de votre bibliothèque locale.
• "Joue [Nom de la chanson] par [Artiste]" : Recherche et lance un morceau spécifique.
• "Morceau suivant" / "Morceau précédent" : Naviguez facilement dans votre playlist.
• "Lecture aléatoire" / "Répéter tout" / "Répéter un" : Adaptez le mode de lecture à vos envies.

Téléchargement intelligent de musique

• Intégration de yt-dlp pour le téléchargement automatique de contenu en ligne.
• Support des formats audio courants : mp3, flac, wav, ape, ogg, m4a.
• Organisation automatisée et catégorisation intelligente de votre collection musicale.

Compatibilité étendue

• Support de nombreux modèles d'enceintes XiaoAI : L06A, L07A, S12/S12A, LX5A, etc.
• Gestion centralisée pour une expérience multi-appareils cohérente.

Installation simplifiée : Votre enceinte prête en 3 étapes

Déploiement via Docker (méthode recommandée)

Pour une installation rapide et sans tracas, Docker est la solution idéale. Créez un fichier docker-compose.yml avec la configuration suivante :

services:
 xiaomusic:
   image: hanxi/xiaomusic
   container_name: xiaomusic
   restart: unless-stopped
   ports:
     - "58090:8090"
   volumes:
     - "/chemin/vers/musique:/app/music"
     - "/chemin/vers/configuration:/app/conf"

Configuration :

• /chemin/vers/musique : Répertoire pour stocker vos fichiers audio.
• /chemin/vers/configuration : Répertoire pour les fichiers de configuration.
• Accès via l'adresse : http://<ip_de_votre_nas>:58090</ip_de_votre_nas>

Installation manuelle (via Pip)

Si vous préférez une approche sans Docker, utilisez Pip :

# Installation de XiaoMusic
pip install -U xiaomusic

# Lancement du service
xiaomusic --config config.json

Maîtrisez les commandes vocales 🗣️

La force de XiaoMusic réside dans son contrôle vocal intuitif, vous permettant de gérer votre musique sans effort.

Commandes de base

Commande Vocale	Description	Exemple
Joue ma musique	Lance la lecture de la bibliothèque locale.	"Joue ma musique"
Joue [Chanson] par [Artiste]	Recherche et lance un morceau spécifique.	"Joue La Javanaise par Gainsbourg"
Morceau suivant / précédent	Navigation dans la liste de lecture.	"Morceau suivant"
Arrête la lecture	Interrompt la diffusion.	"Arrête la lecture"

Fonctionnalités avancées

Commande Vocale	Description	Usage
Rafraîchis la bibliothèque	Met à jour la liste des morceaux disponibles.	Après l'ajout de nouveaux titres.
Ajoute aux favoris	Marque le titre courant comme favori.	Pour enregistrer un coup de cœur.
Recherche [Mot-clé]	Recherche intelligente dans la bibliothèque.	"Recherche musique classique"

Astuce exclusive

Dites à votre enceinte "Joue l'histoire de Peppa Pig" et XiaoMusic téléchargera automatiquement le contenu avant de le diffuser. Idéal pour divertir les enfants !

Compatibilité des appareils : Un large éventail d'enceintes prises en charge 📱

XiaoMusic a été testé et validé pour fonctionner avec une variété de modèles XiaoAI :

Modèle	Nom Commun	Formats Audio Supportés
L06A	Enceinte XiaoAI	mp3, wav, ogg, m4a
L07A	Enceinte XiaoAI Play	mp3, wav, ogg, m4a
S12/S12A	Enceinte XiaoMi AI	mp3, wav, ogg, m4a
LX5A	Enceinte XiaoAI Contrôle Universel	mp3, wav, ogg, m4a
L05B	Enceinte XiaoAI Play	mp3, wav, ogg, m4a (flac non supporté)

Note : Les modèles L05B, L05C, LX06, L16A ne supportent pas le format FLAC. Activez l'option "Conversion en MP3" dans les paramètres pour résoudre les problèmes de compatibilité.

Listes de lecture en ligne et fonctionnalités avancées 🎼

Configuration des listes de lecture web

XiaoMusic peut lire des listes de lecture au format JSON. Vous pouvez créer vos propres listes, utiliser des convertisseurs M3U ou importer celles partagées par d'autres utilisateurs.

Consultez docs/issues/78.md pour plus de détails.

Personnalisation des commandes vocales

Modifiez le fichier xiaomusic/config.py pour adapter les commandes vocales à vos préférences. Ce fichier centralise toutes les correspondances entre les commandes et leurs actions.

Architecture technique et développement 🔧

Technologies backend

• Langage/Framework : Python avec FastAPI.
• Modules principaux : xiaomusic/api/ pour les routes et la logique métier.
• Utilitaires : xiaomusic/utils/ pour la gestion des fichiers et les outils réseau.
• Extensibilité : Système de plugins/ pour ajouter de nouvelles fonctionnalités.

Mise en place de l'environnement de développement

# 1. Téléchargement des dépendances
./install_dependencies.sh

# 2. Installation de l'environnement
pdm install

# 3. Démarrage du service
pdm run xiaomusic.py

Une fois lancé, accédez à http://localhost:8090/docs pour consulter la documentation complète de l'API.

Conseils de sécurité importants 🔒

Sécurisation de l'accès public

Si vous exposez XiaoMusic sur Internet :

1. Activez l'authentification par mot de passe.
2. Utilisez un mot de passe complexe.
3. Évitez les réseaux Wi-Fi publics non sécurisés.

Protection de votre compte

Avertissement : Il est déconseillé d'utiliser un compte Xiaomi lié à des caméras de sécurité avec XiaoMusic. Des bugs potentiels pourraient compromettre la sécurité de votre vie privée en cas de fuite d'identifiants.

Dépannage des problèmes courants ❓

Problèmes de configuration

En cas de problèmes d'accès à l'interface après une mise à jour :

1. Supprimez le fichier setting.json existant.
2. Redémarrez XiaoMusic. Un nouveau fichier de configuration sera généré automatiquement.

Problèmes de lecture musicale

• Format non supporté : Activez l'optoin "Conversion en MP3".
• Appareil non reconnu : Vérifiez que votre modèle est dans la liste de compatibilité.
• Échec du téléchargement : Assurez-vous que votre connexion Internet est stable et que la configuration de yt-dlp est correcte.

Scénarios d'utilisation concrets 🏠

Centre musical familial

Déployez XiaoMusic sur un NAS domestique pour créer un système audio centralisé contrôlable par plusieurs enceintes XiaoAI. Chaque pièce peut diffuser sa propre musique.

Gestion de bibliothèque personnelle

Utilisez la fonction de téléchargement automatique pour enrichir et organiser votre collection musicale personnalisée à partir de diverses sources.

Éveil musical pour enfants

Diffusez des histoires, des comptines et des chansons pour enfants via des commandes vocales simples, stimulant ainsi le développement lingiustique et auditif des plus jeunes.

Maintenance et mises à jour du projet 🔄

Obtenir la dernière version

# Mise à jour Docker
docker pull hanxi/xiaomusic

# Mise à jour Pip
pip install -U xiaomusic

Sauvegarde des données

Avant toute mise à jour, sauvegardez impérativement :

• Le répertoire de musique : /chemin/vers/musique
• Le répertoire de configuration : /chemin/vers/configuration

Assistance et communauté 🤝

Ressources officielles

• Dépôt du projet : https://gitcode.com/GitHub_Trending/xia/xiaomusic
• FAQ : Consultez docs/issues/ pour les questions fréquentes.
• Documentation : docs/ pour un guide d'utilisation complet.

Canaux de discussion

• GitHub Issues : Pour signaler des bugs ou proposer des améliorations.
• Groupes de discussion (QQ/WeChat) : Échangez en temps réel avec d'autres utilisateurs et développeurs.

XiaoMusic n'est pas seulement un projet technique ; c'est une révolution pour l'expérience musicale dans votre maison connectée. En combinant la puissance de votre enceinte XiaoAI avec votre bibliothèque musicale personnelle, bénéficiez d'un contrôle vocal pratique et d'une liberté de choix illimitée. Lancez-vous dès aujourd'hui et donnez une nouvelle vie à votre enceinte XiaoAI !