🛡️ Freenet (macOS)

Bypass censorship. No account. No subscription. Just click.

Freenet is the ultimate, zero-configuration hybrid internet censorship bypass tool for macOS. Inspired by the legendary GoodbyeDPI, but custom-built natively in Swift for Mac. It lives quietly in your menubar and frees your internet with a single click.

🇹🇷 Türkçe dokümantasyon ve Rehber için tıklayın (Turkish README)

---

✨ Why Freenet? (The Three Engines)

Censorship systems vary. Freenet provides three specialized engines to defeat them, giving you the best option for any scenario:

1. 🚀 DPI Mode (Zero Speed Loss)

• The Problem: Your Internet Service Provider (ISP) acts like a mailman inspecting the label on your packages. If it says "youtube.com", they throw it away (Deep Packet Inspection).
• The Freenet Solution: Freenet slices that label into tiny pieces ("you" + "tube.com") using a local engine (ciadpi). The ISP's firewall gets confused and lets the traffic pass.
• The Magic: Your traffic goes directly to the destination. There is no VPN, no middleman, and absolutely zero speed loss. You get your raw, maximum internet speed. (Note: This bypasses blocks, but does not hide your real IP).

2. 🌍 WARP Tunnel Mode (The Heavy Armor)

• The Problem: Some governments completely block the IP addresses of certain websites. Slicing the package label doesn't work if the destination address itself is banned.
• The Freenet Solution: Freenet automatically builds a secure, encrypted WireGuard tunnel using Cloudflare's massive global infrastructure (WARP). It routes your entire traffic through this indestructible "pipe".
• The Magic: Bypasses absolute IP bans, DNS poisoning, and hides your real IP address. It protects you on public Wi-Fi networks.

3. 🛡️ sing-box Mode (Advanced Tunnel & TLS Fragmentation)

• The Problem: Sophisticated firewalls block connections using deep packet analysis and smart SNI detection, rendering basic packet-slicing or standard VPNs ineffective or easily blocked.
• The Freenet Solution: Freenet spins up a local sing-box engine (configured as a SOCKS5 proxy on port 1081). It routes traffic directly but applies advanced TLS Record Fragmentation (tls_record_fragment) on port 443 and utilizes secure DNS-over-HTTPS (DoH) from Cloudflare.
• The Magic: Splitting the TLS handshake client hello records confuses advanced firewalls, allowing you to bypass restrictions without routing traffic through a third-party VPN server. Your DNS queries are encrypted via DoH to prevent poisoning.

---

🎩 The "Magic" Features

Freenet isn't just another proxy app. It's designed to feel like a native Apple system service.

• ⚡ Zero Friction Auto-Install: Click "WARP Mode" for the first time? Freenet silently downloads the required packages (wgcf, wireguard), registers a free Cloudflare profile, and builds the tunnel. You don't ever need to touch the Terminal.
• 🔓 Passwordless 1-Click Toggle: Changing proxy settings usually requires your Mac password every single time. Freenet asks for permission once during setup to securely whitelist its commands. From then on, toggling takes 1 second, password-free.
• 🧠 Self-Healing Autopilot: Close your MacBook's lid or change Wi-Fi networks? VPNs usually drop and leave you disconnected. Freenet detects the drop instantly and automatically restarts the tunnel in the background. You're never left without internet.
• 📊 Live Matrix Dashboard: Geeks will love the real-time, Matrix-style live log viewer that shows exactly how your packets are being fragmented.

---

📦 One-Command Install

To install Freenet, simply open your Terminal (Applications > Utilities > Terminal) and paste this single command:

curl -fsSL https://raw.githubusercontent.com/Baro007/freenet/main/install.sh | bash

This will automatically clone, build, and install the app to your /Applications folder.

📱 Android Version (Beta)

Freenet is now available on Android! It features a premium Jetpack Compose dark UI with live connection logs, integrated sing-box core (via libbox-android), and the same three bypass modes (DPI, WARP, and sing-box).

Features

• Zero Configuration: Install and connect.
• Copy & Share Logs: Built-in copyable log viewer with device and system information headers to easily copy or share diagnostics.
• Optimized Binary Size: Bundled and optimized for ARM64-v8a devices (~58 MB instead of 215 MB).

Build & Run

To compile the APK yourself, you will need Java 17+ and the Android SDK:

cd android
./gradlew assembleDebug

The output APK will be generated at android/app/build/outputs/apk/debug/app-debug.apk.

---

🤝 Credits & Acknowledgements

• ciadpi (ByeDPI) - The core DPI bypass engine.
• WireGuard & Cloudflare WARP - The tunnel infrastructure.
• GoodbyeDPI-Turkey & SplitWire-Turkey - Community inspirations.

📝 License

MIT License. See LICENSE for details.