Skip to content

README_en.md

Latest commit

 

History

History
163 lines (116 loc) · 9.66 KB

README_en.md

File metadata and controls

163 lines (116 loc) · 9.66 KB
Raw

简体中文 | 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. Core features and implementation goals: high-FPS fluid animations in the foreground, zero-impact power saving in the background — dedicated to delivering a better experience as a lightweight Mihomo client that runs stably and reliably over the long term with minimal resource consumption.

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

Our Vision: Connecting Open Source and AI, Accelerating Innovation

Latest Release Core

Bettbox

✈️ Telegram Community

Telegram Group Telegram Channel

🚀 Core Features

  • Out-of-the-Box: Robust permission handling and smooth TUN/VPN experience with optimized defaults for instant usability.
  • Meticulously Crafted: Polished UI and interaction details. High FPS foreground animations, ultra-low mobile power consumption, and minimal desktop footprint.
  • Security First: Core tracks the main Mihomo branch with rapid feature adoption, maintaining strict cross-platform permission checks.
  • Rock-Solid Fault Tolerance: Edge-case optimizations for extreme multi-platform scenarios and dual config verification for enterprise-grade stability.
  • Performance Focused: Native desktop ARM64 support, hardware tiering, and Flutter/native optimizations to maximize performance.
  • Enhanced Utilities: Industry-first multi-platform seamless smart start/stop, Android sleep support, one-click QUIC toggle, and enhanced tray menu.
  • Visual Settings: Rich visual configuration parameters with real-time application — no tedious manual config editing required.
  • Home Widgets: Exquisite built-in widgets for real-time speed monitoring and system state tracking at a glance.
  • Personalized Customization: Rich color themes, custom icons/titles, and 10 dynamic speedtest animations.
  • Custom Adaptation: First-in-class JS script override UI adaptation with visual toggles.
  • Professional Code Editor: Built-in refactored high-performance code-forge editor across platforms, matching IDE-level editing experience.
  • Device Compatibility: Actively maintained Compatible builds for legacy OS versions and older hardware, extending device lifespans.
  • Zero Privacy Risk: Fully open-source, ad-free, transparent CI/CD, and fully audited to ensure zero background telemetry.
  • Community Driven: Community feedback is carefully evaluated, prioritizing high-quality issues to ensure your voice is heard.

🛩️ Recommended Services

Premium Dedicated Line 〢 BBXY

Exclusive Discount Code (32% OFF): bettbox68

Review : ❚ ❚ Established premium line operated overseas for years, Tier-1 enterprise BGP ingress + GZ-HK & SH-JP dedicated lines, approx. ¥17/mo or ¥127/yr after discount, unlocking streaming media & AI, with excellent latency and reputation. Ideal for users prioritizing high stability. Pro tip: Don't forget to use the 32% OFF discount code, and check in daily in the dashboard to claim an extra 5-10GB bonus bandwidth.

Low-Cost Direct 〢 Liangxin Cloud 〢 Chuixue Cloud 〢 YiFen

Review : ❚ Mainly high-bandwidth or resource servers with relatively lower exit-scam risk (maybe, perhaps, probably). 888GB / 1000GB non-expiring packages offer great cost-performance. Large allowance at affordable prices, ideal for budget users, backup traffic, or heavy downloading.

🛠️ Installation & Downloads

Please visit the [Releases] page to download the latest installer for your platform.

  • Cross-Platform Desktop: Windows 8.1+: (x64/arm64) Linux Kernel 5.4+: (x64/arm64) macOS 10.15+: (Intel/Apple Silicon)
  • Android 8.0+: Android (ARMv8/ ARMv7/ x86_64/ Universal)
  • Android TV: Fully adapted, optional ARMv7 32-bit
  • HarmonyOS NEXT: Supported via [ZhuoYiTong]

Other Installation Methods:
ArchLinux: yay -S bettbox-bin or paru -S bettbox-bin (Maintained by lyj404)
AMD64=v1: yay -S bettbox-compatible-bin or paru -S bettbox-compatible-bin (Maintained by VillagerTom)

❓ Frequently Asked Questions

  1. Installation, Startup & Security Issues:
  • Android devices: Ensure sufficient background permissions are granted and minimum requirements are met: Android 8.0+
  • Legacy desktop devices: Check if your CPU architecture requires downloading a specific CPU-level Compatible version.
  • Security: Bettbox is fully open-source and transparent with zero telemetry. Current builds have passed SignPath security audit.
  1. Desktop FAQs:
  • Windows Admin Permissions: Handled automatically during installation — no manual re-authorization required.
  • Unable to enable TUN mode: macOS and Linux users must enter the correct password to grant network permissions.
  • Other errors: Provide debug logs and ensure no conflicting proxy software or services are running.
  • If issues persist, please submit a GitHub Issue.
  1. macOS Installation Notes:
  • Download the appropriate .dmg file for your architecture (Intel / Apple Silicon) and double-click to open.
  • Drag the Bettbox icon into the Applications folder.
  • Bypassing system security checks during installation or updates (as Apple Developer Certificate is not currently purchased):
    • Recommended: Open Applications, right-click the Bettbox icon, select "Open", and click "Open" again in the confirmation prompt.
    • Alternative: If blocked, go to System Settings -> Privacy & Security, scroll to find Bettbox, and click "Open Anyway".
  • Upon enabling TUN mode for the first time, enter the password of the currently logged-in user when prompted to allow Bettbox to configure the network.
  1. Unable to Import Subscription Links:
  • Always try resetting the subscription link first to ensure it is valid before importing.
  • If issues persist, please contact your service provider first. If it is caused by the app, feel free to submit a GitHub Issue.

💻 Build & UI Customization

Building on Windows:

  • Requires a Windows PC (OS ≥ Windows 10)
  • Dependencies: Git, Visual Studio, Flutter 3.44.x, Golang, Inno Setup, Rust
* flutter pub get
* dart .\setup.dart windows --arch amd64 --out core (Build Core only)
* dart .\setup.dart windows --arch amd64 --out app --compatible (Optional Compatible build)
* Output binaries are located in the `dist/` directory

Custom Script UI Adaptation:

  • Starting from v1.18.8, Bettbox supports external override scripts for UI adaptation. Taking AIsouler's Script/Config Repository as an example, simply add the following declaration on the first line of your script to enable Bettbox built-in visual toggles:
  • const Compatible_With_Bettbox = { ruleOptionsEnable: true };

☕ Sponsorship

If you find this project helpful, consider supporting development via:

  • TRON (TRC-20): TCkTtZfF2WrciZLaJj3e1aqrh3zdTnCkDa
  • Bitcoin: bc1qu950cl6035qvllmzk6cfw3l30j2lg3cq9n6g6h

🙏 Acknowledgments

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

FlClash GUI 〢 Mihomo Core

Special thanks to all Contributors and open-source projects used or referenced:

Zashboard, CMFA, Sparkle, SFA, HUSI, V2rayN

📄 License

GPL-3.0 License