Skip to content

remigius-labs/hyprbindr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

HyprBindr

Visual keybinding manager for Omarchy. Bind applications to keyboard shortcuts like changing keybinds in a video game settings menu.

GTK4/Libadwaita Python Omarchy

HyprBindr

Features

  • All Apps tab: Shows every installed application with icons
  • Bound Apps tab: Shows only apps with custom keybinds
  • Search: Filter apps by name
  • Conflict detection: Warns if a keybind is already in use
  • System shortcut awareness: Knows about Omarchy's default bindings
  • Webapp support: Add webapps with custom icons

Installation

Requires Omarchy (Arch Linux + Hyprland).

git clone https://github.com/remigius-labs/hyprbindr.git
cd hyprbindr
chmod +x hyprbindr.py
ln -s $(pwd)/hyprbindr.py ~/.local/bin/hyprbindr

Dependencies

All included with Omarchy. If installing separately:

  • Python 3.10+
  • GTK4
  • libadwaita
  • PyGObject

Usage

  1. Launch HyprBindr from your app launcher or run hyprbindr
  2. Find an app in the "All Apps" tab
  3. Click the keybind button (shows "Click to bind" if not bound)
  4. Press your desired key combination (SUPER key required)
  5. Done! The keybind is saved to ~/.config/hypr/bindings.conf

How it works

Bindings are written to ~/.config/hypr/bindings.conf:

unbind = SUPER, T
bindd = SUPER, T, Telegram, exec, omarchy-launch-or-focus ^org.telegram.desktop$ uwsm-app -- Telegram

Key points:

  • Uses bindd (with description) so bindings show up in Omarchy's shortcut menu
  • Always unbind before bindd to prevent conflicts
  • Uses omarchy-launch-or-focus for proper window management
  • Never touches your existing Hyprland config

License

MIT

About

Visual keybinding manager for Omarchy (Hyprland)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages