DEV Community

Cover image for hyprKCS - Hyprland keybind manager
Kosa Matyas
Kosa Matyas

Posted on

hyprKCS - Hyprland keybind manager

Ever forget your own keybinds? Tired of grepping through 5 different config files just to change a workspace shortcut?

Meet hyprKCS - a native, fast GUI written in Rust & GTK4. It parses your config (and recursively sourced files!) to give you a searchable, interactive dashboard for your system.

Key Features

  • Fuzzy Search: Find actions instantly (e.g., type "resize" or "volume").
  • Add, Edit & Delete: Full CRUD support for your keybinds directly from the UI.
  • Key Recorder: Don't type out SUPER + SHIFT + Q. Just click "Record" and press the keys.
  • Deep Parsing: Reads source = ... directives recursively across your entire setup.
  • Native UI: Built with Libadwaita to match your system theme (Dark/Light mode) seamlessly.
  • Direct Control: Execute and test binds directly from the UI via hyprctl.
  • Conflict Wizard: Automatically detects duplicate binds and walks you through resolving them interactively. No more hunting for that one duplicate SUPER + Q.
  • Massive Optimization: Refactored the parser logic and switched to the jemalloc allocator. It's now lighter and faster than ever.
  • Smart Backups: One-click backup that recursively saves your main config and all sourced files into a timestamped directory.

Installation

Arch Linux (AUR):

yay -S hyprkcs-git
Enter fullscreen mode Exit fullscreen mode

Nix:

nix run github:kosa12/hyprKCS
Enter fullscreen mode Exit fullscreen mode

Technical Highlights:

  • Recursive Parser: Custom Regex-based parser that handles variable resolution ($mainMod) and recursive file sourcing.
  • Memory Optimization: Recently switched to tikv-jemallocator on Linux and optimized the parsing algorithm (removed O(n²) sorting), resulting in a negligible memory footprint (~20-30MB RSS in release mode).
  • Layer Shell: Uses gtk4-layer-shell to render as a proper overlay application that respects Hyprland's window rules.

GitHub: https://github.com/kosa12/hyprKCS

Top comments (0)