Plugin Manager 🔌

Overview

A builtin plugin providing a comprehensive graphical user interface for discovering, installing, and managing TonieToolbox plugins from the community marketplace.

---

✨ Features

🔍 Discover Tab - Browse the Plugin Marketplace

• Browse community plugins from configured repositories
• Real-time search by name, description, author, or tags
• Advanced filtering by plugin type (GUI, processor, integration, tool, theme, language)
• Plugin information cards showing:
  • Version, author, and description
  • Installation status (installed/available)
  • Verification status (verified/unverified)
  • Plugin tags and type badge
• One-click installation with automatic dependency resolution
• Smart dependency preview - Shows all plugin and Python package dependencies before installation with confirmation dialog
• Network status indicators for repository connectivity

📦 Installed Tab - Manage Your Plugins

• View all installed plugins (builtin + community)
• Enable/disable plugins
• Uninstall community plugins (builtin plugins are protected)
• Plugin status badges - Enabled/Disabled/Builtin indicators
• Current metadata display - Version, author, type, description
• Quick actions - Enable, disable, and uninstall with single clicks

⚙️ Settings Tab - Configure Marketplace Behavior

• Repository management - Add/edit custom plugin repository URLs
• Automatic updates - Enable/disable automatic update checks on startup
• Update intervals - Configure check frequency (1-168 hours)
• Security settings:
  • Toggle SHA512 checksum verification (recommended: enabled)
  • Allow/block unverified plugins
• Performance tuning - Max parallel downloads (1-10)
• Builtin plugin control - Enable/disable loading of builtin plugins

---

📖 Usage

From Main GUI

The Plugin Manager is automatically registered as a menu item in the main TonieToolbox GUI:

Tools → Plugin Manager

---

📸 Screenshots

Discover Tab

Browse the plugin marketplace with real-time search, filtering, and dependency preview before installation.

Installed Tab

View and manage all installed plugins from the community marketplace with quick enable/disable toggles and uninstall options.

View and manage all installed plugins that comes as part of TonieToolbox with quick enable/disable

Settings Tab

Configure repository sources, update checking behavior, security settings, and performance options.

---

⚙️ Configuration

Plugin marketplace settings are managed through ConfigManager under the plugins.* namespace:

Repository Settings

• plugins.repository_urls (List[str]) - Plugin repository index URLs
  • Default: ["https://raw.githubusercontent.com/TonieToolbox/tonietoolbox_plugins/main/index.json"]
  • Multiple repositories supported for community/private repos

Update Settings

• plugins.auto_update_check (bool) - Automatically check for plugin updates on startup
  • Default: True
• plugins.update_check_interval (int) - Hours between update checks
  • Range: 1-168 hours (1 hour to 1 week)
  • Default: 24 (daily)

Security Settings

• plugins.verify_checksums (bool) - Verify SHA512 checksums for downloaded plugins
  • Default: True (recommended for security)
• plugins.allow_unverified_plugins (bool) - Allow installation of unverified plugins
  • Default: False (only verified plugins allowed)

Performance Settings

• plugins.max_parallel_downloads (int) - Maximum concurrent plugin downloads
  • Range: 1-10
  • Default: 3

Core Settings

• plugins.load_builtin_plugins (bool) - Load builtin plugins on application startup
  • Default: True