Table des matières
Jeedom : 4.4 ou supérieur
Communication : locale via FiiO Link TCP 12100 et catalogue HTTP 12103
Présentation
FiiO Control permet de découvrir et piloter depuis Jeedom des lecteurs audio compatibles FiiO Link, sans dépendre d’un service cloud pour le contrôle courant ou la synchronisation des morceaux musicaux.

Principales fonctions :
- découverte réseau ;
- connexion persistante au lecteur ;
- lecture, pause, précédent, suivant ;
- volume et position ;
- informations du morceau et pochette ;
- favoris ;
- réglages audio ;
- fichiers de la carte SD et catalogue ;
- artistes, albums, genres, playlists et file ;
- synchronisation depuis SMB/CIFS ;
- thèmes de l’écran verrouillé ;
- page Santé et diagnostic.
Prérequis
- Jeedom 4.4 ou supérieur ;
- appareil FiiO compatible FiiO Link ;
- ports 12100 et 12103 accessibles depuis Jeedom ;
smbclientpour les fonctions SMB ;ffmpeg/ffprobepour certaines analyses de fichiers.
Configuration
Ouvrez Plugins → Gestion des plugins → FiiO Control.

Le champ CIDR ou adresse IP accepte soit une adresse précise, soit un réseau à balayer. Pour une installation stable, une IP fixe est recommandée.
La découverte automatique peut être activée avec un intervalle configurable.
Le daemon maintient une connexion FiiO Link persistante et reçoit les changements en temps réel.
Sur le Snowsky testé, un seul client FiiO Link peut être connecté simultanément. Pour utiliser l’application mobile FiiO Control, arrêtez temporairement le daemon Jeedom.
La section SMB/CIFS permet de configurer la source musicale : serveur, partage, répertoire initial, utilisateur et mot de passe.
Découverte des équipements

Le bouton Découvrir recherche les appareils sur le réseau configuré.
Un équipement est créé avec son nom, son IP, son état de connexion, ses informations et ses commandes compatibles.
Dashboard

Le widget affiche la lecture en cours, la pochette, le format audio, la progression et donne accès aux commandes de transport, au volume, aux favoris et aux principaux réglages audio.
File de lecture

La file est paginée. Le morceau courant est surligné et un autre morceau peut être lancé directement.
Fichiers et bibliothèque

Les vues disponibles comprennent :
- Dossiers ;
- Morceaux ;
- Artistes ;
- Albums ;
- Genres ;
- Favoris ;
- File ;
- Playlists.
La carte SD est parcourue à partir de /tmp/sdcard.
Synchronisation SMB

Le volet gauche représente la source Samba et le volet droit la carte SD du lecteur.
Le plugin peut analyser les différences puis copier les éléments sélectionnés vers le Snowsky.
La copie est unidirectionnelle :
SMB → Snowsky
Aucun fichier présent uniquement sur le lecteur n’est supprimé automatiquement.
Thèmes de l’écran verrouillé

Le plugin peut lire et modifier les thèmes système ainsi qu’un emplacement personnalisé.
L’image personnalisée doit être un fichier PNG 360 × 360 pixels.
Les options exposées comprennent l’opacité, la couleur du texte, le style et l’affichage de l’heure, de la date, de la batterie et des informations du morceau.
Santé

La page Santé présente les équipements, les appareils actifs, ceux qui répondent correctement et ceux à vérifier.
Elle contrôle également la présence des composants nécessaires : PHP CLI, cURL, smbclient, configuration réseau, etc.
Logs utiles :
fiiocontrolfiiocontrol_daemon
Dépannage
Le lecteur reste hors ligne
Vérifiez l’IP, la connectivité réseau et les ports 12100 / 12103.
L’application FiiO Control ne se connecte plus
Arrêtez temporairement le daemon Jeedom : le firmware n’accepte généralement qu’un seul client FiiO Link.
La découverte est lente
Configurez directement l’adresse IP du lecteur au lieu d’un CIDR large.
Les thèmes ne s’affichent pas
Vérifiez le port 12103 et, pour un thème personnalisé, utilisez un PNG 360 × 360.
Limites
- un seul client FiiO Link simultané sur certains firmwares ;
- espace libre de la carte SD non exposé de manière fiable ;
- batterie pas toujours publiée sur toutes les versions de firmware ;
- pas d’empreinte fiable pour comparer tous les fichiers ;
- copie SMB uniquement vers le lecteur ;
- certaines fonctions internes de DiskOS ne sont volontairement pas exposées tant que leur transport réseau n’est pas validé.
![]()
