# Example Launcher Plugin Template

Minimal correct launcher extension.

## Important Differences from Widget Plugins

- Root element **must** be a `QtObject`, not an `Item` or `PluginComponent`.
- You implement `getItems(query)` and `executeItem(item)`.
- No visual UI of your own — you return data that the launcher renders.

## Usage

1. Copy the folder.
2. Update `plugin.json` — especially the `trigger` (what the user types to activate you).
3. Implement real search logic in `getItems`.
4. Handle actions in `executeItem` (copy, open URL, run command, etc.).

See the official docs for paste support (`getPasteText`/`getPasteArgs`), dynamic categories, and requesting launcher updates after async work.

Good real-world references: DankGifSearch and DankStickerSearch in the first-party plugins repo.