Ce plugin de assistant-plugins permet de contrôler la Freebox Révolution/Delta/One.
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 :
- Pour Windows, télécharger
install_freebox.batdans le répertoireassistant-plugins, puis l'exécuter en double-cliquant dessus. - Pour Linux/MacOS, ouvrir une console dans le répertoire
assistant-pluginset 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.
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.
Par défaut c'est la box dénommée hd1 qui est pilotée, mais il arrive que ce soit hd2.
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.
À 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.
À 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.
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.
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.
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.
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).
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.
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.
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.
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.
Il faut créer une applet IFTTT pour chaque commande vocale. On procède 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 (par exemple allume la Freebox)
- 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). Par exemple, pour allume la Freebox on aurafreebox_on(voir les commandes 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)… Par exemple « OK Google, allume la Freebox » – à noter qu'il faut utiliser le mot-clé "déclenche" avec Alexa : « Alexa, déclenche allume la Freebox »
- Votre assistant devrait s'exécuter
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 commandeOKmute: 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équencepowersuivi d'un timer de 7 secondes (wait7000))off: envoie la commandepowertv: permet d'aller dans le mode TVunmute: coupe/remet le son (envoiemute)home: envoie la séquencehome,wait2000,redback: envoie la commanderedpause: envoie la commandeplayvideos: 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_decen simulant un appui long)soundLongUp: augmente le son de 30 points (utile pour ceux qui utilisent des barres de son) (envoie la commandevol_incen 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/Musiqueset de s'y rendre (utilisation avec "Mes Musiques")folder{/Disque dur/Photos/} XYZ: permet de chercher le répertoire XYZ dans/Disque dur/Photoset de s'y rendre (utilisation avec "Mes Photos")
zappe sur ABCouzappe 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 1oufreebox_zappe sur TF1)zappelong sur ABCouzappelong 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
*Xpour 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
Autre exemple, pour zapper sur une chaine avec Google Assistant : on va créer une applet IFTTT de type Say a phrase with a text ingredient. Ensuite, on enverra la commande : freebox_zappe sur $ (avec $ qui est le text ingrédient).