Skip to content

A simple, scriptable keybind retrieval utility for Hyprland [maintainer=@NotAShelf]

License

Notifications You must be signed in to change notification settings

bloominstrong/Hyprkeys

 
 

Repository files navigation

⌨️ 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:

OrCEzxZ - Imgur

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.

About

A simple, scriptable keybind retrieval utility for Hyprland [maintainer=@NotAShelf]

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 85.1%
  • Nix 10.0%
  • Makefile 4.9%