Biuuu for Linux (unofficial)

Unofficial Linux .deb packages of the Biuuu client, plus a script to build your own.

🌐 中文说明见 README.zh-CN.md

Biuuu stopped shipping Linux builds after v4.7 — only Windows and macOS installers are released now. But Biuuu is an Electron application whose logic is platform-neutral, so a working Linux build can be reconstructed from the official Windows installer. This project does exactly that: it takes the platform-neutral application code from an official Biuuu Windows build and repackages it onto a Linux runtime, producing an installable .deb.

This is a community effort. It is not affiliated with, endorsed by, or supported by Biuuu. Use at your own discretion.

Install (easiest)

Download the latest Biuuu-linux-<version>.deb from the Releases page, then:

sudo dpkg -i Biuuu-linux-<version>.deb
sudo apt-get install -f      # pull in any missing dependencies
biuuu                        # or launch "Biuuu" from your app menu

Requirements: a Debian/Ubuntu-based x86-64 distribution.

Build it yourself

If you'd rather build from an installer you downloaded yourself (e.g. a version not yet released here), you can. You need Docker and an official Biuuu Windows .exe.

# from the repo root
./build/build.sh /path/to/Biuuu-<version>.exe
# -> produces ./dist/Biuuu-linux-<version>.deb

Everything runs in a container and stays on your machine — nothing is uploaded. The script:

1. extracts the application (app.asar) from your Windows installer,
2. repackages it onto a Linux runtime (reused from the most recent release here),
3. compiles the open-source proxy core for Linux (with a small compatibility patch), and
4. builds and smoke-tests the .deb.

See docs/how-it-works.md for the technical details.

Why does this exist?

Many people rely on Biuuu but work on Linux. When official Linux support was dropped, the options were to run an outdated version, use a VM, or go without. Because the app is standard Electron plus an open-source proxy core, keeping a Linux build alive is straightforward — so we do.

Notes & limitations

• x86-64 only for now.
• This project changes packaging only, never the app's behavior. The client still talks to Biuuu's own servers and account system; you log in with your normal account.
• Each release is built from a specific official Windows version and carries the same version number.

License

GPL-3.0, inherited from the upstream open-source project this client is based on (mihomo-party / clash-party). See LICENSE. All trademarks belong to their respective owners.