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

BB Widget Manager

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-cli for 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