IP CHANGER 🌐🔄

A powerful Tor-based IP rotation CLI tool that automatically changes your public IP address at a specified interval and displays it in a clean terminal table.

Built with ❤️ by @CappricioSec

Main Menu

⚠️ For educational and privacy testing purposes only. Do not misuse this tool for illegal activities.

📌 Features

🔄 Automatic IP Rotation – Change your public IP using the Tor network
🧅 Tor Integration – Uses Tor SOCKS proxy for anonymous routing
📊 Clean Table Output – Displays IP and timestamp in a formatted CLI table
🖥 ASCII Banner – Stylish banner powered by figlet
⚡ Live Interval Update – Change refresh interval without restarting the tool
🛑 Graceful Exit – Stop the tool anytime using keyboard input

💻 Tech Stack

Language

Node.js (JavaScript)

Libraries Used

axios
commander
cli-table3
figlet
chalk

🗂️ Project Structure

ipchanger/
├── includes/
│   ├── banner.js      # banner, UI and help menu
│   ├── ip.js          # Tor connection and public IP fetching
│   ├── utils.js       # Tor checks and CLI argument handling
│
├── ipchanger.js       # main CLI entry point
├── package.json
└── README.md

🚀 Usage

🔧 Installation

First ensure Tor is installed on your system.

Download Tor:

Linux → sudo apt install tor
Mac → brew install tor
Windows → Install from Tor Project website

Then install the CLI globally:

npm install -g @karthithehacker/ipchanger

▶ Running the Tool

ipchanger -s 5

Available Options

Command	Description
`-s <seconds>`	Rotate IP every specified seconds
`-h`	Show help menu

🖥 Example Output

┌──(karthithehacker㉿BOOK-UVR5FJ22CV)-[~]
└─$ ipchanger -s 10

██╗██████╗      ██████╗██╗  ██╗ █████╗ ███╗   ██╗ ██████╗ ███████╗██████╗
██║██╔══██╗    ██╔════╝██║  ██║██╔══██╗████╗  ██║██╔════╝ ██╔════╝██╔══██╗
██║██████╔╝    ██║     ███████║███████║██╔██╗ ██║██║  ███╗█████╗  ██████╔╝
██║██╔═══╝     ██║     ██╔══██║██╔══██║██║╚██╗██║██║   ██║██╔══╝  ██╔══██╗
██║██║         ╚██████╗██║  ██║██║  ██║██║ ╚████║╚██████╔╝███████╗██║  ██║
╚═╝╚═╝          ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝

                                                 Website: cappriciosec.com

┌─────────────────────────┬────────────────────────────────────────┐
│ Service                 │ Information                            │
├─────────────────────────┼────────────────────────────────────────┤
│ Tor Status              │ Tor service started                    │
├─────────────────────────┼────────────────────────────────────────┤
│ IP Rotation             │ IP change every 10 sec                 │
├─────────────────────────┼────────────────────────────────────────┤
│ Terminate               │ Press X to terminate                   │
└─────────────────────────┴────────────────────────────────────────┘
[3:23:32 AM] Current IP → 107.189.3.148
[3:23:56 AM] Current IP → 192.42.116.144
[3:24:00 AM] Current IP → 109.70.100.9
[3:24:16 AM] Current IP → 109.70.100.3
[3:24:20 AM] Current IP → 107.189.10.175
[3:24:36 AM] Current IP → 45.134.225.36
[3:24:39 AM] Current IP → 109.70.100.7
[3:24:56 AM] Current IP → 192.159.99.168

🖥 Help Output

┌──(karthithehacker㉿BOOK-UVR5FJ22CV)-[~]
└─$ ipchanger -h

██╗██████╗      ██████╗██╗  ██╗ █████╗ ███╗   ██╗ ██████╗ ███████╗██████╗
██║██╔══██╗    ██╔════╝██║  ██║██╔══██╗████╗  ██║██╔════╝ ██╔════╝██╔══██╗
██║██████╔╝    ██║     ███████║███████║██╔██╗ ██║██║  ███╗█████╗  ██████╔╝
██║██╔═══╝     ██║     ██╔══██║██╔══██║██║╚██╗██║██║   ██║██╔══╝  ██╔══██╗
██║██║         ╚██████╗██║  ██║██║  ██║██║ ╚████║╚██████╔╝███████╗██║  ██║
╚═╝╚═╝          ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝

                                                 Website: cappriciosec.com



Usage:
  ipchanger -s <seconds>   Restart Tor every X seconds
  ipchanger -h             Show help

┌────────────────────┬───────────────────────────────────────────────────────┬─────────────────────────────────────────────┐
│ Application        │ Command / Steps                                       │ Description                                 │
├────────────────────┼───────────────────────────────────────────────────────┼─────────────────────────────────────────────┤
│ Chromium           │ chromium --proxy-server="socks5://127.0.0.1:9050"     │ Launch Chromium with SOCKS5 proxy enabled   │
├────────────────────┼───────────────────────────────────────────────────────┼─────────────────────────────────────────────┤
│ Chrome             │ chrome --proxy-server="socks5://127.0.0.1:9050"       │ Launch Google Chrome with SOCKS5 proxy      │
├────────────────────┼───────────────────────────────────────────────────────┼─────────────────────────────────────────────┤
│ Firefox            │ Settings → Preferences → Network Settings → Manual    │ Configure Firefox via UI to use SOCKS5      │
│                    │ Proxy → SOCKS Host: 127.0.0.1 Port: 9050 SOCKS v5 →   │ proxy                                       │
│                    │ Enable Proxy DNS                                      │                                             │
├────────────────────┼───────────────────────────────────────────────────────┼─────────────────────────────────────────────┤
│ Linux (system)     │ export ALL_PROXY="socks5h://127.0.0.1:9050"           │ Set proxy for terminal apps (session only)  │
├────────────────────┼───────────────────────────────────────────────────────┼─────────────────────────────────────────────┤
│ Linux              │ Add socks5 127.0.0.1 9050 to /etc/proxychains.conf →  │ Force any application to use SOCKS5 proxy   │
│ (proxychains)      │ proxychains4 <command>                                │                                             │
├────────────────────┼───────────────────────────────────────────────────────┼─────────────────────────────────────────────┤
│ macOS              │ sudo networksetup -setsocksfirewallproxy "Wi-Fi"      │ Apply SOCKS5 proxy to Wi-Fi network         │
│                    │ 127.0.0.1 9050                                        │                                             │
├────────────────────┼───────────────────────────────────────────────────────┼─────────────────────────────────────────────┤
│ Windows            │ Use Proxifier / ProxyCap → Add Proxy: 127.0.0.1:9050  │ Windows requires helper tool for global     │
│                    │ (SOCKS5)                                              │ SOCKS proxy                                 │
└────────────────────┴───────────────────────────────────────────────────────┴─────────────────────────────────────────────┘

Setup

⚙️ Runtime Controls

While the program is running you can:

Action	Result
`x` + Enter	Exit the program
Enter number (ex: `10`)	Change interval to 10 seconds

🧅 Tor Requirements

The tool uses the Tor SOCKS proxy.

Default Tor port:

127.0.0.1:9050

If Tor is not running, the tool will attempt to start it automatically.

🔄 Tor Circuit Rotation

The CLI requests a new Tor circuit every refresh using:

SIGNAL NEWNYM

This requires the Tor Control Port (9051).

Add this to your torrc file:

ControlPort 9051
CookieAuthentication 1

Restart Tor after updating.

⚠️ Notes

IP rotation depends on Tor's internal routing behavior.
Sometimes the IP may not change instantly.

Example warning:

warning: could not rotate Tor circuit: connect ECONNREFUSED 127.0.0.1:9051

👨‍💻 Authors

KarthiTheHacker

🌐 Website: karthithehacker.com
🐙 GitHub: @karthi-the-hacker

⚠️ Disclaimer

This tool is intended strictly for educational and privacy testing purposes.

Do NOT use this tool for:

illegal activities
bypassing services
attacking systems without permission

The developer assumes no responsibility for misuse.

< Built by hackers who care about security — Team Cappricio Securities. />
www.cappriciosec.com

`Chromium`	`chromium --proxy-server="socks5://127.0.0.1:9050"`	Launch Chromium with SOCKS5 proxy enabled.
`Chrome`	`chrome --proxy-server="socks5://127.0.0.1:9050"`	Launch Google Chrome with SOCKS5 proxy.
`Firefox`	Settings → Preferences → Network Settings → Manual Proxy → SOCKS Host: `127.0.0.1`, Port: `9050`, SOCKS v5 → Enable Proxy DNS	Configure Firefox via UI to use SOCKS5 proxy.
`Linux (system-wide)`	`export ALL_PROXY="socks5h://127.0.0.1:9050"`	Set proxy for terminal apps (per session).
`Linux (proxychains)`	Add `socks5 127.0.0.1 9050` to `/etc/proxychains.conf` → Run: `proxychains4 <command>`	Force any app to use SOCKS5 proxy.
`macOS (system-wide)`	`sudo networksetup -setsocksfirewallproxy "Wi-Fi" 127.0.0.1 9050`	Apply SOCKS5 proxy to Wi-Fi network.
`Windows (system-wide)`	Use Proxifier / ProxyCap → Add Proxy: `127.0.0.1:9050` (SOCKS5) → Apply Rules	Windows GUI doesn’t support SOCKS globally, requires helper tool.

ipchanger

Most Popular

About