k-launcher

A lightweight, GPU-accelerated command palette for Linux (Wayland/X11). Zero Electron — every pixel rendered via WGPU. Async search that never blocks the UI.

Quick Start

git clone https://github.com/GKaszewski/k-launcher
cd k-launcher
cargo build --release
./target/release/k-launcher

Keybinds

Key	Action
Type	Filter results
`↑` / `↓`	Navigate
`Enter`	Launch selected
`Escape`	Close

Compositor Setup

k-launcher uses a normal window; configure your compositor to float it.

Hyprland (~/.config/hypr/hyprland.conf):

windowrule = float, ^(k-launcher)$
windowrule = center, ^(k-launcher)$
bind = SUPER, Space, exec, k-launcher

Sway (~/.config/sway/config):

for_window [app_id="k-launcher"] floating enable, move position center
bindsym Mod4+space exec k-launcher

Built-in Plugins

Trigger	Plugin	Example
(any text)	Apps	`firefox`
number/expression	Calc	`2^10 + 5`
`>` prefix	Shell	`> echo hello`
`/` or `~/`	Files	`~/Documents`

External Plugins

Drop in community plugins — any language, no recompilation. Plugins are executables that communicate over stdin/stdout JSON:

# ~/.config/k-launcher/config.toml
[[plugins.external]]
name = "my-plugin"
path = "/usr/lib/k-launcher/plugins/my-plugin"

See Plugin Development for the full protocol.

1.8 KiB Raw Blame History