简体中文 | English | Русский | فارسی | 日本語 | 한국어

⚡ Bettbox

Another Better Mihomo Client

Bettbox is a cross-platform network debugging and rule-based traffic splitting client powered by the Mihomo (Clash Meta) core and refactored from an early version of FlClash.

Guided by the principle of "Better Experience", Bettbox inherits the original sleek UI while deeply refining key details and feature logic. Goal: silky-smooth animations in the foreground, zero-impact power saving in the background — a lightweight, rock-solid Mihomo client.

Bettbox stands for: Better Experience, Out of the box.

✈️ Telegram Community

---

🛩️ Recommended Services

Niche IEPL Dedicated Lines 丨 BBXY (百变小樱)

Direct Connections 丨 Liangxinyun (良心云) 丨 Yifen (一分机场) 丨 Peiqian (赔钱机场)

Notes: ❚ ❚ Dedicated lines (with direct backup) offer higher stability, while direct connections supply huge bandwidth at low cost. Good community feedback. Note: These services are unaffiliated with Bettbox. Please assess performance on your own.

---

🛠️ Installation & Download

Please visit the [Releases] page to download the latest package for your platform and system.

• All Desktop Platforms: Windows (x64/arm64), macOS (Intel/Apple Silicon), Linux (x64/arm64)
• Android: Android (ARMv8 / ARMv7 / x86_64 / Universal)
• Android TV: Supported, optional ARMv7 32-bit
• HarmonyOS NEXT: Compatible via [ZhuoYiTong]

Other Installation Methods:
ArchLinux: yay -S bettbox-bin or paru -S bettbox-bin
AMD64=v1: yay -S bettbox-compatible-bin or paru -S bettbox-compatible-bin

---

🚀 Core Features

• Out of the Box: Reliable permission management and smooth TUN/VPN experience. Pre-optimized for instant use.
• Fine-Tuned UI: Polished UI & interaction logic. High FPS animations, ultra-low mobile power draw, minimal desktop footprint.
• Security First: Tracks Mihomo mainline closely with quick feature adoption and strict multi-platform permission verification.
• Rock-Solid Stability: Edge-case handling for extreme scenarios with dual config checks for enterprise-grade reliability.
• Performance Focus: Native desktop ARM64 support, hardware tiering, and full Flutter optimization to squeeze hardware performance.
• Smart Utilities: First seamless multi-platform smart start/stop, Android sleep mode, one-click QUIC disable, rich tray menu.
• Visual Controls: Intuitive UI controls with real-time application — no manual config editing needed.
• Home Widgets: Elegant built-in widgets to track network speeds and running status at a glance.
• Personalization: Rich color themes, custom icons/titles, and 10 dynamic speed-test animations.
• Open & Adaptable: Traffic-splitting UI adaptation for all JS override scripts with visual toggle switches.
• Legacy Support: Maintained Compatible builds for older OS and hardware to extend device lifecycles.
• Zero Privacy Risk: Open-source, ad-free, transparent CI/CD, and fully auditable with zero background telemetry.
• Community Driven: Active evaluation of community feedback and priority for quality issues. Your voice is heard.

---

❓ FAQ

1. Installation, Startup & Security:

   • Android devices: ensure sufficient background permissions are granted and system requirements are met: Android 8.0+
   • Older desktop devices: check if your system architecture requires downloading a specific CPU-grade Compatible version.
   • Security: Bettbox is open-source and transparent with zero privacy uploads. Codebase has passed Signpath security audits.

2. Desktop Common Issues:

   • Windows Admin Privileges: Handled automatically during installation — no manual authorization required.
   • Unable to enable TUN adapter: On macOS/Linux, ensure you enter the correct password for authorization.
   • Other errors: Please provide Debug info and ensure no conflicting proxy software or services are running.
   • If issues persist, please submit an ISSUE for feedback.

3. macOS Installation Guide:

   • Download the build for your platform (Intel / Apple Silicon) and double-click Bettbox-macos-xx.dmg.
   • Drag the Bettbox icon into the Applications folder to complete installation.
   • Bypass initial Gatekeeper blocks (as we currently do not purchase Apple Developer Certificates):
     • Recommended: Open Applications, right-click Bettbox icon, select "Open", and click "Open" again in the prompt.
     • Alternative: If double-click is blocked, go to Mac "System Settings" -> "Privacy & Security", find Bettbox and click "Open Anyway".
   • When enabling TUN mode for the first time, enter your Mac system password to allow Bettbox to configure network settings.
   • If prompted "is damaged and can't be opened. You should move it to the Trash":
     • This is a false positive from macOS Gatekeeper for unsigned software. Open Terminal and run:

       xattr -d com.apple.quarantine /Applications/Bettbox.app

4. Unable to Import Subscriptions:

   • Please try resetting your link first to ensure it is valid before importing.
   • If issues persist, please submit an ISSUE for feedback.

5. To be continued...

---

💻 Build & Development

Example for Windows:

• Requirements: Windows device (OS ≥ Windows 10)
• Prerequisites: Git, Visual Studio, Flutter 3.44.x, Golang, Inno Setup, Rust
• flutter pub get (fetch dependencies)
• dart .\setup.dart windows --arch amd64 --out core (build Core only)
• dart .\setup.dart windows --arch amd64 --out app --compatible (optional Compatible version)
• Built artifacts will be located in the dist/ directory.

Custom Script UI Adaptation:

• Taking AIsouler's MyClash Configuration Share as an example, add the following line at the very top of your script to enable Bettbox's visual toggles directly:
• const Compatible_With_Bettbox = { ruleOptionsEnable: true };

---

☕ Sponsorship

If you find this project helpful, you can sponsor development through the following methods or by using the recommended links above:

• TRON (TRC-20): TCkTtZfF2WrciZLaJj3e1aqrh3zdTnCkDa
• EVM Compatible: 0xF8B1B39431013359D83F38a4e403087624618E67
• Solana: C2YQPcKR2YmrPtBvkE13wckjgescUfMA5HzUioR4rQUd
• Bitcoin: bc1qu950cl6035qvllmzk6cfw3l30j2lg3cq9n6g6h

---

❤️ Acknowledgements

Free code signing on Windows provided by SignPath.io, certificate by SignPath Foundation

FlClash GUI 〢 Mihomo Core

Thanks to all Contributors and open-source project references:

CMFA, Sparkle, SFA, HUSI, V2rayN

---

📄 License

GPL-3.0 License