theermia

theermia / BaleTunnel

Public

BaleTunnel is a network tunneling tool that leverages the infrastructure of Bale Messenger combined with the WebRTC protocol to bypass heavy internet restrictions.

46
19
75% credibility
Found May 18, 2026 at 77 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

BaleTunnel is a tool that helps people in heavily restricted internet environments access the open web. It works by routing network traffic through Bale Messenger, making it appear as a regular voice call. One person runs a small server program on their computer (which needs unrestricted internet), and another person connects to it through the app. Once connected, the client can route their browser traffic through the server, effectively bypassing internet restrictions. The traffic is encrypted and appears as normal voice call data, making it harder to detect and block.

How It Works

1
🌍 You discover you can't access the websites you need

Your internet connection is heavily restricted, and many websites simply won't load no matter what you try.

2
💬 A friend tells you about BaleTunnel

A friend who has unrestricted internet agrees to help by running a small program on their computer.

3
📱 You both log into Bale Messenger with your phone numbers

The program connects to Bale Messenger, which you both already use for messaging, making setup feel familiar.

4
🤝 Your friend's computer becomes your gateway

Your friend runs the program in 'server mode' and approves your connection request when it arrives.

5
🔗 You connect to your friend's computer

Your program shows your friend in the contacts list, and you click to connect. A voice call starts between your devices.

6
🌐 Your browser suddenly works freely

Once connected, you configure your browser to use the local proxy, and suddenly every website loads normally.

🎉 You can now access the open internet

Your internet traffic flows through Bale Messenger as an ordinary voice call, keeping your browsing private and unrestricted.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 77 to 46 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is BaleTunnel?

BaleTunnel is a Python-based network tunneling tool that routes traffic through Bale Messenger, an Iranian messaging platform, using the WebRTC protocol. It disguises network traffic as voice calls to bypass heavy internet restrictions in countries with aggressive censorship. Once connected, you get a SOCKS5 proxy running locally that your browser or applications can use directly. The tool runs in two modes: a server on an unrestricted machine that clients connect to, and a client on the restricted side that initiates the tunnel.

Why is it gaining traction?

The approach is clever: instead of building yet another VPN protocol that gets blocked, it piggybacks on existing infrastructure that censors want to keep functional. The tool delivers 8-12 Mbps throughput with 120-170ms latency in real-world testing from Iranian networks, which is usable for browsing and many applications. It includes end-to-end encryption via LiveKit, per-client bandwidth limits, and an allow-list/block-list system for server operators. The CLI is interactive and straightforward--login with your phone number, list contacts, connect to a peer.

Who should use this?

This is for developers and users in regions with heavy internet restrictions who need a functional workaround. If you have a Bale Messenger account and a server outside the restricted zone, you can self-host the infrastructure. Server operators who want to provide access to others will appreciate the access control features. General users looking for a simple proxy setup will find the SOCKS5 integration familiar.

Verdict

BaleTunnel solves a real problem with a creative technical approach, but the 0.75% credibility score and 46 stars reflect a small, early-stage project. Documentation exists in English and Persian, but test coverage and maintenance history are unclear. If you are in a restricted region and have the technical comfort to run a CLI tool, this is worth evaluating. Just treat it as experimental software and test thoroughly before relying on it for anything critical.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.