MCPcopy Index your code
hub / github.com/cyr-ius/hass-livebox-component

github.com/cyr-ius/hass-livebox-component @2.5.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release 2.5.3 ↗ · + Follow
121 symbols 544 edges 23 files 114 documented · 94% updated 8d ago2.5.4-beta3 · 2026-06-21★ 892 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Orange Livebox Router

This a custom component for Home Assistant. The livebox integration allows you to observe and control Livebox router.

There is currently support for the following device types within Home Assistant:

  • Sensor with traffic metrics
  • Binary Sensor with wan status , public ip , private ip
  • Device tracker for connected devices (via option add wired devices)
  • Switch for enable/disable Wireless and Guest Wifi
  • Press button to restart box
  • Press button to ring phone
  • Press button to clear calls

GitHub release hacs_badge

Configuration

The preferred way to setup the Orange Livebox platform is by enabling the discovery component.

Add Livebox module via HACS

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Add your device via the Integration menu

Open your Home Assistant instance and start setting up a new integration.

Initial setup

You must have set a password for your Livebox router web administration page.

The first time Home Assistant will connect to your Livebox, you will need to specify the password of livebox.

Options configure

You can use the Configure button to change the following options:

  • Wired tracking (default: No): I track wired equipment
  • Wireless tracking (default: Yes): I track wireless equipment
  • Timeout tracking (default: 300 seconds) : Time before the device is considered disconnected (Some iOS devices tend to disconnect/reconnect to networks unexpectedly)
  • Track devices (default: Active):
  • All: Displays all active or inactive devices

  • Active: Displays only active devices (that have an IP address)

Supported routers

Only the routers with Livebox OS are supported:

  • Livebox 3
  • Livebox 4
  • Livebox 5
  • Livebox 6
  • Livebox 7
  • Livebox W7
  • KPN Box 12 (Firmware: V12.C.23.04.36)
  • Sagemcom f@st 5656
  • Livebox Nautilus (Arcadyan)

Unsupported routers

Despite being labelled "Livebox", the following router models cannot be supported:

Presence Detection

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

Ability to disable this option by integration options

Notes

Note that the Livebox 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 Livebox 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 Livebox router. The monitored conditions are instant upload and download rates in Mb/s.

Core symbols most depended-on inside this repo

find_item
called by 44
custom_components/livebox/helpers.py
_make_request
called by 21
custom_components/livebox/coordinator.py
get_rolling_32_bit_value_fn
called by 4
custom_components/livebox/sensor.py
_get_device_schedule
called by 3
custom_components/livebox/switch.py
get_closure_value_fn
called by 2
custom_components/livebox/sensor.py
async_step_user
called by 2
custom_components/livebox/config_flow.py
async_get_wan_status
called by 2
custom_components/livebox/coordinator.py
async_get_dhcp_leases
called by 2
custom_components/livebox/coordinator.py

Shape

Method 57
Function 48
Class 16

Languages

Python100%

Modules by API surface

custom_components/livebox/coordinator.py26 symbols
custom_components/livebox/switch.py14 symbols
tests/conftest.py11 symbols
custom_components/livebox/device_tracker.py10 symbols
custom_components/livebox/sensor.py9 symbols
custom_components/livebox/config_flow.py7 symbols
tests/test_config_flow.py6 symbols
custom_components/livebox/calendar.py6 symbols
custom_components/livebox/binary_sensor.py6 symbols
custom_components/livebox/button.py5 symbols
custom_components/livebox/__init__.py5 symbols
tests/test_switch.py4 symbols

For agents

$ claude mcp add hass-livebox-component \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact