assistant-freebox
Advanced tools
Plugin Freebox pour un Assistant via le package assistant-plugins
Ce plugin de assistant-plugins permet de contrôler la Freebox Révolution.
Consulter le changelog pour connaitre les dernières mises à jour.
ATTENTION : vous n'avez besoin QUE du plugin assistant-freebox pour piloter la Freebox (pas besoin de assistant-ifttt ou assistant-wait, ou autre....).
Le seul autre plugin que vous pouvez ÉVENTUELLEMENT installer, est le plugin assistant-notifier, et SEULEMENT dans le cas où vous avez un Google Home chez vous. En effet, si vous utilisez la commande vocale va dans le dossier ..., alors un message est envoyé au Google Home pour dire si le dossier a été trouvé ou non. Pour le moment, c'est la seule utilisation du retour vocal vers le Google Home.
Si vous n'avez pas installé assistant-plugins, alors il faut le faire, et sélectionner freebox comme plugin.
Si vous avez déjà installé assistant-plugins, et que vous souhaitez ajouter ce plugin, alors :
install_freebox.bat dans le répertoire assistant-plugins, puis l'exécuter en double-cliquant dessus.assistant-plugins et taper :npm install assistant-freebox@latest --save --loglevel error && npm run-script postinstall/!\ Attention : pour que le plugin soit fonctionnel, il faut activer le AirMedia sur la Freebox en allant dans Réglages → Applications → AirMedia Video puis activer AirMedia.
Éditer le fichier configuration.json du répertoire assistant-plugins.
Dans la section concernant le plugin freebox, on trouve plusieurs paramètres. Le seul important qu'il vous faut modifier est code_telecommande.
code_telecommandeAllumer la Freebox, aller complètement à gauche dans la section Réglages, puis descendre jusqu'à Système, puis dans Informations Freebox Player et Server.
Dans le premier onglet vous trouverez le code télécommande réseau. Inscrire ce nombre dans le fichier de configuration.
box_to_controlPar défaut c'est la box dénommée hd1 qui est pilotée, mais il arrive que ce soit hd2.
search_pathUne des fonctionnalités est la possibilité de se déplacer dans un dossier de la Freebox qui se trouve dans "Mes Vidéos".
Par exemple, en disant « OK Google, va dans le dossier Star Trek ». Il va alors fouiller dans la zone indiquée par search_path (qui est /Disque dur/Vidéos/ qui est Mes Vidéos dans le menu de la Freebox).
Il est conseillé de réduire la zone de recherche. Par exemple, supposons que vous voulez seulement rechercher parmi vos séries télé qui sont stockées dans Perso/Mes Séries/, alors mettre /Disque dur/Vidéos/Perso/Mes Séries/.
Attention, search_path ne fonctionne qu'avec le disque dur de la Freebox (cela ne fonctionne PAS avec un disque dur sur le réseau). Pour se déplacer dans un disque dur/répertoire distant (type NAS), il faudra créer sa propre applet IFTTT qui donnera les commandes pour se déplacer jusque dans le dossier en question (du style freebox_home,right,right,ok,down,ok). Si besoin d'aide, merci de poster un nouvel issue.
use_Mon_BouquetÀ mettre à true si vous souhaitez que le lancement de la télé se fasse dans le menu Mon Bouquet (vos chaines favorites) plutôt que dans Freebox TV.
use_Chaines_CANALÀ mettre à true si vous souhaitez que le lancement de la télé se fasse dans le menu Les chaines CANAL plutôt que dans Freebox TV. En activant ce paramètre, les chaines sont numérotées pour supporter l'ordre fourni par Canal et non celui de Free.
check_player_onCelui-ci n'est à ajouter que si vous avez des problèmes lorsque le programme vérifie si la Freebox est allumée. Vérifiez d'abord que AirMedia est bien activé (comme inidqué plus haut sur cette page) et essayez de redémarrer votre box.
Si cela ne fonctionne pas et que le programme continue à ne pas réussir à détecter si la Freebox est allumée ou éteinte, alors vous pouvez ajouter le paramètre check_player_on en le mettant à la valeur false.
player_ipSi vous utilisez un VPN sur l'ordinateur où tourne assistant-plugins alors le controle de la Freebox va échouer. Pour remédier à ce problème vous devez ajouter le paramètre player_ip dans le fichier configuration.json en y indiquant l'adresse IP du Freebox Player. Pour trouver cette IP vous pouvez regarder cette vidéo.
server_ipSi vous utilisez un VPN sur l'ordinateur où tourne assistant-plugins alors le controle de la Freebox pourrait échouer. Si vous avez déjà ajouté le paramètre player_ip (ci-dessus), alors vous devez aussi fournir l'IP de la Freebox Serveur dans le fichier configuration.json. Par défaut cette IP est 192.168.0.254.
player_nameSi vous avez changé le nom réseau du Freebox Player, vous pouvez utiliser ce paramètre pour le renseigner (voir ce lien pour plus d'informations).
delay_defaultPar défaut un délai de 500 millisecondes est appliqué entre chaque envoi de commande vers la Freebox. Pour certains cela pose problème. Il est donc possible de modifier ce délai en ajoutant ce paramètre dans le fichier de configuration.
delay_canalPar défaut un délai de 300 millisecondes est appliqué entre chaque envoi de commande de changement de chaine vers la Freebox (par exemple pour zapper sur la 12, on envoie 1, on attend 300ms, puis on envoie 2). Pour certains cela pose problème. Il est donc possible de modifier ce délai en ajoutant ce paramètre dans le fichier de configuration.
delay_volumePar défaut un délai de 20 millisecondes est appliqué entre chaque envoi de commande de volume vers la Freebox (pour augmenter/baisser le volume). Il est possible de modifier ce délai en ajoutant ce paramètre dans le fichier de configuration.
app_tokenLa valeur de ce paramètre est un jeton d'authentification qui est automatiquement généré par la Freebox lors du processus d'autorisation. Il peut parfois s'avérer nécessaire de supprimer app_token pour forcer sa recréation lors du prochain démarrage, par exemple si l'on change de Freebox ou si l'on révoque l'accès de l'application assistant-freebox depuis Freebox OS.
J'ai créé des applets IFTTT pour vous faciliter la tâche.
Voici les phrases clés à dire — s'assurer d'avoir installé les applets associées (pour Alexa il faudra dire Alexa déclenche suivi de la phrasé-clé) :
allume la Freebox : allume seulement la Freebox
allume la télé : allume la Freebox ET va mettre une chaine télé (via Freebox TV, ou via Mon Bouquet, ou via Les Chaines CANAL selon la configuration)
allume la télé et zappe sur ... : allume la Freebox (si elle n'est pas allumée) puis va mettre la chaine de télé demandéeéteins la Freebox : pour éteindre la Freebox
zappe sur ... : zappe sur la chaine demandée, et fonctionne aussi avec le numéro de la chainezappe et qu'il vous faudra peut-être utiliser un autre mot. Voici quelques applets déjà créées pour vous : Zappe sur TF1, Zappe sur France 2, Zappe sur France 3, Zappe sur Canal+, Zappe sur France 5, Zappe sur M6, Zappe sur Arte, Zappe sur C8, Zappe sur W9, Zappe sur TMC, Zappe sur TFX, Zappe sur NRJ12, Zappe sur LCP, Zappe sur France 4, Zappe sur BFM, Zappe sur Gullicoupe le son de la Freebox :
remets le son de la Freebox :
baisse le son de la Freebox : va baisser le son de 15 barres
monte le son de la Freebox : va augmenter le son de 15 barres
mets la Freebox sur pause : met le programme en cours sur pause
remets la Freebox en lecture : remet en lecture le programme en cours
reviens au direct : lorsque la Freebox TV a été mise sur pause et qu'on souhaite revenir au direct
va dans Mes Enregistrements : pour aller dans le menu "Mes Enregistrements" de la Freebox
va dans Mes Vidéos : pour aller dans le menu "Mes Vidéos" de la Freebox
va dans le dossier ... : parcourt tous les dossiers définis dans search_path (voir la section Configuration ci-dessus) afin de trouver le dossier souhaitéUne applet ne fonctionne pas ? Merci de me prévenir !
Il est également possible de créer ses propres applets et commandes pour piloter la Freebox.
Il faut pour cela procéder ainsi :
Assistantfreebox_ suivi par la commande souhaitée (si plusieurs commandes, les séparer par une virgule) (voir plus bas)Dans l'étape 9) précédente, vous devez y indiquer une commande. Voici donc les commandes disponibles :
red : touche rouge de la télécommande (envoie la commande red)yellow : touche jaune de la télécommande (envoie la commande yellow)blue : touche bleue de la télécommande (envoie la commande blue)green : touche verte de la télécommande (envoie la commande green)up : flèche haut (envoie la commande up)down : flèche bas (envoie la commande down)left : flèche gauche (envoie la commande left)right : flèche droite (envoie la commande right)OK : envoie la commande OKmute : sourdine (envoie la commande mute)play : lecture (envoie la commande play)fwd : avance rapide (envoie la commande fwd)bwd : retour rapide (envoie la commande bwd)waitXXXX : enclenche un timer de XXXX millisecondeson : allume la Freebox (envoie la séquence power suivi d'un timer de 7 secondes (wait7000))off : envoie la commande powertv : permet d'aller dans le mode TVunmute : coupe/remet le son (envoie mute)home : envoie la séquence home, wait2000, redback : envoie la commande redpause : envoie la commande playvideos : permet d'aller dans "Mes Vidéos"photos : permet d'aller dans "Mes Photos"musiques : permet d'aller dans "Mes Musiques"enregistrements : permet d'aller dans "Mes enregistrements" (envoie la séquence home, wait2000, red, up, ok)direct : remet le direct (envoie la séquence green, ok)soundDown : baisse le son de 1 point (envoie la commande vol_dec)soundUp : augmente le son de 1 point (envoie la commande vol_inc)soundLongDown : baisse le son de 30 points (utile pour ceux qui utilisent des barres de son) (envoie la commande vol_dec en simulant un appui long)soundLongUp : augmente le son de 30 points (utile pour ceux qui utilisent des barres de son) (envoie la commande vol_inc en simulant un appui long)programUp : changement de chaine (envoie la commande prgm_inc)programDown : changement de chaine (envoie la commande prgm_dec)folder XYZ : permet de chercher le répertoire XYZ dans search_path (qui est défini dans la configuration, et qui fonctionne avec "Mes Vidéos"), puis de s'y rendre
folder{/Disque dur/Musiques/} XYZ : permet de chercher le répertoire XYZ dans /Disque dur/Musiques et de s'y rendre (utilisation avec "Mes Musiques")folder{/Disque dur/Photos/} XYZ : permet de chercher le répertoire XYZ dans /Disque dur/Photos et de s'y rendre (utilisation avec "Mes Photos")zappe sur ABC ou zappe sur la 123 : permet de zapper sur la chaine ABC ou sur la chaine dont le numéro est 123 (exemple : freebox_zappe sur la 1 ou freebox_zappe sur TF1)zappelong sur ABC ou zappelong sur la 123 : permet de zapper sur la chaine ABC ou sur la chaine dont le numéro est 123 en faisant un appui long sur la touche (typiquement cela est utilisé pour le changement de chaine dans "Les Chaines Canal")*X pour effectuer X fois la même action (exemple : freebox_soundUp*5 équivaut à freebox_soundUp,soundUp,soundUp,soundUp,soundUp)Par exemple, supposons que vous avez un enregistrement journalier (disons l'émission Quotidien de Yann Barthès qui passe sur TMC), et que vous souhaitez lancer le dernier Quotidien enregistré.
Pour cela vous souhaitez donner la commande : OK Google, lance le programme Quotidien
Il faut donc créer une applet IFTTT (comme décrit plus haut) et pour la commande envoyée à Pushbullet vous mettrez : freebox_enregistrements,wait7000,ok,ok qui peut se traduire par Freebox, va dans Mes Enregistrements, puis patiente 7 secondes, et ensuite appuie sur OK, puis OK encore une fois
FAQs
Plugin Freebox pour un Assistant via le package assistant-plugins
We found that assistant-freebox demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Create React App is officially deprecated due to React 19 issues and lack of maintenance—developers should switch to Vite or other modern alternatives.
Security News
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
Security News
The Linux Foundation is warning open source developers that compliance with global sanctions is mandatory, highlighting legal risks and restrictions on contributions.