assistant-freebox
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.
Sommaire
Installation
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 :
- Pour Windows, télécharger
install_freebox.bat
dans le répertoireassistant-plugins
, puis l'exécuter en double-cliquant dessus. - Pour Linux/MacOS, ouvrir une console dans le répertoire
assistant-plugins
et taper :
npm install assistant-freebox@latest --save --loglevel error && npm run-script postinstall
Configuration
/!\ 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_telecommande
Paramètre Allumer 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_control
Paramètre Par défaut c'est la box dénommée hd1
qui est pilotée, mais il arrive que ce soit hd2
.
search_path
Paramètre Une 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
Paramètre À 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
Paramètre À 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_on
Paramètre Celui-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_ip
Paramètre Si 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_ip
Paramètre Si 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_name
Paramètre Si 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_default
Paramètre Par 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_canal
Paramètre Par 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_volume
Paramètre Par 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_token
Paramètre La 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.
Utilisation
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- Applet pour Google Home : https://ifttt.com/applets/qa8rME2N-allume-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/tMBkrH6X-allume-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/rKJrQV3k-allume-la-freebox-avec-alexa
-
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)- Applet pour Google Home : https://ifttt.com/applets/tuKQJrnH-allume-la-tele-via-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/cXdpPSvs-allume-la-tele-via-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/ZX7YPsQN-allume-la-tele-via-la-freebox-avec-alexa
-
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
Exemples :
OK Google, allume la télé et zappe sur M6
OK Google, allume la télé et zappe sur la 6- Applet pour Google Home : https://ifttt.com/applets/Bj6nH7Xw-allume-la-tele-via-la-freebox-et-zappe-sur-une-chaine-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/dGnuaQ5H-allume-la-tele-via-la-freebox-et-zappe-sur-une-chaine-avec-cortana
- Applet pour Alexa : non disponible
-
éteins la Freebox
: pour éteindre la Freebox- Applet pour Google Home : https://ifttt.com/applets/EEn7LsPJ-eteins-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/cnKUZTqR-eteins-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/EGKDfuN7-eteins-la-freebox-avec-alexa
-
zappe sur ...
: zappe sur la chaine demandée, et fonctionne aussi avec le numéro de la chaine
Exemples :
OK Google, zappe sur TMC
OK Google, zappe sur la 10- Applet pour Google Home : https://ifttt.com/applets/d6B7Yrk5-zappe-sur-une-chaine-de-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/GYbGcZ4B-zappe-sur-une-chaine-de-la-freebox-avec-cortana
- Applet pour Alexa : Alexa est très limitée niveau personnalisation... Du coup il faut une applet par chaine ! À noter aussi qu'Alexa peut mal comprendre le mot-clé
zappe
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 Gulli
-
coupe le son de la Freebox
:- Applet pour Google Home : https://ifttt.com/applets/kx4Ku7vj-coupe-le-son-de-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/Li7Esmfr-coupe-le-son-de-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/LB7dzMQj-coupe-le-son-de-la-freebox-avec-alexa
-
remets le son de la Freebox
:- Applet pour Google Home : https://ifttt.com/applets/S4wcuJn7-remets-le-son-de-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/ZAuewVNJ-remets-le-son-de-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/dNyUKmwA-remets-le-son-de-la-freebox-avec-alexa
-
baisse le son de la Freebox
: va baisser le son de 15 barres- Applet pour Google Home : https://ifttt.com/applets/WWf3zG58-baisse-le-son-de-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/wNHpPQhi-baisse-le-son-de-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/RUdArmZg-baisse-le-son-de-la-freebox-avec-alexa
-
monte le son de la Freebox
: va augmenter le son de 15 barres- Applet pour Google Home : https://ifttt.com/applets/uCcg6RdE-augmente-le-son-de-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/vNrYRmbF-augmente-le-son-de-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/a9Tp7eiv-augmente-le-son-de-la-freebox-avec-alexa
-
mets la Freebox sur pause
: met le programme en cours sur pause- Applet pour Google Home : https://ifttt.com/applets/N7um4qJU-mets-la-freebox-sur-pause-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/QjnXPHhx-mets-la-freebox-sur-pause-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/hLzYfKZw-mets-la-freebox-sur-pause-avec-alexa
-
remets la Freebox en lecture
: remet en lecture le programme en cours- Applet pour Google Home : https://ifttt.com/applets/mHAXMym9-remets-la-freebox-en-lecture-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/PZQWJvbY-remets-la-freebox-en-lecture-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/nTbmH7yB-remets-la-freebox-en-lecture-avec-alexa
-
reviens au direct
: lorsque la Freebox TV a été mise sur pause et qu'on souhaite revenir au direct- Applet pour Google Home : https://ifttt.com/applets/zfSALsrD-remets-le-direct-sur-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/XVJNLK3R-remets-le-direct-sur-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/vn8TXFdM-remets-le-direct-sur-la-freebox-avec-alexa
-
va dans Mes Enregistrements
: pour aller dans le menu "Mes Enregistrements" de la Freebox- Applet pour Google Home : https://ifttt.com/applets/KxHGy7vw-va-dans-mes-enregistrements-sur-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/DezNiJ2j-va-dans-mes-enregistrements-sur-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/fw2idaur-va-dans-mes-enregistrements-sur-la-freebox-avec-alexa
-
va dans Mes Vidéos
: pour aller dans le menu "Mes Vidéos" de la Freebox- Applet pour Google Home : https://ifttt.com/applets/ZkWauBKi-va-dans-mes-videos-sur-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/puaEkfRb-va-dans-mes-videos-sur-la-freebox-avec-cortana
- Applet pour Alexa : https://ifttt.com/applets/SLvCeDFB-va-dans-mes-videos-sur-la-freebox-avec-alexa
-
va dans le dossier ...
: parcourt tous les dossiers définis danssearch_path
(voir la section Configuration ci-dessus) afin de trouver le dossier souhaité
Exemples :
OK Google, va dans le dossier Star Trek
OK Google, va dans le dossier The Walking Dead (il vous faudra prendre votre plus bel accent anglais !)- Applet pour Google Home : https://ifttt.com/applets/bbdEPtcx-va-dans-un-dossier-stocke-sur-la-freebox-avec-google-home
- Applet pour Cortana : https://ifttt.com/applets/aiYERDBQ-va-dans-un-dossier-stocke-sur-la-freebox-avec-cortana
- Applet pour Alexa : non disponible
Une applet ne fonctionne pas ? Merci de me prévenir !
Personnalisation
Il est également possible de créer ses propres applets et commandes pour piloter la Freebox.
Il faut pour cela procéder ainsi :
- Créer une nouvelle applet dans IFTTT : https://ifttt.com/create
- Cliquer sur this puis choisir Google Assistant (ou Amazon Alexa ou Cortana)
- Choisir la carte Say a simple phrase (ou autre, selon votre cas)
- Dans « What do you want to say? » mettre la phrase qui va déclencher l'action
- Remplir les autres champs de la carte
- Maintenant, cliquer sur that puis choisir Pushbullet
- Choisir la carte Push a Note
- Dans le champs « Title », mettre
Assistant
- Dans le champs « Message », mettre
freebox_
suivi par la commande souhaitée (si plusieurs commandes, les séparer par une virgule) (voir plus bas) - Enregistrer puis cliquer sur Finish
- Dites : « OK Google » (ou le trigger de votre assistant) suivi de votre phrase spéciale du point 4)
- Votre assistant devrait s'exécuter
Commandes
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 commandered
)yellow
: touche jaune de la télécommande (envoie la commandeyellow
)blue
: touche bleue de la télécommande (envoie la commandeblue
)green
: touche verte de la télécommande (envoie la commandegreen
)up
: flèche haut (envoie la commandeup
)down
: flèche bas (envoie la commandedown
)left
: flèche gauche (envoie la commandeleft
)right
: flèche droite (envoie la commanderight
)OK
: envoie la commandeOK
mute
: sourdine (envoie la commandemute
)play
: lecture (envoie la commandeplay
)fwd
: avance rapide (envoie la commandefwd
)bwd
: retour rapide (envoie la commandebwd
)waitXXXX
: enclenche un timer de XXXX millisecondeson
: allume la Freebox (envoie la séquencepower
suivi d'un timer de 7 secondes (wait7000
))off
: envoie la commandepower
tv
: permet d'aller dans le mode TVunmute
: coupe/remet le son (envoiemute
)home
: envoie la séquencehome
,wait2000
,red
back
: envoie la commandered
pause
: envoie la commandeplay
videos
: 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équencehome
,wait2000
,red
,up
,ok
)direct
: remet le direct (envoie la séquencegreen
,ok
)soundDown
: baisse le son de 1 point (envoie la commandevol_dec
)soundUp
: augmente le son de 1 point (envoie la commandevol_inc
)soundLongDown
: baisse le son de 30 points (utile pour ceux qui utilisent des barres de son) (envoie la commandevol_dec
en simulant un appui long)soundLongUp
: augmente le son de 30 points (utile pour ceux qui utilisent des barres de son) (envoie la commandevol_inc
en simulant un appui long)programUp
: changement de chaine (envoie la commandeprgm_inc
)programDown
: changement de chaine (envoie la commandeprgm_dec
)folder XYZ
: permet de chercher le répertoire XYZ danssearch_path
(qui est défini dans la configuration, et qui fonctionne avec "Mes Vidéos"), puis de s'y rendrefolder{/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
ouzappe 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
oufreebox_zappe sur TF1
)zappelong sur ABC
ouzappelong 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")- on peut aussi utiliser
*X
pour effectuer X fois la même action (exemple :freebox_soundUp*5
équivaut àfreebox_soundUp,soundUp,soundUp,soundUp,soundUp
)
Exemple
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