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
β οΈ For educational and privacy testing purposes only. Do not misuse this tool for illegal activities.
- π 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
Language
- Node.js (JavaScript)
Libraries Used
axioscommandercli-table3figletchalk
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
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/ipchangeripchanger -s 5| Command | Description |
|---|---|
-s <seconds> |
Rotate IP every specified seconds |
-h |
Show help menu |
βββ(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
βββ(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 β
ββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββββββββββββββββββ
| Connect to | 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 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. |
While the program is running you can:
| Action | Result |
|---|---|
x + Enter |
Exit the program |
Enter number (ex: 10) |
Change interval to 10 seconds |
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.
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.
- 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
KarthiTheHacker
- π Website: karthithehacker.com
- π GitHub: @karthi-the-hacker
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