Installation
You also need Mihomo; no build bundles it.
Release downloads
v0.1.1 is an unsigned pre-release on the releases page:
| platform | asset |
|---|---|
| Linux x86-64 | clashpulse-v0.1.1-linux-amd64.tar.gz |
| macOS Apple silicon | clashpulse-v0.1.1-darwin-arm64.tar.gz (ClashPulse.app) |
| Windows x86-64 | clashpulse-v0.1.1-windows-amd64.zip |
Check it against SHA256SUMS:
sha256sum --ignore-missing -c SHA256SUMS
Linux needs baseline x86-64 and glibc 2.35 or newer (Ubuntu 22.04, Debian 12). The GUI needs X11 or Wayland; on GNOME the tray may need the AppIndicator extension.
tar -xzf clashpulse-v0.1.1-linux-amd64.tar.gz
./clashpulse version
The macOS app is not notarized. Clear the quarantine flag before first start:
tar -xzf clashpulse-v0.1.1-darwin-arm64.tar.gz
xattr -dr com.apple.quarantine ClashPulse.app
On Windows, unzip and run clashpulse.exe.
Arch Linux
packaging/aur/ has clashpulse (builds the tagged source) and clashpulse-bin (repackages the release). Both depend on AUR mihomo or mihomo-bin.
cd packaging/aur/clashpulse
makepkg -si
Mihomo
Put mihomo on PATH (the default binary = "system") or pick a path in Settings > Mihomo binary. ClashPulse checks its version and capabilities first. Steady stream needs pinned listener support (verified with v1.19.31).
Build from source
Go 1.26.6, a C compiler, and Fyne’s graphics headers. On Debian/Ubuntu:
sudo apt-get update
sudo apt-get install -y build-essential pkg-config libgl1-mesa-dev xorg-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev libxxf86vm-dev libwayland-dev libxkbcommon-dev wayland-protocols
git clone https://github.com/fishman/clashpulse.git
cd clashpulse
go build -o clashpulse ./cmd/clashpulse
./clashpulse version
macOS needs the Xcode Command Line Tools, Windows needs MinGW/GCC. Build on each target; cross compiling the GUI is not supported. See dependencies.
make install installs into ~/.local (override with PREFIX=/usr/local). make run and make tui build and start the GUI or TUI.