Hyprfindr

Hyprfindr is a small Python utility that lets you search and display your Hyprland keybinds via the terminal or as desktop notifications. It parses your ~/.config/hypr/hyprland.conf, resolves $variables, and formats the keybinds for quick lookup.

---

🚀 Getting Started

📦 Install via AUR

Hyprfindr is available on the Arch User Repository (AUR). If you’re using an AUR helper like yay or paru:

yay -S hyprfindr

This will fetch the PKGBUILD, build the package, and install it for you.

---

🛠 Build from source (custom install)

If you want to build manually or use the latest Git version:

1. Clone the repository

git clone https://github.com/fwtwoo/hyprfindr.git
cd hyprfindr

2. Install dependencies

sudo pacman -S python zenity

3. Run directly

python hyprfindr.py firefox

4. (Optional) Install to /usr/local/bin for global access:

sudo install -Dm755 hyprfindr.py /usr/local/bin/hyprfindr

---

⚙️ Usage

usage: hyprfindr [-h] [--version] NAME

Search and display Hyprland keybinds via CLI and your notification daemon.

positional arguments:
  NAME        Search keybinds by application/command name, or by a key within a key combination.

options:
  -h, --help  show this help message and exit
  --version   show program's version number and exit

---

✅ Requirements

• Python 3
• zenity (for desktop notifications)
• Hyprland (for keybinds)

---

📄 License

Licensed under the MIT License. See LICENSE for details.

---