Si vous vous demandez comment fonctionnent des programmes comme FreeStance pour communiquer avec votre Freebox sans fil, cet article est là pour vous l’expliquer ! Free a tout simplement développé une API complètement libre et très, très simple d’utilisation.

Elle vous permet en fait de simuler un appui sur une des touches de la télécommande de n’importe quelle Freebox sur le réseau. Tout ça via un simple appel d’URL ! Vous pouvez donc par exemple, changer de chaîne directement par votre navigateur en tapant une adresse spécifique, ou via wget, ou n’importe quel programme ou librairie supportant un appel d’URL tout bête.

L’URL est de la forme suivante : http://hd1.freebox.fr/pub/remote_control?code=xxxxxxxx&key=xxx&long=true&repeat=5

Le sous-domaine (virtuel) de freebox.fr désigne le boitier à contrôler. Si vous souhaitez contrôler le boitier n°1, il faudra écrire hd1, pour le boitier n°2, hd2, etc.

La variable “code” contient le code de la Freebox à contrôler. C’est un nombre à 8 chiffres que vous trouverez dans les paramètres de la Freebox.

La variable “key” contient la touche dont vous souhaitez simuler l’appui. Voici la liste de celles-ci :

  • power : la touche rouge on/off
  • list : la touche d’affichage de la liste des chaînes entre power et tv
  • tv : la touche verte TV de commutation péritel
  • 0 à 9 : les touches numériques
  • back : la touche jaune en dessous du 7
  • swap : la touche en dessous du 9
  • info, mail, help, pip : les touches bleues à droite des numéros de chaîne
  • epg, media, options : les fonctionnalités “secondaires” de ces mêmes touches
  • vol_inc, vol_dec : volume+ et volume-
  • prgm_inc, prgm_dec : chaîne suivante/précédente
  • ok : touche OK
  • up, right, down, left : les touches directionnelles entourant le OK
  • mute : la touche “muet”
  • home : la touche Free
  • rec : la touche d’enregistrement
  • bwd : la touche de retour en arrière («)
  • prev : la touche “précédent” ( «)
  • play : la touche lecture/pause
  • fwd : la touche d’avance rapide (»)
  • next : la touche “suivant” (» )
  • red : le bouton rouge (B)
  • green : le bouton vert (A)
  • yellow : le bouton jaune (Y)
  • blue : le bouton bleu (X)

(Source : universfreebox.com)

La variable “long”, quant à elle, spécifie comme son nom l’indique si l’appui du bouton doit être long ou court. Si elle vaut false ou n’est pas spécifiée, l’appui sera considéré comme court.

Pour finir, le contenu de la variable “repeat” est le nombre de fois que sera répété l’appui sur la touche de la télécommande. Il est peu utilisé et facultatif.

Et voilà ! Plus qu’à appeler l’URL, et votre Freebox réagit ! Pratique pour les farces… entre autres :D