Install
curl -fsSL https://raw.githubusercontent.com/mkalmousli/nanoblue/main/scripts/install.sh | sh
Uninstall:
curl -fsSL https://raw.githubusercontent.com/mkalmousli/nanoblue/main/scripts/uninstall.sh | sh # or: nanoblue --uninstall
Installs to ~/.local/bin/nanoblue plus a menu entry and icon, no root needed.
Prebuilt binaries (x86_64, aarch64, armv7, i386, riscv64) are on the releases page.
Runtime libraries: libdbus-1, libGL, libX11, and BlueZ running (bluetoothd).
Features
- Realtime device list from BlueZ signals: connect, pair, trust, block, remove, RSSI bars and graph, battery
- Multiple adapters (hci0, hci1, ...) side by side, with scan and power per adapter
- Adapter settings (
E): alias, powered, discoverable, pairable, timeouts, rfkill block, driver info
- Serial terminal over Bluetooth RFCOMM or a local tty (
/dev/ttyUSB*, ttyACM*), hex/text view, baud and EOL control
- Desktop notifications when devices connect, disconnect or pair, and when file transfers finish
- Auto-connect per device (reconnects when it drops), saved in
~/.config/nanoblue/auto
- Send files over OBEX (file dialog via zenity/kdialog, or drop files on the window); needs
obexd
- Tether through a phone: "Use its network" joins its NAP and brings up
bnep0
- Visual action list per device with capability pills (audio, HID, phone, files, network, serial)
- System tray icon (StatusNotifierItem) with menu; closing the window hides to the tray when a tray host exists
- Auto update from GitHub releases (
NANOBLUE_NO_UPDATE=1 to disable, nanoblue --update to update now)
nanoblue --demo shows fake devices, no Bluetooth needed. Ctrl + / Ctrl - scales the UI.
Keys
↑/↓ select · Enter connect · P pair · T trust · B block · X remove · R serial over RFCOMM · L local port · E adapter settings · S scan · O power · F hide unnamed · Tab next adapter · Q quit
Build from source
git clone https://github.com/mkalmousli/nanoblue && cd nanoblue
# needs: cc, git, pkg-config, libdbus-1-dev, libgl1-mesa-dev, libx11-dev (+ libxrandr/xinerama/xcursor/xi-dev for raylib)
cc build.c -o build && ./build # clones and builds raylib 5.5 on first run, output: bin/nanoblue
./build install # optional: ~/.local install
Linux only: BlueZ and D-Bus have no equivalent on macOS or Windows.
License
MIT, see LICENSE. @mkalmousli · Source code
