https://github.com/zaloog/blueutil-tui
tui for Mac to interact with bluetooth devices via blueutil
https://github.com/zaloog/blueutil-tui
blueutil macos python textual tui
Last synced: 7 months ago
JSON representation
tui for Mac to interact with bluetooth devices via blueutil
- Host: GitHub
- URL: https://github.com/zaloog/blueutil-tui
- Owner: Zaloog
- Created: 2025-01-18T10:51:05.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-02-26T14:02:22.000Z (8 months ago)
- Last Synced: 2025-04-15T14:14:20.906Z (7 months ago)
- Topics: blueutil, macos, python, textual, tui
- Language: Python
- Homepage:
- Size: 732 KB
- Stars: 17
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
[](https://github.com/astral-sh/ruff)
[](https://pypi.org/project/blueutil-tui/)
[](https://pypi.python.org/pypi/blueutil-tui)
[](https://opensource.org/licenses/MIT)
[](https://pepy.tech/project/blueutil-tui)
# blueutil-tui
blueutil-tui is macos tui to connect bluetooth devices with the help of [blueutil].
Its written in python with the [textual] framework.
## Installation
You can install `blueutil-tui` with one of the following options:
```bash
# not recommended
pip install blueutil-tui
```
```bash
pipx install blueutil-tui
```
```bash
rye install blueutil-tui
```
```bash
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][blueutil_install]):
```bash
brew install blueutil
```
## Usage
`blueutil-tui` can be started with:
```bash
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.
[Changelog]: https://github.com/Zaloog/blueutil-tui/blob/main/CHANGELOG.md
[Issue]: https://github.com/Zaloog/blueutil-tui/issues
[textual]: https://textual.textualize.io
[pipx]: https://github.com/pypa/pipx
[PyPi]: https://pypi.org/project/blueutil-tui/
[rye]: https://rye.astral.sh
[uv]: https://docs.astral.sh/uv
[homebrew]: https://brew.sh
[blueutil]: https://github.com/toy/blueutil
[blueutil_install]: https://github.com/toy/blueutil?tab=readme-ov-file#installupdateuninstall