omni-launcher

A Wayland application launcher overlay built on Quickshell. Beyond app search it supports inline calculator, unit/currency conversion, unicode lookup and Giphy search — each picked by a single-character prefix.

Features

query — fuzzy app search across .desktop entries
= expr — calculator + unit conversion (length, mass, volume, time, temperature, area, energy, data, …)
= 100 usd to eur — live currency conversion via Frankfurter
. name — unicode search by character name (e.g. . heart)
! query — animated GIF search via Giphy (requires API key)
Theme follows xdg-desktop-portal appearance (dark/light + accent) and Qt's platform palette/font.
Optional Hyprland integration: close on workspace switch and focus-grab dismissal.

Install

From the AUR:

yay -S omni-launcher

Or build from a clone:

makepkg -si

Usage

Start the daemon once per session (e.g. in ~/.config/hypr/hyprland.conf):

exec-once = omni-launcher

Bind a key to toggle the overlay:

bind = SUPER, SPACE, exec, omni-launcher-toggle

omni-launcher-toggle calls the running instance over Quickshell IPC. The launcher closes on Esc, click-outside, or workspace switch (Hyprland).

Configuration

~/.config/omni-launcher/config.json — any missing key falls back to a built-in default, so the file can be omitted entirely:

{
  "fontFamily": "JetBrainsMono Nerd Font Propo",
  "fontSize": 16,
  "giphyApiKey": "",
  "panelWidth": 720,
  "panelHeight": 520,
  "padding": 5,
  "spacing": 5,
  "radius": 10,
  "colors": {
    "background": "#101010",
    "foreground": "#e6e6e6",
    "idle": "#a0a0a0",
    "accent": "#5e9eff",
    "overlayStrong": "#2b5f96",
    "overlayWeak": "#202020",
    "border": "#3a3a3a"
  }
}

Changes take effect on restart (omni-launcher).

Theming

The launcher reads org.freedesktop.appearance from xdg-desktop-portal for color-scheme and accent, and falls back to Qt's SystemPalette (qt6ct / KDE / qgnomeplatform) for everything else. Values under colors are optional overrides for users or theme managers that want a fixed palette.

Dependencies

quickshell, wl-clipboard, curl, python, glib2
Optional: hyprland for workspace-switch dismissal and focus grab

License

GPL-3.0-or-later. See LICENSE.

2.4 KiB Raw Blame History