vikingowl 5c93b8a280 docs: update plugin development guide for main defaults, register API, hot-reload
- entry_point → entry (canonical); note alias in manifest section
- Lua quick start and provider functions rewritten for owlry.provider.register() API
- owlry table is pre-registered globally; remove require("owlry") references
- Items documented as plain Lua tables, not method-chained owlry.item() objects
- owlry_version bumped to >=1.0.0 in manifest example
- Rune manifest entry_point → entry
- Add Hot Reload section documenting file-watcher behavior and caveats
2026-03-26 17:52:03 +01:00

owlry-plugins

Official plugins and script runtimes for 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

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

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 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

Description
No description provided
Readme 395 KiB
Languages
Rust 82.4%
Shell 13.6%
Just 4%