A CLI that can interact with BT Home Hub routers.
Useful for performing quick reboots or for pulling statistics from the Home Hub.
Download one of the releases for your operating system. Please read the release notes to ensure it's compatible with your Home Hub firmware version. Or refer to the compatibility matrix.
For *nix and OS X:
./homehub-cli
For Windows:
homehub-cli.exe
Pressing the TAB
key shows all of the available commands. You can get help for specific commands by doing:
CommandName --help
You can run indivdual commands outside of the CLI shell by specifying the desired function to execute, together with the Home Hub authentication details.
./homehub-cli Reboot --huburl=http://192.168.1.254 --username=admin --password=secret
If the command requires arguments, you can pass them along like this.
./homehub-cli WiFiFrequency24GhzChannelSet 6 --huburl=http://192.168.1.254 --username=admin --password=secret
The huburl
and username
arguments are defaulted to the standard Home Hub IP address and admin user name. So you can omit these arguments if you want to and just specify the password
.
See ./homehub-cli --help
for all options.
You can run the CLI within a Docker container:
docker run -ti --rm jamesnetherton/homehub-cli
To run a specific command:
docker run -ti --rm jamesnetherton/homehub-cli About --password=secret
If you need to override the hub url or username arguments, simply add them to 'docker run' command:
docker run -ti --rm jamesnetherton/homehub-cli About --huburl=http://192.168.1.254 --username=admin --password=secret
First check that the CLI is compatible with your router hardware. You can run the About
command to see which firmware version the homehub-cli was tested and verified against.
You can enable debugging within the CLI via the EnableDebug
command.
To enable debugging:
EnableDebug true
To disable debugging:
EnableDebug false
With debugging enabled, you'll see HTTP requests and responses being output whenever commands are executed.
This project uses go modules. Ensure that you're using a compatible go version in order to build the project.
git clone git@github.com:jamesnetherton/homehub-cli.git
make build
Generated binaries are output to the build
directory.