Configuration

If you have enabled the discovery component,
your Freebox should be detected automatically. Otherwise, you can set it
up manually in your configuration.yaml file:

freebox:
host: foobar.fbxos.fr
port: 1234

Configuration Variables

host

(string)(Required)

The url of the Freebox.

port

(string)(Required)

The https port the Freebox is listening on.

You can find out your Freebox host and port by opening the address mafreebox.freebox.fr/api_version in your browser. The
returned json should contain an api_domain (host) and a https_port (port).
Please consult the api documentation for more information.

The first time Home Assistant will connect to your Freebox, you will need to
authorize it by pressing the right arrow on the facade of the Freebox when
prompted to do so.

To make the WiFi switch working you will have to add “Modification des réglages de la Freebox
“ permission to Home Assistant application in “Paramètres de la Freebox” > “Gestion des accès” > “Applications”.

Supported routers

Only the routers with Freebox OS are supported:

Freebox V7 also known as Freebox Delta

Freebox V6 also known as Freebox Revolution

Freebox mini 4k

Presence Detection

This platform offers presence detection by keeping track of the
devices connected to a Freebox router.

Notes

Note that the Freebox waits for some time before marking a device as
inactive, meaning that there will be a small delay (1 or 2 minutes)
between the time you disconnect a device and the time it will appear
as “away” in Home Assistant. You should take this into account when specifying
the consider_home parameter.
On the contrary, the Freebox immediately reports devices newly connected, so
they should appear as “home” almost instantly, as soon as Home Assistant
refreshes the devices states.

Sensor

This platform offers you sensors to monitor a Freebox router. The monitored conditions are
instant upload and download rates in KB/s.

Switch

This platform offers you a switch to toggle the Wifi on or off. This will toggle all WiFi interfaces of the router (all SSID and all bands).