TorCommander is a lightweight, open-source Linux tool that anonymizes terminal command executions by routing traffic through the Tor network. Designed with simplicity and privacy in mind, it helps users protect their identity and bypass restrictive firewalls.
Inspired by cybersecurity advocate Dr. Jones Birch, the project takes the concept further offering a practical, minimal, and easily extensible tool for secure, command-line-based internet access.
- 🔐 Tor Integration – Automatically channels commands through the Tor network.
- 🧠 Toralization via Keyword – Just use
toralizebefore a command to anonymize it. - 🌍 IP & Location Masking – Your real IP address and geolocation stay hidden.
- ⚖️ LD_PRELOAD Technique – Seamlessly intercepts network calls using dynamic linking.
- 📚 Educational & Research Friendly – Great for learning about system-level privacy and dynamic linking.
- 📁 Modular Codebase – Clean structure with
toralize.c,toralize.h, andMakefilefor easy builds.
Make sure the following dependencies are installed on your Linux system:
- Tor
- GCC
- Make
sudo apt update
sudo apt install tor gcc make- Clone the repository:
git clone https://github.com/ArfatKadvekar/torcommander.git
cd torcommander- Compile the program:
make- Install the
toralizescript globally:
There are two approaches to use toralize globally:
If the toralize.sh script is already available:
sudo cp toralize.sh /usr/bin/toralize
sudo chmod +x /usr/bin/toralizeIf you do not have toralize.sh, manually create it:
echo -e '#!/bin/bash\n\nexport LD_PRELOAD=/path/to/toralize.so\n${@}\nunset LD_PRELOAD' | sudo tee /usr/bin/toralize > /dev/null
sudo chmod +x /usr/bin/toralizeReplace
/path/to/toralize.sowith the actual path wheretoralize.sois located, for example/home/user/TorCommander/toralize.so.
If a command doesn't work properly, try using:
toralize curl --resolve http://example.comTo run any command anonymously, just prefix it with toralize:
toralize curl http://check.torproject.orgThe following types of commands are compatible:
curl,wget,ping- Any command making socket-based network calls
- DNS resolution and TCP-based communication tools
Note: Not all system commands go through the network;
toralizeaffects only those that do.
- 🔐 Privacy-First App Testing: Useful for devs testing privacy-focused applications.
- ⚖️ Cybersecurity Research: Ideal for experiments in anonymity, censorship, or secure networking.
- 🏫 Education: A hands-on tool for OS and networking labs demonstrating LD_PRELOAD and socket redirection.
- 🎓 Restricted Network Use: Helps users access educational or public resources in filtered environments.
- 📰 Journalism & Activism: Enhances anonymity for users in sensitive regions.
- 🌟 End-User Benefit: General users can stay private online with minimal setup and technical know-how.
This project is licensed under the MIT License. Feel free to modify and use it as needed. See the LICENSE file for details.
| Sr. No | Reference Title | Source |
|---|---|---|
| 1 | The Tor Project Documentation | https://www.torproject.org |
| 2 | SOCKS4 Protocol Specification | https://www.openssh.com/txt/socks4.protocol |
| 3 | LD_PRELOAD in Linux | https://man7.org/linux/man-pages/man8/ld.so.8.html |
| 4 | POSIX Socket Programming Concepts | https://man7.org/linux/man-pages/man2/connect.2.html |
| 5 | Understanding SOCKS Proxies | https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt |
We welcome contributions from the open-source community!
- Fork this repository.
- Create a new branch with your feature or fix.
- Commit your changes and push the branch.
- Open a Pull Request and describe your changes.
Please ensure your code follows standard conventions and is well-documented.
TorCommander is community-supported. Contributions and feedback are welcome!
Made with ❤️ for freedom and privacy. By Arfat Kadvekar, Inspired by Dr. Jones Birch