tornet-mp 1.0.11

TorNet - Cross-platform IP rotation using Tor with logging and automation

NET-MP

---

Automate public-IP rotation through the Tor network on Windows, macOS and Linux.

• 🛡️ Hide your real IP behind Tor exit nodes
• 🧅 Connect to .onion addresses on non-Tor browsers (e.g., Firefox)
• 🔄 Rotate on a timer or on demand
• ⚙️ Self-installs missing prerequisites (pip, requests[socks], Tor)
• 📜 Clear, color-coded logs (all levels shown by default)
• 🐍 Tiny Python API for scripting

---

Installation

pip install tornet-mp

Tor binary required - if tor is not on your PATH, run tornet-mp --auto-fix and the tool will install it where possible.

Development / editable install

git clone https://github.com/ErnestoLeiva/tornet-mp.git
cd tornet-mp

# optional but recommended: create and activate a virtual-env
python -m venv .venv           # use  py -m venv .venv  on Windows
# macOS/Linux:  source .venv/bin/activate
# Windows CMD:  .venv\Scripts\activate.bat
# Win PowerShell: .venv\Scripts\Activate.ps1

# install in editable (“-e”) mode
python -m pip install -e .

Quick start

# show current (Tor/non-Tor) exit IP and exit
tornet-mp --ip

# rotate every 60 seconds, 10 times (default)
tornet-mp

# rotate every 90 seconds, 5 times
tornet-mp --interval 90 --count 5

# rotate on a random interval between 60-120 seconds, forever
tornet-mp --interval "60-120" --count 0

Example output

tornet-mp --interval 15 --count 1

CLI options

Flag	Description	Default
--interval SECONDS	Delay (or range e.g. 60-120) between rotations	60
--count N	Rotation cycles; 0 = infinite	10
--ip	Show current exit IP and quit	—
--auto-fix	Re-install/upgrade dependencies and Tor	—
--stop	Stop Tor services and TorNet-MP processes	—
-V / --version	Print version	—

Environment variables

Variable	Purpose	Default
TOR_SOCKS_HOST	Hostname of Tor SOCKS proxy	127.0.0.1
TOR_SOCKS_PORT	Port of Tor SOCKS proxy	9050

Configuring Your Browser to Use TorNet

To ensure your browser uses the Tor network for anonymity, you need to configure it to use TorNet's proxy settings

⚠️ Chrome and Chromium-based browsers do not support SOCKS proxies natively without command-line flags or extensions. Use FoxyProxy or similar tools for full control

Firefox

1. Go to Preferences > General > Network Settings
2. Select Manual proxy configuration
3. Enter 127.0.0.1 for SOCKS Host and 9050 for the Port (or your specified values if different)
4. Ensure the checkbox Proxy DNS when using SOCKS v5 is checked
5. Click OK

Verifying Tor IP Validity

You can manually confirm your browser is routing traffic through the Tor network:

1. Open your browser (configured to use the Tor proxy)
2. Visit https://check.torproject.org/api/ip
3. If the JSON output includes "IsTor" : true, your browser is using a valid Tor exit node

⚠️ Note: Occasionally, you may see mismatched IPs due to stale circuits; This API always shows the most current and accurate exit node IP

Bonus: Access .onion Sites from Firefox

Once your browser is configured to use TorNet’s proxy, you can access .onion websites directly from Firefox.

Below is a screenshot of DuckDuckGo's onion site loaded in a regular Firefox browser using TorNet as the SOCKS5 proxy:

https://duckduckgogg42xjoc72x3sjasowoarfbgcmvfimaftt6twagswzczad.onion

Python use

from tornet_mp import initialize_environment, ma_ip, change_ip

initialize_environment()
print("Current IP:", ma_ip())
print("Switching…")
print("New Tor IP:", change_ip())

If Tor is already installed and running you can skip initialize_environment() and call ma_ip() / change_ip() directly.

How it works

1. Ensures Tor, requests[socks] and PySocks are present

2. Starts the Tor background service (systemd, Brew, or raw binary)

3. Retrieves current exit IP via https://check.torproject.org/api/ip

4. Sends SIGHUP / service reload to request a new circuit on schedule

5. Logs every step with colored categories (INFO, WARN, ERROR, etc.)

Contributing

Bug reports and PRs are welcome! Style is enforced with pre-commit. After cloning, run:

pip install pre-commit
pre-commit install

Lineage & Credits

This project began life as tornet by Mr Fidal.
It was later reimagined and extended independently by Ayad Seghairi.

TorNet-MP builds on both prior versions, refactoring the codebase, adding cross-platform support (Windows, macOS, Linux), modern packaging, richer logging, automatic dependency management, and a polished CLI/UI.

License

MIT © 2026 Ernesto Leiva