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) 🦀

Note: Hyprland 0.52 is not supported yet.

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 in multiple ways for Nix:

From nixpkgs

HyprViz is available in nixpkgs unstable. Recommended installation methods:

For temporary usage:

nix run nixpkgs#hyprviz

For system-wide installation in your NixOS configuration:

{
  environment.systemPackages = with pkgs; [
    hyprviz
  ];
}

From GitHub flake

Alternatively, you can use the GitHub flake directly. 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
• Update preview
• Add dropdown_int and bool_int
• Add ability to create and switch between custom profiles
• Add system info section
• Add bind section
• Add windowrule section
• Add other top-level config sections from Hyprland
• Add guides to top-level sections
• Add guides to some other sections
• Add hyprviz to nixpkgs
• Add i18n
• Add curve editor
• Add symlink support
• 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