Skip to main content

Plugin system

Qomicex supports plugin extensions: install community plugins to gain new features, or build your own.

Install plugins

Plugins ship as .qplugin files (essentially zip packages). There are three ways to install one:
  • Plugin store (when available): browse community plugins and install in one click
  • Local install: Settings → Plugins → Plugin management sub-tab → upload a .qplugin file
  • Development and debugging: plugins installed into the launcher all live in <data directory>/plugins; while developing, use qomicex dev to run the debug harness (see qomicex CLI tool reference)
After installing, you must enable the plugin for it to take effect. Disabling keeps its data; enable it again to restore everything.

What plugins can do

Permissions

Some capabilities require authorization; the launcher asks in a dialog:
  • File read/write: when a plugin requests access to a file or directory, you approve each request
  • Network proxy: lets the plugin reach the internet through the launcher proxy
  • Command execution: runs system commands (PowerShell/Shell), 15-second timeout by default
Plugins hold significant system capabilities (files, network, command execution). Confirm a plugin is trustworthy before installing one from an unknown source.

Manage plugins

In Settings → Plugins:
  • Enable / disable / uninstall
  • Change plugin settings: switch to the “Plugin settings” sub-tab, pick a plugin on the left, and the panel on the right shows the settings that plugin provides (this tab only has content when the plugin declares contributes.settingsPages)
  • Review plugin permissions and dependencies
Plugins with dependencies are checked automatically: installation is refused if a prerequisite is missing, and a plugin is disabled automatically when its prerequisite is disabled.

Build your own

For the complete developer guide (manifest, plugin API, dashboard widget development, CLI tools), see the Plugin development section.