Installer Hyperion sur Raspberry Pi (Guide pas à pas)

J’ai des ampoules connectées Philips Hue à la maison et je suis fasciné par le nombre de projets que l’on peut faire avec. J’ai déjà écrit sur la façon de contrôler ces lumières en Python, avec Home Assistant, etc. Hyperion est un autre outil que vous pouvez utiliser, dont le but principal est d’améliorer votre expérience télévisuelle en liant les couleurs des lumières au film que vous regardez. Voyons comment l’installer sur un Raspberry Pi.

Hyperion a des paquets et des dépôts disponibles pour la plupart des systèmes d’exploitation et des architectures et le Raspberry Pi est supporté. Après avoir ajouté le dépôt officiel sur Raspberry Pi OS, vous pouvez l’installer avec APT.

Si vous avez l’habitude d’installer de nouvelles applications et de nouveaux services sur votre Raspberry Pi, cela devrait être assez simple, alors allons droit au but.

À propos, si vous débutez sur Raspberry Pi et que vous souhaitez accélérer les choses (tout en vous amusant), n’hésitez pas à télécharger mon e-book Maitrisez Raspberry Pi en 30 jours. Il s’agit d’un défi de 30 jours dans lequel vous apprendrez une nouvelle compétence chaque jour. Vous économiserez du temps et de l’argent et pourrez enfin profiter de votre Raspberry Pi à son plein potentiel. Je vous offre d’ailleurs 10% de remise aujourd’hui si vous utilisez ce lien !

Installer Hyperion sur Raspberry Pi

Obtenir une distribution supportée sur votre Raspberry Pi

Hyperion est supporté par de nombreuses distributions (Debian, Ubuntu, Fedora, etc.), et c’est une application légère, donc vous pouvez probablement conserver votre installation actuelle. Mais, assurez-vous que votre système est prêt avant d’aller plus loin :

• Installez Raspberry Pi OS ou une autre distribution si nécessaire (Ubuntu, DietPi, etc).
• Connectez-le à votre réseau et à Internet (via Ethernet ou Wi-Fi).
  Vous devrez également obtenir son adresse IP actuelle (consultez cet article si vous avez besoin d’aide à ce sujet).
• Faites les mises à jour du système :
  sudo apt update && sudo apt upgrade -y
• Facultatif : utilisez SSH pour contrôler votre Raspberry Pi depuis votre ordinateur.
  Je fais généralement cela, afin de pouvoir copier-coller les commandes de la documentation ou du tutoriel que je suis.

Je teste ceci pour vous avec un Raspberry Pi 4, exécutant Raspberry Pi OS Bullseye (64-bit). Vous pourriez remarquer quelques légers changements en fonction de votre configuration, mais dans l’ensemble le processus d’installation devrait être le même.

Note : Si vous voulez tester, Hyperion a aussi une distribution personnalisée, appelée HyperBian. Il s’agit d’une version personnalisée de Raspberry Pi OS avec Hyperion pré-installé. Elle semble à jour, donc cela peut être une solution.

Installer Hyperion

Voici les étapes pour installer Hyperion sur un système basé sur Debian :

• Ouvrez un terminal ou connectez-vous via SSH.
• La première chose à faire est d’ajouter la clé pour le dépôt Hyperion :
  wget -qO- https://apt.hyperion-project.org/hyperion.pub.key | sudo gpg --dearmor -o /usr/share/keyrings/hyperion.pub.gpg
• Ensuite, vous pouvez ajouter le dépôt à votre liste de sources :
  echo "deb [signed-by=/usr/share/keyrings/hyperion.pub.gpg] https://apt.hyperion-project.org/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hyperion.list
• Mettez à jour la liste des paquets :
  sudo apt update
• Installez Hyperion :
  sudo apt install hyperion

Si tout se passe bien, il installera tous les paquets requis (y compris Hyperion) et vous donnera quelques informations une fois terminé :

Prenez note de l’URL indiquée, car vous en aurez besoin pour l’étape suivante. En théorie, il devrait s’agir de l’adresse IP de votre Raspberry Pi, accessible via le port 8090 (ou 8091 si vous avez déjà un service fonctionnant sur le port par défaut).

Vous devrez peut-être aussi redémarrer votre Raspberry Pi pour terminer l’installation. Hyperion activera SPI pour vous, juste au cas où vous en auriez besoin avec certaines de vos lumières plus tard.
Vous pouvez le redémarrer avec une ligne de commande :
sudo reboot

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Tester le bon fonctionnement d’Hyperion

Après l’installation d’Hyperion sur votre Raspberry Pi, vous devriez pouvoir accéder à l’interface web à l’adresse suivante :
http://<IP_ADDRESS>:8090
Vous allez maintenant tout configurer à partir de là, prenez un instant pour vérifier que tout fonctionne.

Vous avez presque terminé. Vous pouvez maintenant parcourir le menu et les options de configuration, puis modifier ce que vous voulez. Par exemple, vous pouvez passer à votre langue maternelle en cliquant sur l’icône de la clé à molette dans le coin supérieur droit.

Ajoutez vos lumières connectées à Hyperion

Hyperion prend en charge un large éventail de lumières connectées, vous devriez donc pouvoir vous connecter aux vôtres facilement.

Pour ajouter votre LED à l’interface, allez dans Instances LED > Sortie LED via le menu de gauche, et sélectionnez le type de contrôleur dont vous disposez.
Personnellement, j’utilise les lumières Philips Hue, je vais donc partager mon expérience avec elles. Mais la procédure avec d’autres marques devrait être similaire. Évidemment, si vos lumières sont connectées aux broches GPIO, il y a quelques étapes supplémentaires et chaque configuration sera différente.

J’ai d’abord essayé de remplir le formulaire manuellement, mais cela n’a pas fonctionné. J’ai eu une erreur « Invalid port » dans les journaux (à propos, vous pouvez vérifier les journaux sous System dans le menu de gauche, ce sera très utile pour comprendre tout problème que vous pourriez avoir).

Ensuite, j’ai remarqué qu’il y avait un assistant pour connecter Hyperion à mon pont Philips Hue.
C’était beaucoup plus facile, il a détecté mon contrôleur automatiquement, j’ai juste eu à appuyer sur le bouton pour permettre la connexion.
Une fois connecté, mes lumières étaient disponibles dans l’interface. J’ai alors juste eu à régler leur position pour qu’elles correspondent aux couleurs d’affichage de mon écran.

La configuration idéale consiste à disposer d’une bande lumineuse sur chaque côté de votre écran ou de votre téléviseur (haut, bas, gauche, droite).

Vous avez ensuite plusieurs choix pour capturer le flux multimédia, en fonction du matériel que vous utilisez. Chaque configuration est différente, mais en gros, vous devez la configurer sous « Capturing hardware » dans le menu principal de gauche. Il peut s’agir d’une simple capture d’écran, ou de périphériques externes, comme un périphérique de capture vidéo ou même une caméra.

Vous trouverez toutes les informations pour le configurer à votre façon sur leur documentation officielle. Ils ont également un forum assez actif, alors n’hésitez pas à y poser des questions si vous êtes perdu quelque part.

Vous pouvez également regarder la fin de cette vidéo pour un exemple concret :

Ressources supplémentaires pour votre Raspberry Pi

Initiation au Raspberry Pi en vidéo
Si vous débutez et voulez passer rapidement à la vitesse supérieure, j’ai exactement ce qu’il vous faut.
Regardez ma formation vidéo qui vous aidera à démarrer du bon bien, choisir votre matériel, installer les meilleures applications et vous lancer directement dans vos premiers projets avec mon aide.
Regarder les vidéos dès maintenant

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources