58 lines
1.5 KiB
Markdown
58 lines
1.5 KiB
Markdown
# owlry-plugins
|
|
|
|
Official plugins and script runtimes for [owlry](https://somegit.dev/Owlibou/owlry).
|
|
|
|
## Plugins
|
|
|
|
| Plugin | Description |
|
|
|--------|-------------|
|
|
| calculator | Mathematical expression evaluation |
|
|
| bookmarks | Browser bookmark search (Firefox, Chrome) |
|
|
| clipboard | Clipboard history via cliphist |
|
|
| emoji | Emoji picker |
|
|
| filesearch | File search via fd/locate |
|
|
| media | MPRIS media player widget |
|
|
| pomodoro | Pomodoro timer widget |
|
|
| scripts | User script launcher |
|
|
| ssh | SSH host quick-connect |
|
|
| system | Power and session management |
|
|
| systemd | systemd user service control |
|
|
| weather | Weather widget |
|
|
| websearch | Web search with configurable engines |
|
|
|
|
## Runtimes
|
|
|
|
| Runtime | Description |
|
|
|---------|-------------|
|
|
| owlry-lua | Lua 5.4 scripting runtime for user plugins |
|
|
| owlry-rune | Rune scripting runtime for user plugins |
|
|
|
|
## Building
|
|
|
|
```bash
|
|
just build # Debug build
|
|
just release # Release build (optimized)
|
|
just plugin calc # Build a single plugin
|
|
just check # cargo check + clippy
|
|
just test # Run tests
|
|
```
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
just install-local # Install all plugins and runtimes to /usr/lib/owlry/
|
|
```
|
|
|
|
Plugins are compiled as `.so` files and installed to `/usr/lib/owlry/plugins/`.
|
|
Runtimes are installed to `/usr/lib/owlry/runtimes/`.
|
|
|
|
## Development
|
|
|
|
See [docs/PLUGIN_DEVELOPMENT.md](docs/PLUGIN_DEVELOPMENT.md) for plugin authoring guide.
|
|
|
|
Plugins depend on `owlry-plugin-api` from the core repo for the ABI-stable interface.
|
|
|
|
## License
|
|
|
|
GPL-3.0-or-later
|