iptime-cli
An unofficial CLI and Python library for reading and changing ipTIME routers that run the new firmware 16.x admin UI.
Install
$ pipx install iptime-cli
$ uv tool install iptime-cli
Python 3.9 or newer. The package uses only the standard library.
Quick start
Set IPTIME_HOST, IPTIME_USER and IPTIME_PASSWORD, or save them in the config file. Try the commands below against the bundled fake router before connecting real hardware.
$ iptime clients
IP MAC NAME LINK LEASE LEFT RESERVED
192.168.0.10 AA:BB:CC:00:00:01 desktop lan2 wired static
192.168.0.11 AA:BB:CC:00:00:02 nas lan4 wired 22h 13m yes
192.168.0.20 AA:BB:CC:00:00:03 laptop 5g.1 -48 dBm 1h 46m
$ iptime info
Model ipTIME FAKE-1000
Firmware 16.000 (built 2026.01.01 00:00:00)
Latest firmware 16.010 (update available)
Uptime 1d 2h 3m
LAN 192.168.0.1 / 255.255.255.0
DHCP pool 192.168.0.2 - 192.168.0.254
WAN dhcp 203.0.113.7 gateway 203.0.113.1 up
WAN link 1000f
$ iptime port add "Game server" --target 192.168.0.10 --ext 25565 --dry-run
dry run, nothing sent:
POST http://127.0.0.1:18180/cgi/service.cgi
{"method": "portforward/add", "params": {"name": "Game server", "active": true, "protocol": "tcp", "target": "192.168.0.10", "src": {"start": 25565}, "dst": {"start": 25565}}}
The fake router serves fixed, invented devices on localhost. Start it with python -m iptime_cli.fake_router --port 18180, then set IPTIME_HOST=127.0.0.1:18180 and IPTIME_PASSWORD=secret.
Why
The firmware 16.x admin UI talks to the router through a JSON endpoint. iptime-cli uses that endpoint for terminal commands and Python calls; it does not support the older firmware 14.x UI or other router brands.
Read commands do not change router settings. Write commands show a confirmation or accept --dry-run; in non-interactive use they require --yes. Login may end an admin session open in a browser. A firmware upgrade reboots the router and interrupts the network.
Commands
| Command | Reads or changes |
|---|---|
iptime info, clients, wan, wifi |
Router and connection status |
iptime dhcp list, port list |
Existing leases, reservations and forwarding rules |
iptime dhcp reserve, port add, port rm |
DHCP and forwarding settings |
iptime remote-admin, firmware check |
Remote access and firmware status |
iptime call, iptime methods |
Raw API methods and their recorded status |
Add --json to read commands for scripts. Wi-Fi passwords are hidden unless you pass --show-secrets. The Python API starts with Router(host, user, password).call(method, params).
Limits
The supported admin UI is firmware 16.x. Commands have been exercised with the bundled fake router; router models and firmware variants are listed in the project’s method catalog. Do not infer a router’s state after a failed connection.
License
MIT. This unofficial project is not affiliated with, endorsed by or supported by EFM Networks. ipTIME is its trademark.
Metadata
Release files for iptime-cli 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iptime_cli-0.1.3.tar.gz | 29.9 kB | Without provenance | Details for iptime_cli-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iptime_cli-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for iptime_cli-0.1.3-py3-none-any.whl |
Total release size: 59.4 kB
Release files / iptime_cli-0.1.3.tar.gz
| Download URL | iptime_cli-0.1.3.tar.gz |
|---|---|
| Size | 29.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
03a1442f7599c2fd906dee863c52f117e94e23af703e38c715321c113369ef5b
|
|
BLAKE2b-256 checksum How to use checksums |
b3bf8483be4b3deec397105d5479a55a39b7b30a1d54caa7f982cf12d8c42a06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.8
|
Release files / iptime_cli-0.1.3-py3-none-any.whl
| Download URL | iptime_cli-0.1.3-py3-none-any.whl |
|---|---|
| Size | 29.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
893668c103e5aa6c87a1b8e01aa5cb97a38d205a6949e9d35629c66127c885fe
|
|
BLAKE2b-256 checksum How to use checksums |
e05258ccd30f71de40ce46752b99705095739327d869452c92d7325a18b1ccfc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.8
|
Security for iptime-cli 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.