bzmenu

bzmenu (BlueZ Menu) manages Bluetooth through your launcher of choice.

• Rust (includes cargo)
• pkg-config – For detecting required libraries
• dbus – For D-Bus integration headers

• bluetoothd – BlueZ daemon
• dbus – For communicating with bluetoothd
• A launcher with stdin mode support

• NerdFonts – For font-based icons (default mode)
• XDG icon theme – For image-based icons (used with -i xdg, included with DEs or can be installed manually)
• Notification daemon – For system notifications (e.g. dunst, fnott, included with DEs or can be installed manually)

Run the following commands:

git clone https://github.com/e-tho/bzmenu
cd bzmenu
cargo build --release

An executable file will be generated at target/release/bzmenu, which you can then copy to a directory in your $PATH.

Add the flake as an input:

inputs.bzmenu.url = "github:e-tho/bzmenu";

Install the package:

{ inputs, ... }:
{
  environment.systemPackages = [ inputs.bzmenu.packages.${pkgs.system}.default ];
}

Install the package with your favorite AUR helper:

paru -S bzmenu-git

Specify an application using -l or --launcher flag.

bzmenu -l fuzzel

Specify custom as the launcher and set your command using the --launcher-command flag. Ensure your launcher supports stdin mode, and that it is properly configured in the command.

bzmenu -l custom --launcher-command "my_custom_launcher --flag"

Use either {prompt} or {placeholder} as the value for the relevant flag in your command; each will be replaced with the appropriate text as needed. They return the same string, with {prompt} adding a colon at the end.

bzmenu -l custom --launcher-command "my_custom_launcher --prompt-flag '{prompt}'" # or --placeholder-flag '{placeholder}'

This example demonstrates enabling all available features in custom mode with fuzzel.

bzmenu -l custom --launcher-command "fuzzel -d -p '{prompt}'"

GPLv3

If you find this project useful and would like to help me dedicate more time to its development, consider supporting my work.