BB Widget Manager is the hub for the Boutabyte desktop widgets. It installs them from a GitHub catalog, starts and stops each one from a card grid, and toggles autostart per widget. A bb-widgets-cli companion exposes the same actions for scripting.
Overview
A GTK3 desktop app for installing, launching, and managing Boutabyte desktop widgets on Linux.
Features
- Grid card UI — Installed and Browse tabs with widget cards
- Start / Stop — Launch and kill widgets with one click
- Auto Start — Toggle per-widget autostart on login
- Install from catalog — Download and install widgets from GitHub
- Uninstall — Remove widgets cleanly
- CLI companion —
bb-widgets-clifor scripting
Available Widgets
| Widget | Description | Repo |
|---|---|---|
| Claude Usage | Monitor Claude subscription usage | dalwaut/claude-usage-widget |
| Port Scout | Active listening ports with one-click kill | dalwaut/port-scout-widget |
| Clipboard Timeline | Clipboard history with pin favorites | dalwaut/clipboard-timeline-widget |
| Prompt Vault | Save, tag, and reuse AI prompt snippets | dalwaut/prompt-vault-widget |
Requirements
sudo apt install python3-gi python3-gi-cairo
Install
git clone https://github.com/dalwaut/bb-widgets.git ~/.local/share/bb-widgets
cd ~/.local/share/bb-widgets
bash install.sh
This creates:
~/.local/bin/bb-widgets— GTK app~/.local/bin/bb-widgets-cli— CLI- Desktop launcher in your app menu
CLI Usage
bb-widgets-cli list # List installed widgets
bb-widgets-cli install <id> # Install from catalog
bb-widgets-cli uninstall <id> # Remove a widget
bb-widgets-cli start <id> # Start a widget
bb-widgets-cli stop <id> # Stop a widget
bb-widgets-cli autostart <id> on|off # Toggle autostart
Built by Boutabyte
License
MIT