Usage

hyprburst is a single binary with a tiny command surface. Run hyprburst help for the same summary.

Command	What it does
hyprburst	Opens the default Rio-backed launcher window. This is what the Super+Space Hyprland bind invokes.
hyprburst tui	Runs the launcher inline in the current terminal, with no window. The fallback for SSH / no-GPU sessions, and handy for testing from a shell.
hyprburst native	Opens the direct in-process launcher without a PTY. Kept as a fallback and comparison path.
hyprburst help (-h, --help)	Prints the usage summary and exits.
hyprburst --measure	Measures the default frontend to its first PTY-backed frame.
hyprburst native --measure	Measures the direct fallback to its first frame.
hyprburst --bench-startup	Times the cold startup path (config load + app init), prints peak RSS, and exits without opening the UI.

Inside the launcher

• Type to filter.
• Arrow keys (or PageUp/PageDown) to move.
• Enter launches the selected app; clicking an app launches it directly.
• Escape closes.

When opening an app from its .desktop file, hyprburst removes freedesktop placeholders such as %f, %F, %u and %U, so apps like Inkscape start normally instead of receiving a literal placeholder argument.

Performance

On a reference Arch + Hyprland machine, hyprburst --bench-startup reports:

hyprburst startup: ~4ms
hyprburst peak RSS: ~5 MB

History

Launch history is stored in SQLite and feeds the recency/frequency ranking:

launches (
  id INTEGER PRIMARY KEY,
  desktop_id TEXT NOT NULL UNIQUE,
  app_name TEXT NOT NULL,
  launch_count INTEGER NOT NULL DEFAULT 1,
  last_used TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
  first_used TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
)