DOCSEARCHbyAlgolia
Submit Docs

bluetuith Documentation

repository·master·Indexed 23 days ago

https://github.com/bluetuith-org/bluetuith

bluetuith is a TUI-based Bluetooth connection manager that serves as a terminal-based alternative to GUI managers like blueman. It provides features for adapter management, device interaction, file transfers, and integrated media control with mouse support. The tool includes a CLI for listing adapters and generating configuration files, and supports platform-specific library and daemon path overrides for non-Linux systems.

Tokens
745
Snippets
0
Records
12
Agent score
80%

What's inside bluetuith

  1. Overview of bluetuith

    master
    bluetuith is a TUI-based (Terminal User Interface) Bluetooth connection manager. It allows users to interact with Bluetooth adapters and devices directly from the terminal. It is designed as a terminal-based replacement for traditional Bluetooth managers like blueman.

  2. Key features of bluetuith

    master

    bluetuith provides a comprehensive TUI for managing Bluetooth operations, including:

    • Adapter Management: Selector for different adapters and status indicators.
    • Device Interaction: Menus and options for interacting with paired and available devices.
    • File Transfers: Progress views for ongoing transfers and authentication views for pairing or starting transfers.
    • Media Control: Integrated media player.
    • User Experience: Mouse support within the TUI.

  3. Check platform-specific feature availability

    master
    Feature availability in bluetuith depends on the underlying platform and Bluetooth stack. To see which features are supported on your specific operating system, consult the feature matrix in the bluetooth-classic repository documentation.

  4. Manage TUI drawing with appBinder

    master

    The appBinder (internal to the Application lifecycle) provides methods to control how the TUI renders updates. While these are primarily used by the internal view system, they define the drawing contract:

    • InstantDraw(drawFunc func()): Queues a drawing function and triggers an immediate update.
    • QueueDraw(drawFunc func()): Queues a drawing function and signals that a refresh is needed, but does not force an immediate draw.
    • Refresh(): Forces a screen refresh via the underlying Draw() method.

  6. Initialize and start a bluetuith Application

    master
    To run the bluetuith TUI, use NewApplication() to create an instance and Start() to begin the lifecycle. The Start method requires a bluetooth.Session, an appfeatures.FeatureSet, and a config.Config. It initializes the views, sets up input/mouse capture, and starts the TUI event loop using tview.