virgin-media-hub3 =================

This is a python API and command line interface for the Virgin Media Hub 3 broadband router.

This allows you to view/change the configuration of the router through a decent API or through the command line.

Unlike the (rather mediocre) web interface, this allows you to view/change settings that are not necessarily exposed through the web interface. For example, you can add port forwardings for ports that the web interface will not allow (e.g. port 53 if you want to run a local DNS server).

The Virgin Media Hub 3 is a customised version of the Arris TG2492 router:

• Sales blurb: https://www.arris.com/products/touchstone-telephony-gateway-tg2492-s/

• End user documentation : https://fccid.io/UIDTG2492/User-Manual/Users-Guide-3118366

And it has dependencies: Nothing serious:

• python-requests
• python-netaddr
• pyyaml

git clone git@github.com:KarlJorgensen/virgin-media-hub3.git cd virgin-media-hub3 pip install -r requirements.txt export HUB_PASSWORD=YourRouterPassword export HUB=YourRouterAddress ./hub info ./hub --help

There is a sizeable number of subcommands - check the output of hub --help for details. For more details about each subcommand, invoke the subcommand with the --help parameter - e.g. ./hub portforward-add --help.

For example, to add a port forwarding to your internal web server at 192.168.0.16:

./hub portforward-add TCP 80 192.168.0.16 80 ./hub property-set firewall_enabled True

Enjoy!