Rotate public IPs on Android devices and emulators via ADB by automating a compatible VPN app (currently Windscribe). Built by VoxHash Technologies.
Not affiliated with Windscribe Limited. Windscribe is a trademark of its respective owner. This project is an independent ADB automation tool.
- Connects to Android devices/emulators via ADB
- Fully automated UI automation (taps/text input; no manual GUI steps)
- Rotates IP by connecting to different VPN server locations
- Supports physical devices and Android emulators
- Multi-device support with independent locations per device
- Configurable server list (
servers.json) - Automatic rotation mode (
--rotate) - Current IP and connection status checks
# 1) Clone repository
git clone https://github.com/VoxHash/android-adb-vpn-ip-rotator.git
cd android-adb-vpn-ip-rotator
# 2) Optional: isolated Python env (recommended on Arch/PEP 668 systems)
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# 3) Verify ADB and a connected device
adb devices
# 4) Install and log into the Windscribe Android app on the device, then run
python3 windscribe_ip_changer.py --list-devices
python3 windscribe_ip_changer.py --device YOUR_DEVICE_IDSee docs/installation.md for platform-specific steps.
| Dependency | Required | Notes |
|---|---|---|
| Python 3.8+ | Yes | Standard library only; optional packages in requirements.txt |
| ADB | Yes | android-tools / platform-tools in PATH |
| Android device or emulator | Yes | USB debugging enabled and authorized |
| Windscribe Android app | Yes (current target) | Package com.windscribe.vpn; logged-in account |
| Env vars / API secrets | No | Configuration is CLI + JSON files |
python3 windscribe_ip_changer.pypython3 windscribe_ip_changer.py --rotate --count 10 --interval 300cp servers.json.example servers.json
python3 windscribe_ip_changer.py --servers servers.jsonpython3 windscribe_ip_changer.py --list-devices
python3 windscribe_ip_changer.py --device emulator-5554cp multi_device_config.json.example multi_device_config.json
python3 windscribe_ip_changer.py --multi-device multi_device_config.jsonpython3 windscribe_ip_changer.py \
--adb-path /custom/path/to/adb \
--device emulator-5554 \
--servers servers.json \
--rotate \
--count 20 \
--interval 600 \
--wait 8| Option | Description | Default |
|---|---|---|
--adb-path |
Path to ADB executable | Auto-detected |
--device |
Specific device ID | First authorized device |
--list-devices |
List connected devices and exit | — |
--multi-device |
JSON multi-device config path | — |
--servers |
JSON server list path | Built-in defaults |
--wait |
Seconds to wait after connecting | 5 |
--rotate |
Enable automatic IP rotation | False |
--count |
Number of rotations | 5 |
--interval |
Seconds between rotations | 300 |
Full reference: docs/configuration.md
- Connect to the device via ADB
- Detect the Windscribe app/CLI
- Read current IP and VPN status
- Disconnect if needed (UI automation + system VPN helpers)
- Navigate the app UI (tap/text) to select a location and connect
- Verify the new public IP
Details: docs/architecture.md
See ROADMAP.md. Changes are tracked in CHANGELOG.md.
Read CONTRIBUTING.md and use the PR template.
Report vulnerabilities via SECURITY.md.
MIT — see LICENSE. Copyright (c) 2026 VoxHash Technologies.
See SUPPORT.md or email contact@voxhash.dev.