chore(owlry-rune): bump version to 0.4.9

chore(owlry-lua): bump version to 0.4.9
chore(plugins): bump all plugins to 0.4.9
2026-01-02 16:18:19 +01:00 · 2026-01-02 16:18:18 +01:00 · 2026-01-02 16:18:18 +01:00 · 2026-01-02 16:18:08 +01:00 · 2026-01-02 16:18:00 +01:00 · 2026-01-01 23:30:45 +01:00
28 changed files with 740 additions and 283 deletions
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -2373,7 +2373,7 @@ dependencies = [

 [[package]]
 name = "owlry"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "chrono",
 "clap",
@@ -2402,7 +2402,7 @@ dependencies = [

 [[package]]
 name = "owlry-lua"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "chrono",
@@ -2420,7 +2420,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-api"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "serde",
@@ -2428,7 +2428,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-bookmarks"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "dirs",
@@ -2440,7 +2440,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-calculator"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "meval",
@@ -2449,7 +2449,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-clipboard"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "owlry-plugin-api",
@@ -2457,7 +2457,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-emoji"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "owlry-plugin-api",
@@ -2465,7 +2465,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-filesearch"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "dirs",
@@ -2474,7 +2474,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-media"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "owlry-plugin-api",
@@ -2482,7 +2482,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-pomodoro"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "dirs",
@@ -2494,7 +2494,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-scripts"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "dirs",
@@ -2503,7 +2503,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-ssh"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "dirs",
@@ -2512,7 +2512,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-system"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "owlry-plugin-api",
@@ -2520,7 +2520,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-systemd"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "owlry-plugin-api",
@@ -2528,7 +2528,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-weather"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "dirs",
@@ -2541,7 +2541,7 @@ dependencies = [

 [[package]]
 name = "owlry-plugin-websearch"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "abi_stable",
 "owlry-plugin-api",
@@ -2549,7 +2549,7 @@ dependencies = [

 [[package]]
 name = "owlry-rune"
-version = "0.4.5"
+version = "0.4.9"
 dependencies = [
 "chrono",
 "dirs",
--- a/README.md
+++ b/README.md
@@ -32,10 +32,10 @@ yay -S owlry
 yay -S owlry-plugin-calculator owlry-plugin-weather

 # Or install bundles:
-yay -S owlry-essentials  # calculator, system, ssh, scripts, bookmarks
-yay -S owlry-widgets     # weather, media, pomodoro
-yay -S owlry-tools       # clipboard, emoji, websearch, filesearch, systemd
-yay -S owlry-full        # everything
+yay -S owlry-meta-essentials  # calculator, system, ssh, scripts, bookmarks
+yay -S owlry-meta-widgets     # weather, media, pomodoro
+yay -S owlry-meta-tools       # clipboard, emoji, websearch, filesearch, systemd
+yay -S owlry-meta-full        # everything

 # For custom Lua/Rune plugins
 yay -S owlry-lua   # Lua 5.4 runtime
@@ -53,7 +53,7 @@ yay -S owlry-rune  # Rune runtime
 | `owlry-plugin-clipboard` | History via cliphist |
 | `owlry-plugin-emoji` | 400+ searchable emoji |
 | `owlry-plugin-scripts` | User scripts |
-| `owlry-plugin-bookmarks` | Chrome, Brave, Edge bookmarks |
+| `owlry-plugin-bookmarks` | Firefox, Chrome, Brave, Edge bookmarks |
 | `owlry-plugin-websearch` | Web search (`? query`) |
 | `owlry-plugin-filesearch` | File search (`/ filename`) |
 | `owlry-plugin-systemd` | User services with actions |
@@ -99,12 +99,40 @@ sudo cp target/release/libowlry_plugin_*.so /usr/lib/owlry/plugins/
 ## Usage

 ```bash
-owlry                      # Launch with defaults
-owlry --mode app           # Applications only
-owlry --providers app,cmd  # Specific providers
-owlry --help               # Show all options
+owlry                      # Launch with all providers
+owlry -m app               # Applications only
+owlry -m cmd               # PATH commands only
+owlry -p app,cmd           # Multiple specific providers
+owlry -m calc              # Calculator plugin only (if installed)
+owlry --help               # Show all options with examples
 ```

+### dmenu Mode
+
+Owlry is dmenu-compatible. Pipe input for interactive selection:
+
+```bash
+# Basic selection
+echo -e "Option A\nOption B\nOption C" | owlry -m dmenu
+
+# Select from files
+ls ~/Documents | owlry -m dmenu
+
+# Git branch checkout
+git branch | owlry -m dmenu --prompt "checkout:" | xargs git checkout
+
+# Kill a process
+ps -eo comm | sort -u | owlry -m dmenu --prompt "kill:" | xargs pkill
+
+# Select and open a project
+find ~/projects -maxdepth 1 -type d | owlry -m dmenu | xargs code
+
+# Package manager search
+pacman -Ssq | owlry -m dmenu --prompt "install:" | xargs sudo pacman -S
+```
+
+The `--prompt` flag sets a custom label for the search input.
+
 ### Keyboard Shortcuts

 | Key | Action |
@@ -158,6 +186,21 @@ Owlry follows the [XDG Base Directory Specification](https://specifications.free
 | `~/.local/share/owlry/scripts/` | User scripts |
 | `~/.local/share/owlry/frecency.json` | Usage history |

+System locations:
+| Path | Purpose |
+|------|---------|
+| `/usr/lib/owlry/plugins/*.so` | Installed native plugins |
+| `/usr/lib/owlry/runtimes/*.so` | Lua/Rune script runtimes |
+| `/usr/share/doc/owlry/config.example.toml` | Example configuration |
+
+### Quick Start
+
+```bash
+# Copy example config
+mkdir -p ~/.config/owlry
+cp /usr/share/doc/owlry/config.example.toml ~/.config/owlry/config.toml
+```
+
 ### Example Configuration

 ```toml
@@ -169,8 +212,8 @@ tabs = ["app", "cmd", "uuctl"]
 # launch_wrapper = "uwsm app --" # Auto-detected

 [appearance]
-width = 700
-height = 500
+width = 850
+height = 650
 font_size = 14
 border_radius = 12
 # theme = "owl"  # Or: catppuccin-mocha, nord, dracula, etc.
@@ -178,17 +221,18 @@ border_radius = 12
 [plugins]
 disabled = []  # Plugin IDs to disable, e.g., ["emoji", "pomodoro"]

-# Per-plugin configuration (new in 0.4.0)
-[plugins.weather]
-provider = "wttr.in"  # or: openweathermap, open-meteo
-location = "Berlin"   # city name or "lat,lon"
-# api_key = "..."     # Required for OpenWeatherMap
+[providers]
+applications = true    # .desktop files
+commands = true        # PATH executables
+frecency = true        # Boost frequently used items
+frecency_weight = 0.3  # 0.0-1.0

-[plugins.pomodoro]
-work_mins = 25        # Work session duration
-break_mins = 5        # Break duration
+# Web search engine: google, duckduckgo, bing, startpage, brave, ecosia
+search_engine = "duckduckgo"
 ```

+See `/usr/share/doc/owlry/config.example.toml` for all options with documentation.
+
 ## Plugin System

 Owlry uses a modular plugin architecture. Plugins are loaded from:
@@ -205,6 +249,38 @@ Add plugin IDs to the disabled list in your config:
 disabled = ["emoji", "pomodoro"]
 ```

+### Plugin Management CLI
+
+```bash
+# List installed plugins
+owlry plugin list
+owlry plugin list --enabled        # Only enabled
+owlry plugin list --available      # Show registry plugins
+
+# Search registry
+owlry plugin search "weather"
+
+# Install/remove
+owlry plugin install <name>        # From registry
+owlry plugin install ./my-plugin   # From local path
+owlry plugin remove <name>
+
+# Enable/disable
+owlry plugin enable <name>
+owlry plugin disable <name>
+
+# Plugin info
+owlry plugin info <name>
+owlry plugin commands <name>       # List plugin CLI commands
+
+# Create new plugin
+owlry plugin create my-plugin              # Lua (default)
+owlry plugin create my-plugin -r rune      # Rune
+
+# Run plugin command
+owlry plugin run <plugin-id> <command> [args...]
+```
+
 ### Creating Custom Plugins

 See [docs/PLUGIN_DEVELOPMENT.md](docs/PLUGIN_DEVELOPMENT.md) for:
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -0,0 +1,109 @@
+# Owlry Roadmap
+
+Feature ideas and future development plans for Owlry.
+
+## High Value, Low Effort
+
+### Plugin hot-reload
+Detect `.so` file changes in `/usr/lib/owlry/plugins/` and reload without restarting the launcher. The loader infrastructure already exists.
+
+### Frecency pruning
+Add `max_entries` and `max_age_days` config options. Prune old entries on startup to prevent `frecency.json` from growing unbounded.
+
+### `:recent` prefix
+Show last N launched items. Data already exists in frecency.json — just needs a provider to surface it.
+
+### Clipboard images
+`cliphist` supports images. Extend the clipboard plugin to show image thumbnails in results.
+
+---
+
+## Medium Effort, High Value
+
+### Actions on any result
+Generalize the submenu system beyond systemd. Every result type gets contextual actions:
+
+| Provider | Actions |
+|----------|---------|
+| Applications | Open, Open in terminal, Show .desktop location |
+| Files | Open, Open folder, Copy path, Delete |
+| SSH | Connect, Copy hostname, Edit config |
+| Bookmarks | Open, Copy URL, Open incognito |
+| Clipboard | Paste, Delete from history |
+
+This is the difference between a launcher and a command palette.
+
+### Plugin settings UI
+A `:settings` provider that lists installed plugins and their configurable options. Edit values inline, writes to `config.toml`.
+
+### Result action capture
+Calculator shows `= 5+3 → 8`. Allow pressing Tab or Ctrl+C to copy the result to clipboard instead of "launching" it. Useful for calculator, file paths, URLs.
+
+---
+
+## Bigger Bets
+
+### Window switcher with live thumbnails
+A `windows` plugin using Wayland screencopy to show live thumbnails of open windows. Hyprland and Sway expose window lists via IPC. Could replace Alt+Tab.
+
+### Cross-device bookmark sync
+Firefox and Chrome sync bookmarks across devices. Parse sync metadata to show "recently added on other devices" or "bookmarks from phone".
+
+### Natural language commands
+Parse simple natural language into system commands:
+
+```
+"shutdown in 30 minutes" → systemd-run --user --on-active=30m systemctl poweroff
+"remind me in 1 hour"    → notify-send scheduled via at/systemd timer
+"volume 50%"             → wpctl set-volume @DEFAULT_AUDIO_SINK@ 0.5
+```
+
+Local pattern matching, no AI/cloud required.
+
+### Plugin marketplace
+A curated registry of third-party Lua/Rune plugins with one-command install:
+
+```bash
+owlry plugin install github-notifications
+owlry plugin install todoist
+owlry plugin install spotify-controls
+```
+
+The script runtimes make this viable without recompiling.
+
+---
+
+## Technical Debt
+
+### Split monorepo for user build efficiency
+Currently, a small core fix requires all 16 AUR packages to rebuild (same source tarball). Split into 3 repos:
+
+| Repo | Contents | Versioning |
+|------|----------|------------|
+| `owlry` | Core binary | Independent |
+| `owlry-plugin-api` | ABI interface (crates.io) | Semver, conservative |
+| `owlry-plugins` | 13 plugins + 2 runtimes | Independent per plugin |
+
+**Execution order:**
+1. Publish `owlry-plugin-api` to crates.io
+2. Update monorepo to use crates.io dependency
+3. Create `owlry-plugins` repo, move plugins + runtimes
+4. Slim current repo to core-only
+5. Update AUR PKGBUILDs with new source URLs
+
+**Benefit:** Core bugfix = 1 rebuild. Plugin fix = 1 rebuild. Third-party plugins possible via crates.io.
+
+### Replace meval with evalexpr
+`meval` depends on `nom v1.2.4` which will be rejected by future Rust versions. Migrate calculator plugin and Lua runtime to `evalexpr` v13+.
+
+### Plugin API backwards compatibility
+When `API_VERSION` increments, provide a compatibility shim so v3 plugins work with v4 core. Prevents ecosystem fragmentation.
+
+### Per-plugin configuration
+Current flat `[providers]` config doesn't scale. Design a `[plugins.weather]`, `[plugins.pomodoro]` structure that plugins can declare and the core validates.
+
+---
+
+## Priority
+
+If we had to pick one: **Actions on any result**. It transforms every provider from "search and launch" to "search and do anything". The ROI is massive.
--- a/crates/owlry-lua/Cargo.toml
+++ b/crates/owlry-lua/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-lua"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-api/Cargo.toml
+++ b/crates/owlry-plugin-api/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-api"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-bookmarks/Cargo.toml
+++ b/crates/owlry-plugin-bookmarks/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-bookmarks"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-calculator/Cargo.toml
+++ b/crates/owlry-plugin-calculator/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-calculator"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-clipboard/Cargo.toml
+++ b/crates/owlry-plugin-clipboard/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-clipboard"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-emoji/Cargo.toml
+++ b/crates/owlry-plugin-emoji/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-emoji"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-filesearch/Cargo.toml
+++ b/crates/owlry-plugin-filesearch/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-filesearch"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-media/Cargo.toml
+++ b/crates/owlry-plugin-media/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-media"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-pomodoro/Cargo.toml
+++ b/crates/owlry-plugin-pomodoro/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-pomodoro"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-scripts/Cargo.toml
+++ b/crates/owlry-plugin-scripts/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-scripts"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-ssh/Cargo.toml
+++ b/crates/owlry-plugin-ssh/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-ssh"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-system/Cargo.toml
+++ b/crates/owlry-plugin-system/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-system"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-systemd/Cargo.toml
+++ b/crates/owlry-plugin-systemd/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-systemd"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-weather/Cargo.toml
+++ b/crates/owlry-plugin-weather/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-weather"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-plugin-websearch/Cargo.toml
+++ b/crates/owlry-plugin-websearch/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-plugin-websearch"
-version = "0.4.5"
+version = "0.4.9"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true
--- a/crates/owlry-rune/Cargo.toml
+++ b/crates/owlry-rune/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry-rune"
-version = "0.4.5"
+version = "0.4.9"
 edition = "2024"
 rust-version = "1.90"
 description = "Rune scripting runtime for owlry plugins"
--- a/crates/owlry/Cargo.toml
+++ b/crates/owlry/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "owlry"
-version = "0.4.5"
+version = "0.4.9"
 edition = "2024"
 rust-version = "1.90"
 description = "A lightweight, owl-themed application launcher for Wayland"
--- a/crates/owlry/src/cli.rs
+++ b/crates/owlry/src/cli.rs
@@ -10,19 +10,55 @@ use crate::providers::ProviderType;
 #[command(
    name = "owlry",
    about = "An owl-themed application launcher for Wayland",
-    version
+    long_about = "An owl-themed application launcher for Wayland, built with GTK4 and Layer Shell.\n\n\
+                  Owlry provides fuzzy search across applications, commands, and plugins.\n\
+                  Native plugins add features like calculator, clipboard, emoji, weather, and more.",
+    version,
+    after_help = "\
+EXAMPLES:
+    owlry                           Launch with all providers
+    owlry -m app                    Applications only
+    owlry -m cmd                    PATH commands only
+    owlry -m dmenu                  dmenu-compatible mode (reads from stdin)
+    owlry -p app,cmd                Multiple providers
+    owlry -m calc                   Calculator plugin only (if installed)
+
+DMENU MODE:
+    Pipe input to owlry for interactive selection:
+
+    echo -e \"Option A\\nOption B\" | owlry -m dmenu
+    ls | owlry -m dmenu
+    git branch | owlry -m dmenu --prompt \"checkout:\"
+
+SEARCH PREFIXES:
+    :app firefox                    Search applications
+    :cmd git                        Search PATH commands
+    = 5+3                           Calculator (requires plugin)
+    ? rust docs                     Web search (requires plugin)
+    / .bashrc                       File search (requires plugin)
+
+For configuration, see ~/.config/owlry/config.toml
+For plugin management, see: owlry plugin --help"
 )]
 pub struct CliArgs {
-    /// Start in single-provider mode (app, cmd, uuctl)
-    #[arg(long, short = 'm', value_parser = parse_provider)]
+    /// Start in single-provider mode
+    ///
+    /// Core modes: app, cmd, dmenu
+    /// Plugin modes: calc, clip, emoji, ssh, sys, bm, file, web, uuctl, weather, media, pomodoro
+    #[arg(long, short = 'm', value_parser = parse_provider, value_name = "MODE")]
    pub mode: Option<ProviderType>,

-    /// Comma-separated list of enabled providers (app,cmd,uuctl)
-    #[arg(long, short = 'p', value_delimiter = ',', value_parser = parse_provider)]
+    /// Comma-separated list of enabled providers
+    ///
+    /// Examples: -p app,cmd or -p app,calc,emoji
+    #[arg(long, short = 'p', value_delimiter = ',', value_parser = parse_provider, value_name = "PROVIDERS")]
    pub providers: Option<Vec<ProviderType>>,

-    /// Custom prompt text for the search input (useful for dmenu mode)
-    #[arg(long)]
+    /// Custom prompt text for the search input
+    ///
+    /// Useful in dmenu mode to indicate what the user is selecting.
+    /// Example: --prompt "Select file:"
+    #[arg(long, value_name = "TEXT")]
    pub prompt: Option<String>,

    /// Subcommand to run (if any)
--- a/crates/owlry/src/paths.rs
+++ b/crates/owlry/src/paths.rs
@@ -99,23 +99,57 @@ pub fn frecency_file() -> Option<PathBuf> {
 // =============================================================================

 /// System data directories for applications (XDG_DATA_DIRS)
+///
+/// Follows the XDG Base Directory Specification:
+/// - $XDG_DATA_HOME/applications (defaults to ~/.local/share/applications)
+/// - $XDG_DATA_DIRS/*/applications (defaults to /usr/local/share:/usr/share)
+/// - Additional Flatpak and Snap directories
 pub fn system_data_dirs() -> Vec<PathBuf> {
    let mut dirs = Vec::new();
+    let mut seen = std::collections::HashSet::new();

-    // User data directory first
+    // Helper to add unique directories
+    let mut add_dir = |path: PathBuf| {
+        if seen.insert(path.clone()) {
+            dirs.push(path);
+        }
+    };
+
+    // 1. User data directory first (highest priority)
    if let Some(data) = data_home() {
-        dirs.push(data.join("applications"));
+        add_dir(data.join("applications"));
    }

-    // System directories
-    dirs.push(PathBuf::from("/usr/share/applications"));
-    dirs.push(PathBuf::from("/usr/local/share/applications"));
+    // 2. XDG_DATA_DIRS - parse the environment variable
+    // Default per spec: /usr/local/share:/usr/share
+    let xdg_data_dirs = std::env::var("XDG_DATA_DIRS")
+        .unwrap_or_else(|_| "/usr/local/share:/usr/share".to_string());

-    // Flatpak directories
-    if let Some(data) = data_home() {
-        dirs.push(data.join("flatpak/exports/share/applications"));
+    for dir in xdg_data_dirs.split(':') {
+        if !dir.is_empty() {
+            add_dir(PathBuf::from(dir).join("applications"));
+        }
    }
-    dirs.push(PathBuf::from("/var/lib/flatpak/exports/share/applications"));
+
+    // 3. Always include standard system directories as fallback
+    // Some environments set XDG_DATA_DIRS without including these
+    add_dir(PathBuf::from("/usr/share/applications"));
+    add_dir(PathBuf::from("/usr/local/share/applications"));
+
+    // 4. Flatpak directories (user and system)
+    if let Some(data) = data_home() {
+        add_dir(data.join("flatpak/exports/share/applications"));
+    }
+    add_dir(PathBuf::from("/var/lib/flatpak/exports/share/applications"));
+
+    // 5. Snap directories
+    add_dir(PathBuf::from("/var/lib/snapd/desktop/applications"));
+
+    // 6. Nix directories (common on NixOS)
+    if let Some(home) = dirs::home_dir() {
+        add_dir(home.join(".nix-profile/share/applications"));
+    }
+    add_dir(PathBuf::from("/run/current-system/sw/share/applications"));

    dirs
 }
--- a/crates/owlry/src/providers/application.rs
+++ b/crates/owlry/src/providers/application.rs
@@ -98,6 +98,15 @@ impl Provider for ApplicationProvider {
        // Empty locale list for default locale
        let locales: &[&str] = &[];

+        // Get current desktop environment(s) for OnlyShowIn/NotShowIn filtering
+        // XDG_CURRENT_DESKTOP can be colon-separated (e.g., "ubuntu:GNOME")
+        let current_desktops: Vec<String> = std::env::var("XDG_CURRENT_DESKTOP")
+            .unwrap_or_default()
+            .split(':')
+            .filter(|s| !s.is_empty())
+            .map(|s| s.to_string())
+            .collect();
+
        for path in Iter::new(dirs.into_iter()) {
            let content = match std::fs::read_to_string(&path) {
                Ok(c) => c,
@@ -125,6 +134,24 @@ impl Provider for ApplicationProvider {
                continue;
            }

+            // Apply OnlyShowIn/NotShowIn filters only if we know the current desktop
+            // If XDG_CURRENT_DESKTOP is not set, show all apps (don't filter)
+            if !current_desktops.is_empty() {
+                // OnlyShowIn: if set, current desktop must be in the list
+                if desktop_entry.only_show_in().is_some_and(|only| {
+                    !current_desktops.iter().any(|de| only.contains(&de.as_str()))
+                }) {
+                    continue;
+                }
+
+                // NotShowIn: if current desktop is in the list, skip
+                if desktop_entry.not_show_in().is_some_and(|not| {
+                    current_desktops.iter().any(|de| not.contains(&de.as_str()))
+                }) {
+                    continue;
+                }
+            }
+
            let name = match desktop_entry.name(locales) {
                Some(n) => n.to_string(),
                None => continue,
@@ -135,12 +162,17 @@ impl Provider for ApplicationProvider {
                None => continue,
            };

-            // Extract categories as tags (lowercase for consistency)
-            let tags: Vec<String> = desktop_entry
+            // Extract categories and keywords as tags (lowercase for consistency)
+            let mut tags: Vec<String> = desktop_entry
                .categories()
                .map(|cats| cats.into_iter().map(|s| s.to_lowercase()).collect())
                .unwrap_or_default();

+            // Add keywords for searchability (e.g., Nautilus has Name=Files but Keywords contains "nautilus")
+            if let Some(keywords) = desktop_entry.keywords(locales) {
+                tags.extend(keywords.into_iter().map(|s| s.to_lowercase()));
+            }
+
            let item = LaunchItem {
                id: path.to_string_lossy().to_string(),
                name,
@@ -157,6 +189,13 @@ impl Provider for ApplicationProvider {

        debug!("Found {} applications", self.items.len());

+        #[cfg(feature = "dev-logging")]
+        debug!(
+            "XDG_CURRENT_DESKTOP={:?}, scanned dirs count={}",
+            current_desktops,
+            Self::get_application_dirs().len()
+        );
+
        // Sort alphabetically by name
        self.items.sort_by(|a, b| a.name.to_lowercase().cmp(&b.name.to_lowercase()));
    }
@@ -210,4 +249,18 @@ mod tests {
            "bash -c 'echo %u'"
        );
    }
+
+    #[test]
+    fn test_clean_desktop_exec_preserves_env() {
+        // env VAR=value pattern should be preserved
+        assert_eq!(
+            clean_desktop_exec_field("env GDK_BACKEND=x11 UBUNTU_MENUPROXY=0 audacity %F"),
+            "env GDK_BACKEND=x11 UBUNTU_MENUPROXY=0 audacity"
+        );
+        // Multiple env vars
+        assert_eq!(
+            clean_desktop_exec_field("env FOO=bar BAZ=qux myapp %u"),
+            "env FOO=bar BAZ=qux myapp"
+        );
+    }
 }
--- a/crates/owlry/src/providers/mod.rs
+++ b/crates/owlry/src/providers/mod.rs
@@ -95,8 +95,10 @@ pub trait Provider: Send {

 /// Manages all providers and handles searching
 pub struct ProviderManager {
-    /// Static providers (apps, commands, and native static plugins)
+    /// Core static providers (apps, commands, dmenu)
    providers: Vec<Box<dyn Provider>>,
+    /// Static native plugin providers (need query() for submenu support)
+    static_native_providers: Vec<NativeProvider>,
    /// Dynamic providers from native plugins (calculator, websearch, filesearch)
    /// These are queried per-keystroke, not cached
    dynamic_providers: Vec<NativeProvider>,
@@ -118,6 +120,7 @@ impl ProviderManager {
    pub fn with_native_plugins(native_providers: Vec<NativeProvider>) -> Self {
        let mut manager = Self {
            providers: Vec::new(),
+            static_native_providers: Vec::new(),
            dynamic_providers: Vec::new(),
            widget_providers: Vec::new(),
            matcher: SkimMatcherV2::default(),
@@ -149,9 +152,9 @@ impl ProviderManager {
                    info!("Registered widget provider: {} ({})", provider.name(), type_id);
                    manager.widget_providers.push(provider);
                } else {
-                    // Static providers with Normal position
+                    // Static native providers (keep as NativeProvider for query/submenu support)
                    info!("Registered static provider: {} ({})", provider.name(), type_id);
-                    manager.providers.push(Box::new(provider));
+                    manager.static_native_providers.push(provider);
                }
            }
        }
@@ -170,7 +173,7 @@ impl ProviderManager {
    }

    pub fn refresh_all(&mut self) {
-        // Refresh static providers (fast, local operations)
+        // Refresh core providers (apps, commands)
        for provider in &mut self.providers {
            provider.refresh();
            info!(
@@ -180,6 +183,16 @@ impl ProviderManager {
            );
        }

+        // Refresh static native providers (clipboard, emoji, ssh, etc.)
+        for provider in &mut self.static_native_providers {
+            provider.refresh();
+            info!(
+                "Static provider '{}' loaded {} items",
+                provider.name(),
+                provider.items().len()
+            );
+        }
+
        // Widget providers are refreshed separately to avoid blocking startup
        // Call refresh_widgets() after window is shown

@@ -201,9 +214,13 @@ impl ProviderManager {
    }

    /// Find a native provider by type ID
-    /// Searches in widget providers and dynamic providers
+    /// Searches in all native provider lists (static, dynamic, widget)
    pub fn find_native_provider(&self, type_id: &str) -> Option<&NativeProvider> {
-        // Check widget providers first (pomodoro, weather, media)
+        // Check static native providers first (clipboard, emoji, ssh, systemd, etc.)
+        if let Some(p) = self.static_native_providers.iter().find(|p| p.type_id() == type_id) {
+            return Some(p);
+        }
+        // Check widget providers (pomodoro, weather, media)
        if let Some(p) = self.widget_providers.iter().find(|p| p.type_id() == type_id) {
            return Some(p);
        }
@@ -246,37 +263,40 @@ impl ProviderManager {
        }
    }

+    /// Iterate over all static provider items (core + native static plugins)
+    fn all_static_items(&self) -> impl Iterator<Item = &LaunchItem> {
+        self.providers
+            .iter()
+            .flat_map(|p| p.items().iter())
+            .chain(self.static_native_providers.iter().flat_map(|p| p.items().iter()))
+    }
+
    #[allow(dead_code)]
    pub fn search(&self, query: &str, max_results: usize) -> Vec<(LaunchItem, i64)> {
        if query.is_empty() {
            // Return recent/popular items when query is empty
-            return self.providers
-                .iter()
-                .flat_map(|p| p.items().iter().cloned())
+            return self.all_static_items()
                .take(max_results)
-                .map(|item| (item, 0))
+                .map(|item| (item.clone(), 0))
                .collect();
        }

-        let mut results: Vec<(LaunchItem, i64)> = self.providers
-            .iter()
-            .flat_map(|provider| {
-                provider.items().iter().filter_map(|item| {
-                    // Match against name and description
-                    let name_score = self.matcher.fuzzy_match(&item.name, query);
-                    let desc_score = item.description
-                        .as_ref()
-                        .and_then(|d| self.matcher.fuzzy_match(d, query));
+        let mut results: Vec<(LaunchItem, i64)> = self.all_static_items()
+            .filter_map(|item| {
+                // Match against name and description
+                let name_score = self.matcher.fuzzy_match(&item.name, query);
+                let desc_score = item.description
+                    .as_ref()
+                    .and_then(|d| self.matcher.fuzzy_match(d, query));

-                    let score = match (name_score, desc_score) {
-                        (Some(n), Some(d)) => Some(n.max(d)),
-                        (Some(n), None) => Some(n),
-                        (None, Some(d)) => Some(d / 2), // Lower weight for description matches
-                        (None, None) => None,
-                    };
+                let score = match (name_score, desc_score) {
+                    (Some(n), Some(d)) => Some(n.max(d)),
+                    (Some(n), None) => Some(n),
+                    (None, Some(d)) => Some(d / 2), // Lower weight for description matches
+                    (None, None) => None,
+                };

-                    score.map(|s| (item.clone(), s))
-                })
+                score.map(|s| (item.clone(), s))
            })
            .collect();

@@ -293,38 +313,45 @@ impl ProviderManager {
        max_results: usize,
        filter: &crate::filter::ProviderFilter,
    ) -> Vec<(LaunchItem, i64)> {
+        // Collect items from core providers
+        let core_items = self
+            .providers
+            .iter()
+            .filter(|p| filter.is_active(p.provider_type()))
+            .flat_map(|p| p.items().iter().cloned());
+
+        // Collect items from static native providers
+        let native_items = self
+            .static_native_providers
+            .iter()
+            .filter(|p| filter.is_active(p.provider_type()))
+            .flat_map(|p| p.items().iter().cloned());
+
        if query.is_empty() {
-            return self
-                .providers
-                .iter()
-                .filter(|p| filter.is_active(p.provider_type()))
-                .flat_map(|p| p.items().iter().cloned())
+            return core_items
+                .chain(native_items)
                .take(max_results)
                .map(|item| (item, 0))
                .collect();
        }

-        let mut results: Vec<(LaunchItem, i64)> = self
-            .providers
-            .iter()
-            .filter(|provider| filter.is_active(provider.provider_type()))
-            .flat_map(|provider| {
-                provider.items().iter().filter_map(|item| {
-                    let name_score = self.matcher.fuzzy_match(&item.name, query);
-                    let desc_score = item
-                        .description
-                        .as_ref()
-                        .and_then(|d| self.matcher.fuzzy_match(d, query));
+        let mut results: Vec<(LaunchItem, i64)> = core_items
+            .chain(native_items)
+            .filter_map(|item| {
+                let name_score = self.matcher.fuzzy_match(&item.name, query);
+                let desc_score = item
+                    .description
+                    .as_ref()
+                    .and_then(|d| self.matcher.fuzzy_match(d, query));

-                    let score = match (name_score, desc_score) {
-                        (Some(n), Some(d)) => Some(n.max(d)),
-                        (Some(n), None) => Some(n),
-                        (None, Some(d)) => Some(d / 2),
-                        (None, None) => None,
-                    };
+                let score = match (name_score, desc_score) {
+                    (Some(n), Some(d)) => Some(n.max(d)),
+                    (Some(n), None) => Some(n),
+                    (None, Some(d)) => Some(d / 2),
+                    (None, None) => None,
+                };

-                    score.map(|s| (item.clone(), s))
-                })
+                score.map(|s| (item, s))
            })
            .collect();

@@ -384,11 +411,22 @@ impl ProviderManager {

        // Empty query (after checking special providers) - return frecency-sorted items
        if query.is_empty() {
-            let items: Vec<(LaunchItem, i64)> = self
+            // Collect items from core providers
+            let core_items = self
                .providers
                .iter()
                .filter(|p| filter.is_active(p.provider_type()))
-                .flat_map(|p| p.items().iter().cloned())
+                .flat_map(|p| p.items().iter().cloned());
+
+            // Collect items from static native providers
+            let native_items = self
+                .static_native_providers
+                .iter()
+                .filter(|p| filter.is_active(p.provider_type()))
+                .flat_map(|p| p.items().iter().cloned());
+
+            let items: Vec<(LaunchItem, i64)> = core_items
+                .chain(native_items)
                .filter(|item| {
                    // Apply tag filter if present
                    if let Some(tag) = tag_filter {
@@ -412,53 +450,70 @@ impl ProviderManager {
        }

        // Regular search with frecency boost and tag matching
-        let search_results: Vec<(LaunchItem, i64)> = self
-            .providers
-            .iter()
-            .filter(|provider| filter.is_active(provider.provider_type()))
-            .flat_map(|provider| {
-                provider.items().iter().filter_map(|item| {
-                    // Apply tag filter if present
-                    if let Some(tag) = tag_filter
-                        && !item.tags.iter().any(|t| t.to_lowercase().contains(tag)) {
-                            return None;
-                        }
+        // Helper closure for scoring items
+        let score_item = |item: &LaunchItem| -> Option<(LaunchItem, i64)> {
+            // Apply tag filter if present
+            if let Some(tag) = tag_filter
+                && !item.tags.iter().any(|t| t.to_lowercase().contains(tag))
+            {
+                return None;
+            }

-                    let name_score = self.matcher.fuzzy_match(&item.name, query);
-                    let desc_score = item
-                        .description
-                        .as_ref()
-                        .and_then(|d| self.matcher.fuzzy_match(d, query));
+            let name_score = self.matcher.fuzzy_match(&item.name, query);
+            let desc_score = item
+                .description
+                .as_ref()
+                .and_then(|d| self.matcher.fuzzy_match(d, query));

-                    // Also match against tags (lower weight)
-                    let tag_score = item
-                        .tags
-                        .iter()
-                        .filter_map(|t| self.matcher.fuzzy_match(t, query))
-                        .max()
-                        .map(|s| s / 3); // Lower weight for tag matches
+            // Also match against tags (lower weight)
+            let tag_score = item
+                .tags
+                .iter()
+                .filter_map(|t| self.matcher.fuzzy_match(t, query))
+                .max()
+                .map(|s| s / 3); // Lower weight for tag matches

-                    let base_score = match (name_score, desc_score, tag_score) {
-                        (Some(n), Some(d), Some(t)) => Some(n.max(d).max(t)),
-                        (Some(n), Some(d), None) => Some(n.max(d)),
-                        (Some(n), None, Some(t)) => Some(n.max(t)),
-                        (Some(n), None, None) => Some(n),
-                        (None, Some(d), Some(t)) => Some((d / 2).max(t)),
-                        (None, Some(d), None) => Some(d / 2),
-                        (None, None, Some(t)) => Some(t),
-                        (None, None, None) => None,
-                    };
+            let base_score = match (name_score, desc_score, tag_score) {
+                (Some(n), Some(d), Some(t)) => Some(n.max(d).max(t)),
+                (Some(n), Some(d), None) => Some(n.max(d)),
+                (Some(n), None, Some(t)) => Some(n.max(t)),
+                (Some(n), None, None) => Some(n),
+                (None, Some(d), Some(t)) => Some((d / 2).max(t)),
+                (None, Some(d), None) => Some(d / 2),
+                (None, None, Some(t)) => Some(t),
+                (None, None, None) => None,
+            };

-                    base_score.map(|s| {
-                        let frecency_score = frecency.get_score(&item.id);
-                        let frecency_boost = (frecency_score * frecency_weight * 10.0) as i64;
-                        (item.clone(), s + frecency_boost)
-                    })
-                })
+            base_score.map(|s| {
+                let frecency_score = frecency.get_score(&item.id);
+                let frecency_boost = (frecency_score * frecency_weight * 10.0) as i64;
+                (item.clone(), s + frecency_boost)
            })
-            .collect();
+        };

-        results.extend(search_results);
+        // Search core providers
+        for provider in &self.providers {
+            if !filter.is_active(provider.provider_type()) {
+                continue;
+            }
+            for item in provider.items() {
+                if let Some(scored) = score_item(item) {
+                    results.push(scored);
+                }
+            }
+        }
+
+        // Search static native providers
+        for provider in &self.static_native_providers {
+            if !filter.is_active(provider.provider_type()) {
+                continue;
+            }
+            for item in provider.items() {
+                if let Some(scored) = score_item(item) {
+                    results.push(scored);
+                }
+            }
+        }
        results.sort_by(|a, b| b.1.cmp(&a.1));
        results.truncate(max_results);

@@ -479,7 +534,11 @@ impl ProviderManager {
    /// Get all available provider types (for UI tabs)
    #[allow(dead_code)]
    pub fn available_providers(&self) -> Vec<ProviderType> {
-        self.providers.iter().map(|p| p.provider_type()).collect()
+        self.providers
+            .iter()
+            .map(|p| p.provider_type())
+            .chain(self.static_native_providers.iter().map(|p| p.provider_type()))
+            .collect()
    }

    /// Get a widget item by type_id (e.g., "pomodoro", "weather", "media")
@@ -519,6 +578,16 @@ impl ProviderManager {
            plugin_id, submenu_query
        );

+        // Search in static native providers (clipboard, emoji, ssh, systemd, etc.)
+        for provider in &self.static_native_providers {
+            if provider.type_id() == plugin_id {
+                let actions = provider.query(&submenu_query);
+                if !actions.is_empty() {
+                    return Some((display_name.to_string(), actions));
+                }
+            }
+        }
+
        // Search in dynamic providers
        for provider in &self.dynamic_providers {
            if provider.type_id() == plugin_id {
@@ -539,23 +608,6 @@ impl ProviderManager {
            }
        }

-        // Search in static providers (boxed)
-        // Note: Static providers don't typically have submenu support,
-        // but we check for completeness
-        for provider in &self.providers {
-            if let ProviderType::Plugin(type_id) = provider.provider_type()
-                && type_id == plugin_id
-            {
-                // Static providers use the items() method, not query
-                // Submenu support requires dynamic query capability
-                #[cfg(feature = "dev-logging")]
-                debug!(
-                    "[Submenu] Plugin '{}' is static, cannot query for submenu",
-                    plugin_id
-                );
-            }
-        }
-
        #[cfg(feature = "dev-logging")]
        debug!("[Submenu] No submenu actions found for plugin '{}'", plugin_id);

--- a/crates/owlry/src/ui/main_window.rs
+++ b/crates/owlry/src/ui/main_window.rs
@@ -47,6 +47,8 @@ struct LazyLoadState {
 /// Number of items to display initially and per batch
 const INITIAL_RESULTS: usize = 15;
 const LOAD_MORE_BATCH: usize = 10;
+/// Debounce delay for search input (milliseconds)
+const SEARCH_DEBOUNCE_MS: u64 = 50;

 pub struct MainWindow {
    window: ApplicationWindow,
@@ -69,6 +71,8 @@ pub struct MainWindow {
    custom_prompt: Option<String>,
    /// Lazy loading state
    lazy_state: Rc<RefCell<LazyLoadState>>,
+    /// Debounce source ID for cancelling pending searches
+    debounce_source: Rc<RefCell<Option<gtk4::glib::SourceId>>>,
 }

 impl MainWindow {
@@ -210,6 +214,7 @@ impl MainWindow {
            tab_order,
            custom_prompt,
            lazy_state,
+            debounce_source: Rc::new(RefCell::new(None)),
        };

        main_window.setup_signals();
@@ -554,7 +559,7 @@ impl MainWindow {
    }

    fn setup_signals(&self) {
-        // Search input handling with prefix detection
+        // Search input handling with prefix detection and debouncing
        let providers = self.providers.clone();
        let results_list = self.results_list.clone();
        let config = self.config.clone();
@@ -565,11 +570,12 @@ impl MainWindow {
        let search_entry_for_change = self.search_entry.clone();
        let submenu_state = self.submenu_state.clone();
        let lazy_state = self.lazy_state.clone();
+        let debounce_source = self.debounce_source.clone();

        self.search_entry.connect_changed(move |entry| {
            let raw_query = entry.text();

-            // If in submenu, filter the submenu items
+            // If in submenu, filter immediately (no debounce needed for small local lists)
            if submenu_state.borrow().active {
                let state = submenu_state.borrow();
                let query = raw_query.to_lowercase();
@@ -607,7 +613,7 @@ impl MainWindow {
                return;
            }

-            // Normal mode: parse prefix and search
+            // Normal mode: update prefix/UI immediately for responsiveness
            let parsed = ProviderFilter::parse_query(&raw_query);

            {
@@ -643,53 +649,79 @@ impl MainWindow {
                    .set_placeholder_text(Some(&format!("Search {}...", prefix_name)));
            }

-            let cfg = config.borrow();
-            let max_results = cfg.general.max_results;
-            let frecency_weight = cfg.providers.frecency_weight;
-            let use_frecency = cfg.providers.frecency;
-            drop(cfg);
-
-            let results: Vec<LaunchItem> = if use_frecency {
-                providers
-                    .borrow_mut()
-                    .search_with_frecency(&parsed.query, max_results, &filter.borrow(), &frecency.borrow(), frecency_weight, parsed.tag_filter.as_deref())
-                    .into_iter()
-                    .map(|(item, _)| item)
-                    .collect()
-            } else {
-                providers
-                    .borrow()
-                    .search_filtered(&parsed.query, max_results, &filter.borrow())
-                    .into_iter()
-                    .map(|(item, _)| item)
-                    .collect()
-            };
-
-            // Clear existing results
-            while let Some(child) = results_list.first_child() {
-                results_list.remove(&child);
+            // Cancel any pending debounced search
+            if let Some(source_id) = debounce_source.borrow_mut().take() {
+                source_id.remove();
            }

-            // Lazy loading: store all results but only display initial batch
-            let initial_count = INITIAL_RESULTS.min(results.len());
-            {
-                let mut lazy = lazy_state.borrow_mut();
-                lazy.all_results = results.clone();
-                lazy.displayed_count = initial_count;
-            }
+            // Clone references for the debounced closure
+            let providers = providers.clone();
+            let results_list = results_list.clone();
+            let config = config.clone();
+            let frecency = frecency.clone();
+            let current_results = current_results.clone();
+            let filter = filter.clone();
+            let lazy_state = lazy_state.clone();
+            let debounce_source_for_closure = debounce_source.clone();

-            // Display only initial batch
-            for item in results.iter().take(initial_count) {
-                let row = ResultRow::new(item);
-                results_list.append(&row);
-            }
+            // Schedule debounced search
+            let source_id = gtk4::glib::timeout_add_local_once(
+                std::time::Duration::from_millis(SEARCH_DEBOUNCE_MS),
+                move || {
+                    // Clear the source ID since we're now executing
+                    *debounce_source_for_closure.borrow_mut() = None;

-            if let Some(first_row) = results_list.row_at_index(0) {
-                results_list.select_row(Some(&first_row));
-            }
+                    let cfg = config.borrow();
+                    let max_results = cfg.general.max_results;
+                    let frecency_weight = cfg.providers.frecency_weight;
+                    let use_frecency = cfg.providers.frecency;
+                    drop(cfg);

-            // current_results holds only what's displayed (for selection/activation)
-            *current_results.borrow_mut() = results.into_iter().take(initial_count).collect();
+                    let results: Vec<LaunchItem> = if use_frecency {
+                        providers
+                            .borrow_mut()
+                            .search_with_frecency(&parsed.query, max_results, &filter.borrow(), &frecency.borrow(), frecency_weight, parsed.tag_filter.as_deref())
+                            .into_iter()
+                            .map(|(item, _)| item)
+                            .collect()
+                    } else {
+                        providers
+                            .borrow()
+                            .search_filtered(&parsed.query, max_results, &filter.borrow())
+                            .into_iter()
+                            .map(|(item, _)| item)
+                            .collect()
+                    };
+
+                    // Clear existing results
+                    while let Some(child) = results_list.first_child() {
+                        results_list.remove(&child);
+                    }
+
+                    // Lazy loading: store all results but only display initial batch
+                    let initial_count = INITIAL_RESULTS.min(results.len());
+                    {
+                        let mut lazy = lazy_state.borrow_mut();
+                        lazy.all_results = results.clone();
+                        lazy.displayed_count = initial_count;
+                    }
+
+                    // Display only initial batch
+                    for item in results.iter().take(initial_count) {
+                        let row = ResultRow::new(item);
+                        results_list.append(&row);
+                    }
+
+                    if let Some(first_row) = results_list.row_at_index(0) {
+                        results_list.select_row(Some(&first_row));
+                    }
+
+                    // current_results holds only what's displayed (for selection/activation)
+                    *current_results.borrow_mut() = results.into_iter().take(initial_count).collect();
+                },
+            );
+
+            *debounce_source.borrow_mut() = Some(source_id);
        });

        // Entry activate signal (Enter key in search entry)
@@ -1238,6 +1270,12 @@ impl MainWindow {
    }

    fn launch_item(item: &LaunchItem, config: &Config, frecency: &Rc<RefCell<FrecencyStore>>) {
+        // dmenu mode: print selection to stdout instead of executing
+        if matches!(item.provider, ProviderType::Dmenu) {
+            println!("{}", item.name);
+            return;
+        }
+
        // Record this launch for frecency tracking
        if config.providers.frecency {
            frecency.borrow_mut().record_launch(&item.id);
@@ -1248,17 +1286,81 @@ impl MainWindow {
        info!("Launching: {} ({})", item.name, item.command);

        #[cfg(feature = "dev-logging")]
-        debug!("[UI] Launch details: terminal={}, provider={:?}", item.terminal, item.provider);
+        debug!("[UI] Launch details: terminal={}, provider={:?}, id={}", item.terminal, item.provider, item.id);

-        let cmd = if item.terminal {
-            let terminal = config.general.terminal_command.as_deref().unwrap_or("xterm");
-            format!("{} -e {}", terminal, item.command)
+        // Check if this is a desktop application (has .desktop file as ID)
+        let is_desktop_app = matches!(item.provider, ProviderType::Application)
+            && item.id.ends_with(".desktop");
+
+        // Desktop files should be launched via proper launchers that implement the
+        // freedesktop Desktop Entry spec (D-Bus activation, field codes, env vars, etc.)
+        // We delegate to: uwsm (if configured), gio launch, or gtk-launch as fallback.
+        //
+        // Non-desktop items (commands, plugins) use sh -c for shell execution.
+        let result = if is_desktop_app {
+            Self::launch_desktop_file(&item.id, config)
        } else {
-            item.command.clone()
+            Self::launch_command(&item.command, item.terminal, config)
        };

-        // Detect if this is a shell command vs an application launch
-        // Shell commands: playerctl, dbus-send, systemctl, journalctl, or anything with shell operators
+        if let Err(e) = result {
+            let msg = format!("Failed to launch '{}': {}", item.name, e);
+            log::error!("{}", msg);
+            crate::notify::notify("Launch failed", &msg);
+        }
+    }
+
+    /// Launch a .desktop file using gio (GLib's desktop entry launcher).
+    ///
+    /// gio is always available as it's part of glib2, which is a hard dependency
+    /// of GTK4. It handles D-Bus activation, field codes, Terminal flag, etc.
+    /// per the freedesktop Desktop Entry specification.
+    ///
+    /// Optionally wraps with a session manager (uwsm, hyprctl) for proper
+    /// process tracking in Wayland compositors.
+    fn launch_desktop_file(desktop_path: &str, config: &Config) -> std::io::Result<std::process::Child> {
+        use std::path::Path;
+
+        // Check if desktop file exists
+        if !Path::new(desktop_path).exists() {
+            let msg = format!("Desktop file not found: {}", desktop_path);
+            log::error!("{}", msg);
+            crate::notify::notify("Launch failed", &msg);
+            return Err(std::io::Error::new(std::io::ErrorKind::NotFound, msg));
+        }
+
+        match &config.general.launch_wrapper {
+            // With wrapper: wrapper manages the process, gio handles the .desktop file
+            Some(wrapper) if !wrapper.is_empty() => {
+                info!("Launching via {} + gio launch: {}", wrapper, desktop_path);
+                let mut parts: Vec<&str> = wrapper.split_whitespace().collect();
+                let cmd = parts.remove(0);
+                Command::new(cmd)
+                    .args(&parts)
+                    .args(["gio", "launch"])
+                    .arg(desktop_path)
+                    .spawn()
+            }
+            // No wrapper: use gio directly
+            _ => {
+                info!("Launching via gio launch: {}", desktop_path);
+                Command::new("gio")
+                    .args(["launch", desktop_path])
+                    .spawn()
+            }
+        }
+    }
+
+    /// Launch a shell command (for non-desktop items like PATH commands, plugins, etc.)
+    fn launch_command(command: &str, terminal: bool, config: &Config) -> std::io::Result<std::process::Child> {
+        let cmd = if terminal {
+            let terminal_cmd = config.general.terminal_command.as_deref().unwrap_or("xterm");
+            format!("{} -e {}", terminal_cmd, command)
+        } else {
+            command.to_string()
+        };
+
+        // Detect shell commands that shouldn't use a wrapper
        let is_shell_command = cmd.starts_with("playerctl ")
            || cmd.starts_with("dbus-send ")
            || cmd.starts_with("systemctl ")
@@ -1269,28 +1371,19 @@ impl MainWindow {
            || cmd.contains(" > ")
            || cmd.contains(" < ");

-        // Use launch wrapper if configured (uwsm, hyprctl, etc.)
-        // But skip wrapper for shell commands - they need sh -c
-        let result = match &config.general.launch_wrapper {
+        match &config.general.launch_wrapper {
            Some(wrapper) if !wrapper.is_empty() && !is_shell_command => {
-                info!("Using launch wrapper: {}", wrapper);
-                // Split wrapper into command and args (e.g., "uwsm app --" -> ["uwsm", "app", "--"])
-                let mut wrapper_parts: Vec<&str> = wrapper.split_whitespace().collect();
-                if wrapper_parts.is_empty() {
-                    Command::new("sh").arg("-c").arg(&cmd).spawn()
-                } else {
-                    let wrapper_cmd = wrapper_parts.remove(0);
-                    Command::new(wrapper_cmd)
-                        .args(&wrapper_parts)
-                        .arg(&cmd)
-                        .spawn()
-                }
+                info!("Launching command via {}: {}", wrapper, cmd);
+                let mut parts: Vec<&str> = wrapper.split_whitespace().collect();
+                let wrapper_cmd = parts.remove(0);
+                Command::new(wrapper_cmd)
+                    .args(&parts)
+                    .args(["sh", "-c", &cmd])
+                    .spawn()
+            }
+            _ => {
+                Command::new("sh").arg("-c").arg(&cmd).spawn()
            }
-            _ => Command::new("sh").arg("-c").arg(&cmd).spawn(),
-        };
-
-        if let Err(e) = result {
-            log::error!("Failed to launch '{}': {}", item.name, e);
        }
    }
 }
--- a/docs/PLUGINS.md
+++ b/docs/PLUGINS.md
@@ -143,9 +143,10 @@ chmod +x ~/.local/share/owlry/scripts/backup.sh
 **Prefix:** `:bm`
 **Package:** `owlry-plugin-bookmarks`

-Browser bookmarks from Chromium-based browsers.
+Browser bookmarks from Firefox and Chromium-based browsers.

 **Supported browsers:**
+- Firefox (reads places.sqlite)
 - Google Chrome
 - Brave
 - Microsoft Edge
@@ -236,13 +237,7 @@ Current weather displayed at the top of results.
 - OpenWeatherMap (requires API key)
 - Open-Meteo (no API key required)

-**Configuration:**
-```toml
-[plugins.weather]
-provider = "wttr.in"  # or: openweathermap, open-meteo
-location = "London"   # city name or "lat,lon" (empty for auto-detect)
-# api_key = "..."     # Required for OpenWeatherMap
-```
+**Note:** Weather configuration is currently embedded in the plugin. Future versions will support runtime configuration.

 **Features:**
 - Temperature, condition, humidity, wind speed
@@ -274,13 +269,6 @@ MPRIS media player controls.

 Pomodoro timer with work/break cycles.

-**Configuration:**
-```toml
-[plugins.pomodoro]
-work_mins = 25    # Work session duration (default: 25)
-break_mins = 5    # Break duration (default: 5)
-```
-
 **Features:**
 - Configurable work session duration
 - Configurable break duration
@@ -301,17 +289,17 @@ For convenience, plugins are available in bundle meta-packages:

 | Bundle | Plugins |
 |--------|---------|
-| `owlry-essentials` | calculator, system, ssh, scripts, bookmarks |
-| `owlry-widgets` | weather, media, pomodoro |
-| `owlry-tools` | clipboard, emoji, websearch, filesearch, systemd |
-| `owlry-full` | All of the above |
+| `owlry-meta-essentials` | calculator, system, ssh, scripts, bookmarks |
+| `owlry-meta-widgets` | weather, media, pomodoro |
+| `owlry-meta-tools` | clipboard, emoji, websearch, filesearch, systemd |
+| `owlry-meta-full` | All of the above |

 ```bash
 # Install everything
-yay -S owlry-full
+yay -S owlry-meta-full

 # Or pick a bundle
-yay -S owlry-essentials owlry-widgets
+yay -S owlry-meta-essentials owlry-meta-widgets
 ```

 ---
--- a/docs/PLUGIN_DEVELOPMENT.md
+++ b/docs/PLUGIN_DEVELOPMENT.md
@@ -23,7 +23,7 @@ Edit `Cargo.toml`:
 [package]
 name = "owlry-plugin-myplugin"
 version = "0.1.0"
-edition = "2024"
+edition = "2021"

 [lib]
 crate-type = ["cdylib"]
@@ -38,7 +38,7 @@ Edit `src/lib.rs`:
 use abi_stable::std_types::{ROption, RStr, RString, RVec};
 use owlry_plugin_api::{
    owlry_plugin, PluginInfo, PluginItem, ProviderHandle, ProviderInfo,
-    ProviderKind, API_VERSION,
+    ProviderKind, ProviderPosition, API_VERSION,
 };

 extern "C" fn plugin_info() -> PluginInfo {
@@ -59,6 +59,8 @@ extern "C" fn plugin_providers() -> RVec<ProviderInfo> {
        icon: RString::from("application-x-executable"),
        provider_type: ProviderKind::Static,
        type_id: RString::from("myplugin"),
+        position: ProviderPosition::Normal,
+        priority: 0,  // Use frecency-based ordering
    }].into()
 }

@@ -198,12 +200,19 @@ pub struct ProviderInfo {
    pub icon: RString,                  // Default icon name
    pub provider_type: ProviderKind,    // Static or Dynamic
    pub type_id: RString,               // Short ID for badges
+    pub position: ProviderPosition,     // Normal or Widget
+    pub priority: i32,                  // Result ordering (higher = first)
 }

 pub enum ProviderKind {
    Static,   // Items loaded at startup via refresh()
    Dynamic,  // Items computed per-query via query()
 }
+
+pub enum ProviderPosition {
+    Normal,  // Standard results (sorted by score/frecency)
+    Widget,  // Displayed at top when query is empty
+}
 ```

 ### PluginItem
--- a/17
+++ b/17
@@ -179,11 +179,18 @@ bump-meta new_version:
    done
    echo "Meta-packages bumped to {{new_version}}"

-# Bump all non-core crates (plugins + runtimes) to same version
+# Bump all crates (core + plugins + runtimes) to same version
 bump-all new_version:
    #!/usr/bin/env bash
    set -euo pipefail
-    # Bump plugins
+    # Bump core
+    toml="crates/owlry/Cargo.toml"
+    old=$(grep '^version' "$toml" | head -1 | sed 's/.*"\(.*\)"/\1/')
+    if [ "$old" != "{{new_version}}" ]; then
+        echo "Bumping owlry from $old to {{new_version}}"
+        sed -i 's/^version = ".*"/version = "{{new_version}}"/' "$toml"
+    fi
+    # Bump plugins (including plugin-api)
    for toml in crates/owlry-plugin-*/Cargo.toml; do
        crate=$(basename $(dirname "$toml"))
        old=$(grep '^version' "$toml" | head -1 | sed 's/.*"\(.*\)"/\1/')
@@ -204,9 +211,9 @@ bump-all new_version:
        fi
    done
    cargo check --workspace
-    git add crates/owlry-plugin-*/Cargo.toml crates/owlry-lua/Cargo.toml crates/owlry-rune/Cargo.toml Cargo.lock
-    git commit -m "chore: bump all plugins and runtimes to {{new_version}}"
-    echo "All plugins and runtimes bumped to {{new_version}}"
+    git add crates/*/Cargo.toml Cargo.lock
+    git commit -m "chore: bump all crates to {{new_version}}"
+    echo "All crates bumped to {{new_version}}"

 # Bump core version (usage: just bump 0.2.0)
 bump new_version:
Author	SHA1	Message	Date
vikingowl	1aa92ee1e5	chore(owlry-rune): bump version to 0.4.9	2026-01-02 16:18:19 +01:00
vikingowl	9532b3cfde	chore(owlry-lua): bump version to 0.4.9	2026-01-02 16:18:18 +01:00
vikingowl	551e5d74ae	chore(plugins): bump all plugins to 0.4.9	2026-01-02 16:18:18 +01:00
vikingowl	60eaffb2ab	chore: bump version to 0.4.9	2026-01-02 16:18:08 +01:00
vikingowl	6d8d4a9f89	fix(providers): improve app discovery and launch reliability - Add Keywords field from desktop files to searchable tags (fixes apps like Nautilus not found when searching by legacy name) - Respect XDG_DATA_DIRS with proper fallbacks for app directories - Add Flatpak, Snap, and Nix application directory support - Simplify desktop file launch to use gio directly (guaranteed by GTK4) - Add desktop notifications for launch failures - Check desktop file existence before launch attempt	2026-01-02 16:18:00 +01:00
vikingowl	3ef9398655	chore: bump all crates to 0.4.8	2026-01-01 23:30:45 +01:00
vikingowl	46bb4bfb38	chore: bump version to 0.4.8	2026-01-01 23:28:09 +01:00
vikingowl	c8aed5faf5	fix(dmenu): print selection to stdout instead of executing dmenu mode was incorrectly trying to execute the selected item as a command (via hyprctl/sh). Now it properly prints the selection to stdout, enabling standard dmenu piping workflows like: git branch \| owlry -m dmenu \| xargs git checkout	2026-01-01 23:28:03 +01:00
vikingowl	bf8a31af78	chore: bump all crates to 0.4.7	2026-01-01 22:29:00 +01:00
vikingowl	e23bdf5cee	fix(providers): enable submenu support for static native plugins Static native plugins (systemd, clipboard, etc.) were being boxed as Box<dyn Provider>, which lost access to the query() method needed for submenu support. The Provider trait only has refresh() and items(). Add static_native_providers field to keep static native plugins as NativeProvider instances, preserving their query() method. Update all search methods and query_submenu_actions() to include this new list. Fixes systemd plugin submenu not showing actions when selecting a service.	2026-01-01 22:14:43 +01:00
vikingowl	25c4d40d36	docs: add comprehensive usage documentation - Expand CLI --help with examples, dmenu mode, and search prefixes - Add dmenu mode section to README with practical examples - Add plugin management CLI reference to README - Update argument descriptions with all valid modes listed	2026-01-01 21:45:52 +01:00
vikingowl	b36dd2a438	chore: update bump-all to include core in single commit	2025-12-30 20:32:28 +01:00
vikingowl	35a0f580c3	chore(owlry-rune): bump version to 0.4.6	2025-12-30 20:23:58 +01:00
vikingowl	7ed36c58c2	chore(owlry-lua): bump version to 0.4.6	2025-12-30 20:23:57 +01:00
vikingowl	7cccd3b512	chore(plugins): bump all plugins to 0.4.6	2025-12-30 20:23:48 +01:00
vikingowl	9f6d0c5935	chore: bump version to 0.4.6	2025-12-30 20:23:38 +01:00
vikingowl	026a232e0c	docs: add ROADMAP.md with feature ideas - High value/low effort: hot-reload, frecency pruning, :recent, clipboard images - Medium effort: universal actions, plugin settings UI, result capture - Bigger bets: window switcher, cross-device sync, natural language, plugin marketplace - Technical debt: meval→evalexpr, API compat, per-plugin config 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2025-12-30 09:04:55 +01:00
vikingowl	1557119448	docs: comprehensive documentation update README.md: - Fix bundle package names (add meta- prefix) - Add Firefox support to bookmarks plugin description - Add system paths table (plugins, runtimes, example config) - Add Quick Start section for copying example config - Expand config example with providers section docs/PLUGINS.md: - Add Firefox support to bookmarks - Fix bundle package names - Remove outdated [plugins.weather] and [plugins.pomodoro] config examples docs/PLUGIN_DEVELOPMENT.md: - Fix Rust edition from 2024 to 2021 - Add position and priority fields to ProviderInfo - Add ProviderPosition enum documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2025-12-30 08:49:30 +01:00