20 lines
811 B
Markdown
20 lines
811 B
Markdown
|
# 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.
|