ip-changer

IP Changer

A Node.js CLI tool to change IP address by toggling mobile data on Android devices via ADB.

Prerequisites

• Node.js 12.0.0 or higher
• Android Debug Bridge (ADB) installed and accessible
• Android device with USB debugging enabled
• Device connected via USB or wireless ADB

Installation

Install globally via npm:

npm install -g ip-changer

Usage

After installation, you can run the tool from anywhere:

ip-changer

The tool will:

• Check your current IP address (IPv4 and IPv6)
• Disable mobile data on your Android device
• Wait briefly
• Re-enable mobile data
• Check your new IP address
• Report whether the IP change was successful

Setup Requirements

1. Install ADB

• Windows: Download Android SDK Platform Tools and add to PATH
• macOS: brew install android-platform-tools
• Linux: sudo apt-get install android-tools-adb

2. Enable USB Debugging

• Go to Settings > About Phone
• Tap "Build Number" 7 times to enable Developer Options
• Go to Settings > Developer Options
• Enable "USB Debugging"

3. Connect Device

Connect your Android device via USB and authorize the computer when prompted.

Verify connection:

adb devices

How It Works

The tool uses two IP checking services:

• ipify.org: Primary IP detection service
• ip-api.com: Backup IP detection service

It toggles your mobile data connection using ADB commands:

• adb shell svc data disable - Turns off mobile data
• adb shell svc data enable - Turns on mobile data

Troubleshooting

• ADB not found: Make sure ADB is installed and in your system PATH
• Device not detected: Check USB debugging is enabled and device is authorized
• Permission denied: Make sure your device allows ADB commands
• IP not changing: Your carrier may assign the same IP or use NAT

License

MIT

Contributing

Pull requests are welcome. For major changes, please open an issue first.