Zaloog/blueutil-tui

tui for Mac to interact with bluetooth devices via blueutil

Python

53

28 commits

updated Aug 17, 2025

See the code

README

Ruff PyPI-Server Pyversions License: MIT Downloads

blueutil-tui

blueutil-tui is macos tui to connect bluetooth devices with the help of blueutil. Its written in python with the textual framework.

preview

Installation

You can install blueutil-tui with one of the following options:

# not recommended
pip install blueutil-tui
pipx install blueutil-tui
rye install blueutil-tui
uv tool install blueutil-tui

I recommend using pipx, rye or uv to install CLI Tools into an isolated environment.

blueutil-tui requires blueutil to be installed on your system. I recommend using homebrew for installation (Other ways can be found here):

brew install blueutil

Usage

blueutil-tui can be started with:

btui

Only the paired devices are shown. To search for more devices press s. Refreshing the view with r removes the unpaired devices from the view again.

To close blueutil-tui press ctrl+q.

Feedback and Issues

Feel free to reach out and share your feedback, or open an Issue, if something doesnt work as expected. Also check the Changelog for new updates.

blueutil
macos
python
textual
tui

Significant stargazers

Tyce Herrman

16 followers · starred Aug 2026

Zaloog/blueutil-tui

tui for Mac to interact with bluetooth devices via blueutil

Python

53

28 commits

updated Aug 17, 2025

See the code

README

Ruff PyPI-Server Pyversions License: MIT Downloads

blueutil-tui

blueutil-tui is macos tui to connect bluetooth devices with the help of blueutil. Its written in python with the textual framework.

preview

Installation

You can install blueutil-tui with one of the following options:

# not recommended
pip install blueutil-tui
pipx install blueutil-tui
rye install blueutil-tui
uv tool install blueutil-tui

I recommend using pipx, rye or uv to install CLI Tools into an isolated environment.

blueutil-tui requires blueutil to be installed on your system. I recommend using homebrew for installation (Other ways can be found here):

brew install blueutil

Usage

blueutil-tui can be started with:

btui

Only the paired devices are shown. To search for more devices press s. Refreshing the view with r removes the unpaired devices from the view again.

To close blueutil-tui press ctrl+q.

Feedback and Issues

Feel free to reach out and share your feedback, or open an Issue, if something doesnt work as expected. Also check the Changelog for new updates.

blueutil
macos
python
textual
tui

Significant stargazers

Tyce Herrman

16 followers · starred Aug 2026

Languages

Python

100.0%