Skip to content

paul-cch/bloo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bloo

Bluetooth TUI toolkit for macOS.

Scan BLE and Classic Bluetooth devices, browse GATT services, read characteristics, and subscribe to notifications — all from your terminal.

Install

cargo install --path .

Usage

bloo                          # launch with default config
bloo --config path/to/config  # custom config path
bloo --log path/to/log        # custom log path

Keybindings

Key Action
Tab / Shift+Tab Cycle focus between panels
/ Navigate device list
Enter Connect to selected device
u Disconnect from selected device
s Toggle BLE scan / Subscribe to characteristic
r Read selected characteristic
/ Collapse / expand GATT services
/ Filter device list by name
d Cycle value display (hex → ASCII → decimal)
w Write hex bytes to selected characteristic
q Quit

Configuration

Config is auto-created at ~/.config/bloo/config.toml on first run.

[scan]
interval_ms = 500
auto_start = true

[classic]
poll_interval_secs = 5

[ui]
tick_rate_ms = 200
max_notifications = 200
notification_ttl_secs = 5
max_visible_notifications = 3

[theme]
focused_border = "green"
focused_header = "yellow"
highlight_bg = "darkgray"
highlight_fg = "white"
separator = "darkgray"
help_bar = "white"
error = "red"

Theme colors accept named colors (red, green, cyan, ...) or #RRGGBB hex values. Changes to the config are picked up automatically — no restart needed.

Requirements

  • macOS (uses CoreBluetooth via btleplug and system_profiler for Classic BT)
  • Bluetooth permission for your terminal app (System Settings → Privacy & Security → Bluetooth)

License

MIT

About

Bluetooth TUI toolkit for macOS

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages