Livebox Bypass CLI

Table of contents

• What is Livebox Bypass CLI?
• How it works
• Getting started
  • Available platforms
• Usage
  • Authentication
  • Examples
• Commands
• Disclaimer

What is Livebox Bypass CLI?

A command-line tool to generate the required DHCP and GPON/XGS-PON configurations for bypassing Orange Livebox.

How it works

This tool uses the Livebox API to retrieve the necessary information and outputs ready-to-use DHCP (v4/v6) and GPON settings for third-party routers.

Getting started

• Download the latest release from the releases page.

Available platforms

A native build of the tool is available for the following platforms:

• Linux (x86_64 / arm64)
• macOS (x86_64 / arm64 (Silicon))
• Windows (x86_64)

Note: A non-native (.jar) build is also available, of course you will need to have Java installed on your system if you want to use it.

Usage

General syntax:

• ./livebox-bypass-cli <command> [options]

Authentication

Some commands require authenticating with your Livebox admin password to retrieve necessary information.

You can provide credentials using:

• Interactive prompt (recommended): ./livebox-bypass-cli <command> -p
• Command line (less secure): ./livebox-bypass-cli <command> -p <your_admin_password>

Security Note: Prefer -p without a password argument to avoid exposing your password in shell history or process lists.

Examples

• Interactive password prompt:

  • ./livebox-bypass-cli generate dhcp -p
  • ./livebox-bypass-cli generate gpon -p

• Non-interactive (not recommended):

  • ./livebox-bypass-cli generate dhcp -p yourAdminPassword

Commands

• generate
  • dhcp
    • Generates DHCPv4 and DHCPv6 configurations for bypassing the Livebox.
      • Requires authentication.
      • Output:
        • DHCPv4 options
          • 60 Vendor class
          • 61 Client identifier
          • 77 User class
          • 90 Authentication
        • DHCPv6 options
          • 16 Vendor class
          • 1 Client identifier
          • 15 User class
          • 11 Authentication
        • DHCPv4/v6 options
          • CoS
        • WAN options
          • Vlan ID
  • gpon
    • Generates GPON configurations for bypassing the Livebox.
      • Requires authentication.
      • Note: GPON options are also valid for XGS-PON
      • Output:
        • Serial number
        • Hardware version
        • Vendor ID
        • Software Version 0
        • Software Version 1
  • authentication
    • Generates DHCPV4/V6 Authentication with the provided login (fti/xxx) and password.
      • Requires Orange login (fti/xxx) and password, not the Livebox admin ones.
      • This command is useful in case you need to generate the authentication option but don't have access to your Livebox.
      • Output:
        • DHCPv4 option
          • 90 Authentication
        • DHCPv6 option
          • 11 Authentication
• version
  • Displays the current version of the tool.
  • Output:
    • Version
• help
  • Displays the help message.

Disclaimer

This project is not affiliated with, endorsed by, or associated with Orange S.A. or any of its subsidiaries. This is an independent, community-developed tool created for educational and personal use purposes.

• Orange, Livebox, and related trademarks are the property of Orange S.A.
• This tool is provided "as is" without warranty of any kind
• Use of this tool is at your own risk
• The authors assume no liability for any damages or issues arising from the use of this software
• This tool is intended for use with equipment you own or have permission to configure
• Users are responsible for ensuring their use complies with their ISP's terms of service and local regulations