CLI tool
HyDE-Project/HyDE avatar
HyDE-Project/HyDE

HyDE: A Heavily Customized Arch Linux Desktop That Demands a Clean Install

HyDE, your Development Environment. 🡅 HyDEVM is a script that allows you to run HyDE in a virtual machine for testing and development.

9,605 stars638 forksShellGPL-3.0

At a glance

What is it?
HyDE is a script-driven Arch Linux desktop environment built on Hyprland, aimed at users who want a polished, pre-configured setup. It is powerful but invasive, and the README is upfront about the risks.
Who is it for?
Adopt HyDE if you are running a minimal Arch Linux install, want a heavily customized Hyprland desktop without manual configuration, and are comfortable with the installer modifying GRUB, SDDM, and your shell. Do not use it if you rely on your current GTK/Qt theming, shell setup, or bootloader configuration, or if you are on a non-Arch distro without a restore point.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository received new commits within the last day.
What is it written in?
Mainly Shell, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 15, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What HyDE Actually Is

HyDE is not a Linux distribution. It is a collection of shell scripts and configuration files that turn a minimal Arch Linux installation into a fully themed desktop environment built on the Hyprland compositor. The project describes itself as "your Development Environment," but the README makes clear that the scope is much broader: it configures the window manager, GTK and Qt theming, the command-line shell, the SDDM display manager, and the GRUB bootloader. The intended user is someone who wants a polished, consistent desktop without spending days tweaking dotfiles. The README targets a minimal Arch install and warns that it may work on Arch-based distros, but the wording suggests that anything else is a gamble.

The Installation Script Is the Whole Product

The installation process is a single script, install.sh, located in the Scripts directory. The README gives three commands: install git and base-devel, clone the repository with a shallow depth, and run the script. The script does heavy lifting: it auto-detects an NVIDIA card and installs a matching DKMS driver, modifies your GRUB or systemd-boot config to enable NVIDIA DRM, and changes /etc/pacman.conf. The README lists these as expected changes, not optional ones. This is a design choice: the script is opinionated and invasive. For a user who wants a working desktop out of the box, that is convenient. For anyone who has customized their system, it is a warning sign. The README explicitly says that installing alongside another desktop environment will conflict with your existing theming, shell, SDDM, and GRUB, and that you proceed at your own risk.

NVIDIA Handling: The Most Detailed Part of the README

The README spends more space on NVIDIA than on any other hardware topic, which suggests that this is a common pain point. The install script auto-selects a DKMS driver path based on your card. Newer cards may use nvidia-dkms or nvidia-open-dkms, while legacy cards must be checked against a list in Scripts/nvidia-db/. The README warns that if a DKMS package is selected, the installer will build a local module for the current kernel, which can take several minutes, even if the package was already installed. It also warns that the script modifies your bootloader config to enable NVIDIA DRM. This is a concrete failure mode: if your card is older and not in the legacy list, the default driver selection could be wrong, and you could end up with a broken graphical session. The README tells you to verify the driver family before accepting the default, but the script does not appear to pause for confirmation.

Updating HyDE Means Losing Your Configs

The update process is as scripted as the install. You pull the latest changes with git fetch and reset hard to origin/master, then run install.sh -r. The README warns that this discards any uncommitted local changes in the repository. It also says that any configurations you made will be overwritten if they are listed in Scripts/restore_cfg.psv. The backup system is a directory, ~/.config/cfg_backups, where replaced configs are stored. This is a real limitation: HyDE is not a system that respects your local tweaks. If you customize your shell prompt or your GTK theme, an update can wipe it. The backup directory helps, but restoring individual files manually is tedious. For a project that calls itself a development environment, this is a surprising trade-off. Developers often want to version their dotfiles, and HyDE's update process fights that workflow.

A Real Alternative: Hydenix for NixOS

The README mentions a separate project called Hydenix, maintained at github.com/richen604/hydenix, which provides HyDE support for NixOS. This is a different approach: instead of a shell script that modifies system files in place, Hydenix presumably uses NixOS's declarative configuration model, where the entire system state is defined in a configuration file. The difference is fundamental. With HyDE, you run a script and accept whatever changes it makes. With Hydenix, you declare what you want and the system builds it. For users who value reproducibility and the ability to roll back changes, Hydenix is a safer choice. The README does not elaborate on Hydenix's features, but the existence of a separate project for NixOS indicates that HyDE's script-based approach is not portable to systems that do not use pacman and a traditional filesystem layout.

Licence and Maintenance Costs

HyDE is licensed under GPL-3.0, which means you can use, modify, and distribute it, but any derivative work must also be GPL-3.0. This is a standard copyleft licence, and it matters if you plan to fork the project or embed parts of it in a proprietary tool. The maintenance cost is visible in the release cadence: the repository shows releases in March, July, and August 2026, which suggests active development. The update process is straightforward but destructive, as described above. You need to be prepared to re-apply your own changes after every update, or rely on the backup directory. The README also mentions a Wiki, a Discord server, and a YouTube channel, which indicates a community support structure. For a project that modifies bootloaders and display managers, having a place to ask for help is not a luxury; it is a practical requirement.

Editorial conclusion

Adopt HyDE if you are running a minimal Arch Linux install, want a heavily customized Hyprland desktop without manual configuration, and are comfortable with the installer modifying GRUB, SDDM, and your shell. Do not use it if you rely on your current GTK/Qt theming, shell setup, or bootloader configuration, or if you are on a non-Arch distro without a restore point. Before running install.sh, verify your NVIDIA card against the legacy driver list in Scripts/nvidia-db/ and create a Timeshift snapshot if you are on BigLinux or Manjaro. The update process will overwrite your configs, so back up anything you cannot lose. HyDE is a trade-off: you get a complete desktop fast, but you surrender control over system files.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Community notes

Community notes