Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hyprutils/hyprgui
GUI for configuring Hyprland, written in blazingly fast Rust! 🚀🦀
https://github.com/hyprutils/hyprgui
configuration gui hyprland hyprutils rust wayland
Last synced: 3 days ago
JSON representation
GUI for configuring Hyprland, written in blazingly fast Rust! 🚀🦀
- Host: GitHub
- URL: https://github.com/hyprutils/hyprgui
- Owner: hyprutils
- License: gpl-2.0
- Created: 2024-10-10T22:56:30.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-05T06:10:20.000Z (8 days ago)
- Last Synced: 2024-12-10T10:41:09.025Z (3 days ago)
- Topics: configuration, gui, hyprland, hyprutils, rust, wayland
- Language: Rust
- Homepage:
- Size: 1.64 MB
- Stars: 443
- Watchers: 4
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-hyprland - hyprgui
README
HyprGUI 
[](https://github.com/The-Grindhouse/guidelines)
An unofficial GUI for configuring Hyprland, built with GTK4 and Rust. 🚀🦀
Comes with a custom [hyprparser](https://github.com/hyprutils/hyprparser) for Hyprland's configuration file. (Rust btw) 🦀
## Preview
## Installation
[](https://repology.org/project/hyprgui/versions)
### GitHub Releases
See HyprGUI's [releases page](https://github.com/hyprutils/hyprgui/releases) for downloadable binaries.
### Arch Linux
There are 2 different [AUR](https://aur.archlinux.org) packages available:
- [hyprgui](https://aur.archlinux.org/packages/hyprgui) - Latest release built from source
- [hyprgui-bin](https://aur.archlinux.org/packages/hyprgui-bin) - Latest release in binary form
Install the preferred package with:
```bash
git clone https://aur.archlinux.org/.git
cd
makepkg -si
```
Or, if you're using an [AUR Helper](https://wiki.archlinux.org/title/AUR_helpers), it's even simpler (using [paru](https://github.com/Morganamilo/paru) as an example):
```bash
paru -S
```
### 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`
```nix
environment.systemPackages = [
pkgs.hyprgui
];
```
#### nix-env
On NixOS:
```bash
nix-env -iA nixos.hyprgui
```
On Non NixOS:
```bash
# without flakes:
nix-env -iA nixpkgs.hyprgui
# with flakes:
nix profile install nixpkgs#hyprgui
```
#### nix-shell
```bash
nix-shell -p hyprgui
```
## Building from source
1. Install Rust (preferably `rustup`) through your distro's package or [the official script](https://www.rust-lang.org/tools/install)
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:
- [x] Implement GUI
- [x] Implement parser
- [x] Improve the readme
- [ ] Improve parser
- [ ] Improve GUI
## Credits:
- [Nyx](https://github.com/nnyyxxxx) - Implementing the parser, rest of the GUI, and maintaining the project
- [Adam](https://github.com/adamperkowski) - Implementing the base GUI, maintaining the AUR packages and the project
- [Vaxry](https://github.com/vaxerski) - Hyprland
- [rust-gtk](https://github.com/gtk-rs/gtk4-rs) - The GTK4 library
- [Hyprland](https://github.com/hyprwm/Hyprland) - The wayland compositor
Copyright (C) 2024 HyprUtils