{"id":16862127,"url":"https://github.com/maelvls/livebox","last_synced_at":"2026-05-17T20:02:33.472Z","repository":{"id":79937874,"uuid":"321283184","full_name":"maelvls/livebox","owner":"maelvls","description":"🍊 A simple CLI for interacting with a Livebox 4 or 5.","archived":false,"fork":false,"pushed_at":"2025-02-11T15:39:31.000Z","size":85,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-20T07:53:43.928Z","etag":null,"topics":["livebox","orange"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maelvls.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-14T08:35:47.000Z","updated_at":"2025-02-11T15:39:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"3e8ecf82-c589-471b-916c-3a56fe1ac3ad","html_url":"https://github.com/maelvls/livebox","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maelvls%2Flivebox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maelvls%2Flivebox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maelvls%2Flivebox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maelvls%2Flivebox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maelvls","download_url":"https://codeload.github.com/maelvls/livebox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244257256,"owners_count":20424127,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["livebox","orange"],"created_at":"2024-10-13T14:34:37.938Z","updated_at":"2026-05-17T20:02:33.464Z","avatar_url":"https://github.com/maelvls.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# livebox CLI for the Livebox 4, 5, 6 and 7\n\n\u003e [!NOTE]\n\u003e\n\u003e Although I haven't tested with an actual Livebox 6 or 7, you should be able to run the `livebox` CLI with them.\n\nMy internet service provider is Orange. When you sign up for a plan with them, they provide a modem/router called the ‘Livebox.’ I’ve used two versions of it: Livebox 4 and Livebox 5. I had the Livebox 4 when I was limited to DSL, but once I became eligible for fiber in 2025, I was upgraded to the Livebox 5.\n\n\u003c!-- Table without border just to align the two images. Center text. --\u003e\n\n\u003ctable align=\"center\" border=\"0\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg alt=\"livebox-v4-fs8\" src=\"https://github.com/user-attachments/assets/bf8bf5e2-b7e4-4cd8-9097-15c6fc440eb3\" width=\"500\"\u003e\n        Livebox 4\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg alt=\"livebox-v5-fs8\" src=\"https://github.com/user-attachments/assets/12b3b3eb-a9be-45b6-868e-a12b414a041c\" width=\"500\"\u003e\n      Livebox 5\n      \u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\nI developed the `livebox` CLI to quickly reboot the Livebox and monitor its bandwidth. The CLI is compatible with both Livebox 4 and Livebox 5 models.\n\n## Getting started\n\nYou will need Go version 1.21 or later to build the CLI.\n\n```sh\ngo install github.com/maelvls/livebox@latest\n```\n\nTo get started:\n\n```sh\nlivebox login\n```\n\nYou can now list the devices on your network to find out their IP and MAC\naddresses:\n\n```sh\nlivebox ls\n```\n\nYou can reboot the Livebox from the command line:\n\n```sh\nlivebox reboot\n```\n\nYou can do raw API calls too:\n\n```sh\nlivebox api \u003c\u003c\u003c'{\"service\":\"NeMo.Intf.lan\",\"method\":\"getMIBs\",\"parameters\":{\"mibs\":\"base wlanradio\"}}'\n```\n\nYou can display the DSL bandwidth (doesn't work for fiber connections, only DSL):\n\n```sh\nlivebox speed\n```\n\nI had a very poor DSL connection back in the day:\n\n![the speed command](https://user-images.githubusercontent.com/2195781/114412685-9d8f6500-9bad-11eb-8911-0a571c0b578a.png)\n\n## Wi-fi\n\nYou can also configure your Wi-Fi. To configure the SSID and pass code for the\n2.4 GHz and 5 GHz bands simultaneously:\n\n```sh\nlivebox wifi config --ssid \"Wifi-Valais\" --pass \"foobar\" --24ghz --5ghz\n```\n\nIf you omit both `--24ghz` and `--5ghz`, both bands will be configured\nsimultanously:\n\n```sh\nlivebox wifi config --ssid \"Wifi-Valais\" --pass \"foobar\"\n```\n\nIf you want to configure different settings for each band:\n\n```sh\nlivebox wifi config --24ghz --ssid \"Wifi-Valais\" --pass \"foobar\"\nlivebox wifi config --5ghz --ssid \"Wifi-Valais_5GHz\" --pass \"foobar\"\n```\n\nTo turn off both and turn on both bands:\n\n```sh\nlivebox wifi disable\nlivebox wifi enable\n```\n\nTo turn on and off only one band:\n\n```sh\nlivebox wifi disable --24ghz\nlivebox wifi enable --5ghz\n```\n\n## Firewall\n\nYou can configure the firewall using the CLI.\n\nFor IPv4 TCP port forwarding:\n\n```sh\nlivebox port-forward set pi443 --from-port 443 --to-port 443 --to-ip 192.168.1.160 --to-mac E4:5F:01:A6:65:FE\n```\n\nYou can add the `--udp` flag to forward UDP traffic instead of TCP.\n\nRegarding IPv6 pinholes, you can do that too:\n\n```sh\nlivebox pinhole set tailscale-pi-ipv6 --to-port 41642 --to-ip 192.168.1.160 --to-mac e4:5f:01:a6:65:fe --udp\n```\n\n## DHCP\n\nTo configure a static lease:\n\n```sh\nlivebox static-lease set bc:d0:74:32:e9:1a 192.168.1.155\n```\n\nTo list the static leases:\n\n```sh\nlivebox static-lease ls\n```\n\n## DMZ\n\nTo configure the DMZ:\n\n```sh\nlivebox dmz set 192.168.1.160\n```\n\nAlso, you can remove the DMZ and see if one is configured:\n\n```sh\nlivebox dmz rm\nlivebox dmz get       # Returns the IP of the DMZ'ed device.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaelvls%2Flivebox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaelvls%2Flivebox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaelvls%2Flivebox/lists"}