hyprgui/README.md

HyprGUI

An unofficial GUI for configuring Hyprland, built with GTK4 and Rust. 🚀🦀
Comes with a custom hyprparser for Hyprland's configuration file. (Rust btw) 🦀

Preview

Installation

GitHub Releases

See HyprGUI's releases page for downloadable binaries.

Arch Linux

There are 2 different AUR packages available:

• hyprgui - Latest release built from source
• hyprgui-bin - Latest release in binary form

Install the preferred package with:

git clone https://aur.archlinux.org/<package>.git
cd <package>
makepkg -si

Or, if you're using an AUR Helper, it's even simpler (using paru as an example):

paru -S <package>

Nix

You can install HyprGUI with Nix in three ways:

NixOS Configuration

Add the following Nix code to your NixOS Configuration, usually located in /etc/nixos/configuration.nix

environment.systemPackages = [
  pkgs.hyprgui
];

nix-env

On NixOS:

nix-env -iA nixos.hyprgui

On Non NixOS:

# without flakes:
nix-env -iA nixpkgs.hyprgui
# with flakes:
nix profile install nixpkgs#hyprgui

nix-shell

nix-shell -p hyprgui

Building from source

1. Install Rust (preferably rustup) through your distro's package or the official script
2. Install git, pango and gtk4
3. Clone this repository: git clone https://github.com/hyprutils/hyprgui && cd hyprgui
4. Compile the app with cargo build --release or run it directly with cargo run --release

TODO:

• Implement GUI
• Implement parser
• Improve the readme
• Improve parser
• Improve GUI

Credits:

• Vaxry - Hyprland
• rust-gtk - The GTK4 library
• Hyprland - The wayland compositor

Copyright (C) 2026 HyprUtils