ADBee

🐝 Connect Android devices via ADB WiFi using a QR code.

ADBee makes Android wireless debugging easier: open the app, scan the QR code from Android's Wireless debugging screen, and ADBee pairs/connects the device for you.

Repository: https://github.com/Docmine17/adbee

Requirements

When using the Flatpak

• Flatpak
• Android platform-tools / adb installed on the host system
• Android 11 or newer
• Wireless debugging enabled on the Android device

ADBee runs sandboxed as a Flatpak, but it calls the host adb command through flatpak-spawn. Make sure adb is available on your host system:

adb version

If adb is missing, install Android platform-tools using your distro package manager, for example:

# Fedora
sudo dnf install android-tools

# Ubuntu/Debian
sudo apt install android-sdk-platform-tools

# Arch Linux
sudo pacman -S android-tools

Install from the Flatpak bundle

Download the .flatpak bundle from the 1.0 release:

https://github.com/Docmine17/adbee/releases/tag/1.0

Then install it with:

flatpak install --user ./io.github.docmine17.adbee.flatpak

Run it with:

flatpak run io.github.docmine17.adbee

If you downloaded the file to another directory, replace ./io.github.docmine17.adbee.flatpak with the actual path.

Install directly from the release URL

If the bundle asset is named io.github.docmine17.adbee.flatpak, you can also use:

curl -L -o io.github.docmine17.adbee.flatpak \
  https://github.com/Docmine17/adbee/releases/download/1.0/io.github.docmine17.adbee.flatpak

flatpak install --user ./io.github.docmine17.adbee.flatpak

How to use

1. Open ADBee.
2. On your Android device, go to:
   • Settings → Developer options → Wireless debugging
3. Tap Pair device with QR code.
4. Scan the QR code shown in ADBee.
5. ADBee will automatically run adb pair and, when possible, adb connect.

Development requirements

For running directly from source:

• Python 3.10+
• GTK4
• Libadwaita
• glib-compile-resources
• glib-compile-schemas
• Python dependencies:
  • qrcode
  • zeroconf
  • pypng

Install the Python dependencies with:

pip install qrcode zeroconf pypng

Running from source

python run.py

run.py automatically compiles the local GResource and GSettings schema files when needed.

Building with Meson

meson setup build
meson compile -C build
sudo meson install -C build

Building the Flatpak locally

flatpak-builder --user --install --force-clean build-dir io.github.docmine17.adbee.yml

Run the installed Flatpak:

flatpak run io.github.docmine17.adbee

Creating a .flatpak bundle

mkdir -p dist
flatpak-builder --repo=dist/repo --force-clean build-dir io.github.docmine17.adbee.yml
flatpak build-bundle dist/repo dist/io.github.docmine17.adbee.flatpak io.github.docmine17.adbee master

The generated bundle will be available at:

dist/io.github.docmine17.adbee.flatpak

License

GPL-3.0-or-later

Credits

TODO