Roon

[jean-luc]

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

1. GentooPlayer installé avec Roon Core et HQPlayer Embedded
   
2. RamSystem désactivé (sinon l'installation sera perdue à chaque redémarrage)
   
3. Accès SSH à votre GentooPlayer (via Putty sous Windows ou Terminal sous Mac/Linux)
   
4. 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

1. Ouvrez Roon sur votre interface habituelle (PC, tablette, smartphone)
   
2. Allez dans Paramètres → Extensions
   
3. Vous devriez voir apparaître HQPlayer Profile Switcher
   
4. Cliquez dessus pour ouvrir les paramètres
   
5. 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é)
     
6. 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

1. Vérifiez que le service tourne :
   
   bash
   rc-service roon-hqp-extension status
   
   
2. Vérifiez les processus Node.js actifs :
   
   bash
   ps aux | grep node
   
   
3. 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

• Extension créée par Muness : GitHub - roon-extension-hqp-profile-switcher
  
• Discussion originale : Roon Community Forum
  

---

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 ! 

---