AutoDialer 0.2.3

AutoDialer is an automation script designed to interact with routers using APIs.

AutoDialer

AutoDialer is a cross-platform Python CLI package for router APIs, designed to rotate public IP addresses automatically and streamline router interactions.

Why AutoDialer?

• Convenient IP rotation on dynamic lines without manual router reboot.
• Cross-platform (Windows, Linux, macOS, FreeBSD).
• CLI-first usage for scripts and automation.

Installation

Using pip (recommended)

pip install autodialer

Using uv

If you prefer uv for faster environment and dependency management:

# install from PyPI
uv tool install autodialer

# run directly
autodialer

For local development:

uv sync
uv pip install -e .
uv run autodialer --help

From source (development)

python -m venv .venv

# Windows (PowerShell)
. .\.venv\Scripts\Activate.ps1

# Linux/macOS
source .venv/bin/activate

python -m pip install -e .

Configuration

Create a .env file in your working directory:

Variable	Description
PANEL_USERNAME	Router panel username (defaults to admin)
PANEL_PASSWORD	Router panel password
PPPOE_USERNAME	ISP PPPoE username (optional; used when you want to overwrite the router's saved PPPoE config before reconnecting)
PPPOE_PASSWORD	ISP PPPoE password (optional; used when you want to overwrite the router's saved PPPoE config before reconnecting)
ASN	Target ASN (optional unless not using --force)

Example:

PANEL_USERNAME='admin'
PANEL_PASSWORD='your_router_panel_password'
PPPOE_USERNAME='your_pppoe_username'
PPPOE_PASSWORD='your_pppoe_password'
ASN='AS9929'

Usage

After installation, use the CLI directly:

autodialer
autodialer --force
autodialer --asn AS9929
autodialer-devices --tplink

Arguments:

• -f, --force: force reconnection even if ASN is already matched.
• -a, --asn: target ASN (for example AS9929 or 9929).

Behavior:

• AutoDialer detects current WAN protocol and applies matching reconnection action.
• PPPoE uses disconnect/connect flow and reuses the router's saved credentials by default.
• If PPPOE_USERNAME and PPPOE_PASSWORD are set, AutoDialer updates the router's PPPoE config before reconnecting.
• DHCP uses DHCP renew flow and shares the same ASN/check/retry control logic.
• ASUSWRT routers use panel authentication plus WAN restart through the ASUS web API.

Notes

• TP-Link and ASUS routers are supported by default.
• Keep .env private and never commit credentials.

---

Thanks for using AutoDialer.