Tutoriel : Installer l'extension HQPlayer Profile Switcher sur GentooPlayer
Pour utilisateurs de : GentooPlayer + Roon Core + HQPlayer Embedded
Bonjour à tous,
J'ai
bien galéré pour mettre en place cette extension sur GentooPlayer ! Entre les commandes qui ne fonctionnent pas, les sessions SSH qui s'arrêtent, et le RamSystem qui efface tout... ça n'a pas été simple
Pour ceux qui sont
à l'aise sous Linux, vous reconnaîtrez les manipulations classiques.
Mais pour
les autres (comme moi !), j'ai demandé à L IA de créer un Tutoriel
pas à pas pour vous éviter les heures de galère que j'ai passées. J'espère qu'il vous permettra de
switcher entre vos profils HQPlayer Embedded directement depuis l'application Roon, sans avoir à jongler entre plusieurs interfaces web !
Source originale :
HQPlayer Embedded Profile Switcher par Muness
Qu'est-ce que cette extension ?
L'extension
HQPlayer Profile Switcher vous permet de
changer vos profils HQPlayer directement depuis l'interface Roon, sans avoir à basculer entre plusieurs interfaces web.
roonlabs+1
Avantages :
- Changement de profil en un clic depuis Roon
- Contrôle via smartphone/tablette
- Modification des paramètres audio HQPlayer depuis Roon
- Plus besoin d'ouvrir l'interface web HQPlayer à chaque fois
⚙️
Prérequis
- GentooPlayer installé avec Roon Core et HQPlayer Embedded
- RamSystem désactivé (sinon l'installation sera perdue à chaque redémarrage)
- Accès SSH à votre GentooPlayer (via Putty sous Windows ou Terminal sous Mac/Linux)
- Connaître l'adresse IP de votre GentooPlayer (ex: 192.168.1.101)
⚠️ Vérifier que RamSystem est désactivé
Connectez-vous en SSH et tapez :
bash
df -h
Si la ligne
/
est montée sur un disque réel (comme
/dev/nvme0n1p3
ou
/dev/sda1
) et
non sur tmpfs, c'est bon ✅
Si RamSystem est encore actif, désactivez-le :
bash
ramsystem_disable
reboot
Reconnectez-vous en SSH après le redémarrage.
?
Étape 1 : Installer Node.js
Node.js est nécessaire pour faire tourner l'extension.
bash
emerge --ask nodejs
Le système vous demande confirmation. Tapez
Y puis appuyez sur
Entrée.
⏱️ L'installation prend 5-15 minutes (patience, Gentoo compile depuis les sources !).
Vérifiez l'installation :
bash
node -v
npm -v
Vous devriez voir les versions affichées (ex: v24.9.0 et 10.x.x). ✅
?
Étape 2 : Télécharger l'extension
bash
cd ~
git clone
https://github.com/muness/roon-extension...itcher.git
cd roon-extension-hqp-profile-switcher/extension
npm install
⏱️ L'installation des dépendances prend environ 1 minute.
Vous verrez peut-être quelques warnings en jaune/rouge -
c'est normal, ne vous inquiétez pas ! ✅
Étape 3 : Créer le service OpenRC
Important : GentooPlayer utilise
OpenRC (pas systemd comme la plupart des distributions Linux). C'est pour ça que les commandes
systemctl
ne fonctionnent pas !
3.1 Créer le fichier de service
bash
nano /etc/init.d/roon-hqp-extension
Vous entrez dans l'éditeur de texte nano.
3.2 Copier ce contenu
Copiez-collez
exactement ce texte (clic droit dans Putty pour coller) :
bash
#!/sbin/openrc-run
description="Roon HQPlayer Profile Switcher Extension"
command="/usr/bin/node"
command_args="/root/roon-extension-hqp-profile-switcher/extension/index.js"
command_background="yes"
pidfile="/run/roon-hqp-extension.pid"
depend() {
need net
after firewall
}
3.3 Sauvegarder le fichier
- Appuyez sur Ctrl + X (pour quitter)
- Appuyez sur Y (pour confirmer)
- Appuyez sur Entrée (pour valider le nom de fichier)
3.4 Rendre le script exécutable
bash
chmod +x /etc/init.d/roon-hqp-extension
Étape 4 : Activer et démarrer le service
Ajouter au démarrage automatique
bash
rc-update add roon-hqp-extension default
✅ Vous verrez :
* service roon-hqp-extension added to runlevel default
Démarrer le service
bash
rc-service roon-hqp-extension start
✅ Vous devriez voir :
* Starting roon-hqp-extension ... [ ok ]
Vérifier que ça tourne
bash
rc-service roon-hqp-extension status
✅ Résultat attendu :
* status: started
Bravo ! L'extension est maintenant active en permanence !
Vous pouvez fermer Putty, l'extension continuera de tourner.
Étape 5 : Configurer dans Roon
- Ouvrez Roon sur votre interface habituelle (PC, tablette, smartphone)
- Allez dans Paramètres → Extensions
- Vous devriez voir apparaître HQPlayer Profile Switcher
- Cliquez dessus pour ouvrir les paramètres
- Configurez :
- HQPlayer Host :
192.168.1.101:8088
(remplacez 192.168.1.101 par l'IP de votre GentooPlayer)
- Username : votre identifiant HQPlayer (laissez vide si vous n'avez pas configuré d'authentification)
- Password : votre mot de passe HQPlayer (laissez vide si non configuré)
- Cliquez sur Save
L'extension détectera automatiquement tous vos profils HQPlayer !
Commandes utiles
Gérer le service
bash
# Voir le statut
rc-service roon-hqp-extension status
# Arrêter le service
rc-service roon-hqp-extension stop
# Démarrer le service
rc-service roon-hqp-extension start
# Redémarrer le service
rc-service roon-hqp-extension restart
Retirer du démarrage automatique (si besoin)
bash
rc-update del roon-hqp-extension default
Dépannage
L'extension n'apparaît pas dans Roon
- Vérifiez que le service tourne :
bash
rc-service roon-hqp-extension status
- Vérifiez les processus Node.js actifs :
bash
ps aux | grep node
- Redémarrez le service :
bash
rc-service roon-hqp-extension restart
L'extension disparaît quand je ferme Putty
C'est que le service n'est pas lancé correctement. Vérifiez que vous avez bien :
- Créé le fichier dans
/etc/init.d/roon-hqp-extension
- Rendu le script exécutable avec
chmod +x
- Démarré le service avec
rc-service roon-hqp-extension start
Consulter les logs système
bash
tail -f /var/log/messages
⚠️
Notes importantes- ✅ L'extension démarre automatiquement au boot de GentooPlayer
- ✅ Elle reste active même quand vous fermez votre session SSH/Putty
- ✅ Elle se relance automatiquement en cas de crash
- ⚠️ Si vous réactivez RamSystem, l'installation sera perdue au prochain redémarrage !
Crédits
En conclusion
J'espère que ce tutoriel vous aura fait gagner du temps ! N'hésitez pas à poser vos questions si vous bloquez quelque part, on est là pour s'entraider
Bon changement de profils directement depuis Roon !