README.md

hypr-binds

Keybinds helper for Hyprland.

Table of Contents

• How to use
• Nix support
  • Home Manager
• General support

How to use

The hypr-binds program is mainly customizable via Home Manager (see below), but a program with sane defaults both for Wofi and Rofi is provided out of the box for all Linux users.

Nix support

Try it out before buying:

nix run github:gvolpe/hypr-binds

Still here? Add it to your flake inputs:

{
  hypr-binds-flake = {
    url = github:gvolpe/hypr-binds;
    inputs.nixpkgs.follows = "nixpkgs";
  };
}

And add the package to your list of packages:

inherit (hypr-binds-flake.${system}) hypr-binds-wofi;

Home Manager

Or make use of the Home Manager module by first adding it to your imports:

imports = [
  hypr-binds-flake.homeManagerModules.${system}.default
];

And then enabling the program:

{
  programs.hypr-binds.enable = true;
}

It comes with defaults, but it's possible to customize it:

{
  programs.hypr-binds = {
    enable = true;
    settings = {
      launcher = {
        app = "wofi"; # or rofi
        style = {
          modkey = "<b>$MOD$KEY</b> <i>$DESCRIPTION</i>";
          command = "cyan";
        };
      };
      dispatch = true;
    };
  };
}

General support

The same script one can run via nix is also generally available for all non-nix users as simple bash scripts where the only hard dependencies are bash and jq, besides either Wofi or Rofi.

Users are welcome to download either script and modify it at will:

• Rofi: v0.0.1/hypr-binds-rofi.sh
• Wofi: v0.0.1/hypr-binds-wofi.sh