byedpi-gtk

A GTK frontend for byedpi that bypasses deep packet inspection through a local SOCKS5 proxy.

Install

Flatpak

Download byedpi-gtk.flatpak from the latest release:

flatpak install --user ./byedpi-gtk.flatpak
flatpak run io.github.duckesteles.byedpigtk

Arch Linux

From the AUR:

paru -S byedpi-gtk

Or install the package from the latest release directly:

sudo pacman -U ./byedpi-gtk-*-any.pkg.tar.zst

AppImage

For x86_64 machines:

chmod +x byedpi-gtk-x86_64.AppImage
./byedpi-gtk-x86_64.AppImage

On ARM64 (aarch64) use the Flatpak, deb, or pacman package instead.

Debian / Ubuntu

A single package covers every architecture:

sudo apt install ./byedpi-gtk_*_all.deb

Usage

Launch byedpi-gtk, wait for the startup update check, then press Connect. Point your applications at the SOCKS5 endpoint shown in the window (127.0.0.1:1080 by default). Adjust the port and byedpi arguments under Settings.

byedpi is a proxy, not a VPN: it only affects apps you point at it. Nothing is routed automatically.

Firefox-based browsers (Firefox, LibreWolf…)

Settings → Network Settings → Manual proxy → SOCKS Host 127.0.0.1, Port 1080, SOCKS v5, and enable Proxy DNS when using SOCKS v5. If sites still fail, set network.http.http3.enable to false in about:config (QUIC/UDP bypasses a SOCKS proxy).

Flatpak apps

Flatpak apps do not inherit a system-wide proxy. Configure the proxy inside the app (as above), or inject it into that app's sandbox:

flatpak override --user --env=all_proxy=socks5h://127.0.0.1:1080 <app-id>
# undo with:
flatpak override --user --unset-env=all_proxy <app-id>

Replace <app-id> with the app (e.g. io.gitlab.librewolf-community). The loopback address 127.0.0.1:1080 is reachable from inside the sandbox because byedpi-gtk shares the host network.

Build from source

Requires meson, ninja, gtk4, libadwaita, python-gobject and gettext.

meson setup build --prefix=/usr
meson compile -C build
sudo meson install -C build

byedpi-gtk looks for the ciadpi binary in its data directory, then any bundled copy, then your PATH. When update checks are enabled it downloads the matching ciadpi build from the byedpi project on first run.

Translating

Add your language code to po/LINGUAS, create po/<code>.po from po/byedpi-gtk.pot, translate it, and rebuild. The source language is English and is used as the fallback.

License

byedpi-gtk is released under the GPL-3.0-or-later. It bundles the byedpi core, which is distributed under the MIT license.