januxnet / bluetuith

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Go Report Card

demo

bluetuith

bluetuith is a TUI-based bluetooth connection manager, which can interact with bluetooth adapters and devices. It aims to be a replacement to most bluetooth managers, like blueman.

This is only available on Linux.

This project is currently in the alpha stage.

Features

  • Perform pairing with authentication.
  • Perform connection/disconnection to different devices.
  • Interact with bluetooth adapters, toggle power and discovery states
  • Mouse support

Requirements

  • Bluez
  • DBus

Installation

If the go compiler is present in your system, you can install it via the following command: go install github.com/darkhz/bluetuith@latest. Make sure that $HOME/go/bin is in your $PATH.

Or you can navigate to the releases section and download a binary that matches your architecture.

It is also available in the AUR as the bluetuith-bin package.

Usage

bluetuith [<flags>]

Flags:
  --adapter <adapter>      Specify an adapter to use. (For example, hci0)
  --list-adapters          List available adapters.

Keybindings

Operation Keybinding
Open the menu Ctrl+m
Navigate between menus Tab
Navigate between devices/options Up/Down
Toggle adapter power state o
Toggle scan (discovery state) s
Change adapter a
Connect to selected device c
Pair with selected device p
Trust selected device t
Remove device from adapter r
Cancel operation Ctrl+x
Quit q

Planned features

  • OBEX file transfer.
  • Display the device type and icon.
  • Display range (RSSI) of the connected device.

Additional notes

  • Ensure that the bluetooth service is up and running, and it is visible to DBus before launching the application. With systemd you can find out the status using the following command: systemctl status bluetooth.service.

Credits

Special thanks to:

  • vishen, for the bluez implementation here.
  • muka, for the agent implementation here.

About

License:MIT License


Languages

Language:Go 100.0%