README.md

⌨️ Hyprkeys

A simple, fast and scriptable keybind inspection utility for Hyprland

Installation & Usage

From source

1. Download Go. You can obtain it from your distro's package manager. It is named "go" under most distros.
2. Clone this repository with git clone https://github.com/hyprland-community/hyprkeys
3. Install the application with make build then sudo make install
4. You can run the application with hyprkeys

Using the Nix Flake

# flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    hyprkeys = {
        url = "github:hyprland-community/hyprkeys";
        inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, hyprkeys }: let
  in {
    nixosConfigurations.yourHostName = nixpkgs.lib.nixosSystem {
      # ...

      system.packages = [ hyprkeys.packages.${system}.hyprkeys ];

      # ...
    };
  };
}

Installing Prebuild Binaries

Prebuilt binaries are distributed for each tagged release. You may find them under releases

Usage

See hyprkeys -v for a full list of commands and flags.

Project Demo

example.1.mp4

Rofi script using hyprctl:

Example Outputs (as of 11 JAN 2023)

MARKDOWN

JSON

RAW

Project Roadmap

See TODO.

License

This project is licensed under the GPLv3 License. See the LICENSE file for more details.

Contributing

Contributions, in form of Pull Requests and Issues are always welcome. If you wish to make changes, open a pull request and I will guide you through it.