⌨️ Hyprkeys

A simple, fast and scriptable keybind inspection utility for Hyprland

[!WARNING] Hyprkeys has been deprecated as of June 2024. This has to do with the fact that it was unmaintained for a while now, and that I am no longer interested in maintaining the project. This repository will not go anywhere, however we will no longer be taking contributions as Hyprkeys' functionaity is now built into Hyprland! Thank you for your continued support.

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 {
      # ...

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

      # ...
    };
  };
}

Arch AUR Package

Arch User Repository package is maintained by bloominstrong

git clone https://aur.archlinux.org/hyprkeys.git
cd hyprkeys
# Get needed dependencies, make and install hyprkeys
makepkg -si

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

https://user-images.githubusercontent.com/86447830/211897915-778e9b24-061d-4d97-bc5e-444224610566.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.