Tor Bridge Manager is a lightweight, CLI-based tool designed to help users in restricted network environments manage, test, and connect to Tor Bridges efficiently. It acts as a wrapper around the Tor Expert Bundle, providing a user-friendly interface to manage multiple bridges, sort them by speed (TCP Ping), and connect seamlessly.
- Bridge Management: Add, delete, and organize
obfs4bridges easily. - Auto-Location: Automatically detects the country of the bridge server.
- Smart Sorting: Pings all saved bridges and sorts them by lowest latency.
- Visual Feedback: Real-time progress bar during the connection bootstrap process.
- Port Configuration: Custom SOCKS5 port selection (Default: 9050).
- Persistent Data: Remembers your servers and settings automatically.
- Cancel Connection – If Tor gets stuck at 50% (or any percentage), you can press
Cto cancel the connection immediately. No more frozen terminal! - Mobile Device Support – Share your Tor proxy with your phone (Telegram, V2Ray, etc.) on the same Wi-Fi network. The app displays your local IP address for easy configuration.
- QR Code for V2Ray / Shadowrocket – Press
Qto generate a QR code. Scan it with your phone (V2Box, Shadowrocket, etc.) and instantly get a configured SOCKS5 proxy pointing to your laptop.
This program is Portable. You do not need to install Python, drivers, or any other software.
- Go to the [Releases] page on the right side of this repository.
- Download the latest
.zipfile (e.g.,TorManager_v2.0.zip). - Extract the zip file to a folder on your computer.
- Run
TorManager.exe.
That's it! The folder already contains the necessary Tor engine files.
Only use this method if you want to modify the code or run it via Python.
- Clone this repository.
- Install Python 3.8+.
- Install dependencies:
pip install requests qrcode[pil] - Download the Tor Expert Bundle and place it in the
torfolder. - Run
python main.py.
To bypass censorship, you need "Bridges". You can obtain them from official sources:
- Telegram: @GetBridgesBot
- Website: Tor Project Bridges
- Email: bridges@torproject.org
- Run
TorManager.exe(orpython main.py). - Press [A] to select "Add Server".
- Paste your bridge lines. You can paste multiple lines at once (e.g., the entire message from the Telegram bot).
- Press Enter twice.
- The program will automatically validate the bridges, fetch their geo-location, and save them to your list.
- Press [C] to Connect.
- The program will initialize the Tor engine and display a real-time progress bar.
- If it gets stuck (e.g., at 50% for too long), simply press
Cto cancel. You can then try another bridge or check your network. - Once you see the green message "Done! Connected", the proxy is ready.
Use this for Telegram Desktop, Chrome, etc. on the same PC where the tool is running.
Proxy Address: 127.0.0.1
Port: 9050 (Default or whatever you configured)
- Open Telegram Desktop.
- Go to Settings > Data and Storage > Use Proxy.
- Click Add Proxy.
- Select SOCKS5.
- Server:
127.0.0.1 - Port:
9050
- Server:
- Click Save.
Use Proxy SwitchyOmega:
- Install Proxy SwitchyOmega.
- Open Options > New Profile > Name it "Tor".
- Protocol: SOCKS5.
- Server:
127.0.0.1| Port:9050. - Click Apply Changes.
- Select "Tor" from the extension popup.
The tool now displays your Local IP (e.g., 192.168.1.5) in the main menu. Use this to connect your phone to the same Tor proxy.
- Make sure your phone is connected to the same Wi-Fi as your laptop.
- Go to Telegram Settings → Data and Storage → Use Proxy.
- Add a SOCKS5 proxy:
- Server:
192.168.x.x(the IP shown in the tool) - Port:
9050
- Server:
- Save and enable.
- In the Tor Manager, press
Qto generate a QR code. - Open V2Box (or Shadowrocket) on your phone.
- Tap "Scan QR Code" and scan the code displayed on your laptop.
- A new server named "Bita" (or your chosen name) will appear. Connect to it.
- You are now using your laptop's Tor connection on your phone!
- Fixed
PermissionErroronbootstrap.log– The app no longer crashes if the log file is locked by a previous Tor process. - Removed global
taskkill– Stopping Tor now only terminates the specific process, avoiding accidental killing of other Tor instances. - Fixed Windows
titlecommand error – The console title no longer causes'Connected' is not recognizederrors. - Improved GeoIP reliability – Added fallback APIs (
ipapi.co,ipwho.is) and a cache to reduce rate‑limiting issues. - Added connection timeout & stuck detection – Automatically aborts the connection after 90 seconds total or 40 seconds without progress.
- Cleaner temporary file handling –
torrc_tempis removed automatically after disconnection.
Think of your computer's IP address as a "House" and Ports as "Doors".
- Normal websites usually enter through Door 80 or 443.
- This program opens a special internal door (9050) inside your house. When you configure Telegram to use this port, you are essentially telling it: "Do not go out through the main door; go through door 9050 where the Tor software is waiting to encrypt your data."
Standard "Ping" uses the ICMP protocol. However, many censorship-resistant servers block ICMP packets, making them appear "dead" even if they are working.
- This tool uses TCP Ping. It attempts to perform a TCP Handshake (SYN packet) with the specific port of the bridge.
- It measures the time taken for the server to acknowledge the request (SYN-ACK). This provides a much more accurate metric for service availability and latency in restricted networks.
Standard Tor traffic has a distinct fingerprint that firewalls can easily recognize and block.
- obfs4 (The Pluggable Transport used in this tool) acts as a camouflage layer. It scrambles the Tor traffic to look like random, unidentifiable data bytes. To a Deep Packet Inspection (DPI) firewall, the traffic appears as random noise, allowing it to pass through.
This tool is open-source software designed for educational purposes and personal privacy protection. It is provided "as is", without warranty of any kind. Please use this tool responsibly and ensure you comply with the laws and regulations of your region regarding the use of encryption and anonymity software.