HyprViz

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

Installation

Arch Linux

There are 2 different AUR packages available:

• hyprviz - Latest release built from source
• hyprviz-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>

NixOS

This project is packaged as a Nix flake. Make sure you have flakes enabled in Nix.

You can run hyprviz directly with:

nix run github:timasoft/hyprviz

If you want to have hyprviz always available in your $PATH:

nix profile install github:timasoft/hyprviz

If you manage your NixOS configuration with flakes, add hyprviz as an input in your flake.nix:

{
  inputs.hyprviz.url = "github:timasoft/hyprviz";

  outputs = { self, nixpkgs, hyprviz, ... }:
    {
      nixosConfigurations.my-hostname = nixpkgs.lib.nixosSystem {
        system = "x86_64-linux";
        modules = [
          ./configuration.nix
          {
            environment.systemPackages = [
              hyprviz.packages.x86_64-linux.default
            ];
          }
        ];
      };
    };
}

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/timasoft/hyprviz.git && cd hyprviz
4. Compile the app with cargo build --release or run it directly with cargo run --release

TODO:

• Improve value parser
• Improve colour options
• Create aur repo
• Add default values
• Add support for sourced files
• Add ability to create and switch between custom profiles
• Add system info section
• Add bind section
• Add windowrule section
• Add other config sections from Hyprland
• Add support for waybar, swaync, hyprlock...
• Improve GUI

Credits:

• Nyx - Implementing the parser, rest of the main GUI, and maintaining the hyprgui project
• Adam - Implementing the base GUI, maintaining the AUR packages and the project alongside Nyx
• Vaxry - Hyprland
• rust-gtk - The GTK4 library
• Hyprland - The window manager