explaingit

hyde-project/hyde

8,979ShellAudience · generalComplexity · 3/5Setup · hard

TLDR

A ready-to-install, visually polished Linux desktop setup built on Hyprland that gives you a beautiful Wayland workspace on Arch Linux without configuring everything from scratch.

Mindmap

mindmap
  root((HyDE))
    What it does
      Pre-configured desktop
      Theme switching
      Wayland compositor
    Visuals
      Multiple themes
      Dark and light mode
      Wallpaper color sync
    Setup
      Arch Linux only
      Shell script install
      NVIDIA auto-detection
    Community
      Discord support
      Documentation wiki
      NixOS port available
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Install a fully configured and visually polished Hyprland desktop on Arch Linux with a single shell script.

USE CASE 2

Switch between multiple visual themes and wallpapers that automatically adjust the entire desktop color scheme to match.

USE CASE 3

Set up NVIDIA driver support automatically as part of the HyDE desktop installation process.

Tech stack

ShellHyprlandWaylandArch Linux

Getting it running

Difficulty · hard Time to first run · 1h+

Designed for Arch Linux only, NVIDIA GPU setup modifies boot configuration, which can cause boot issues if something goes wrong.

In plain English

HyDE is a pre-configured desktop environment setup for Linux, built around Hyprland, a modern window manager that uses a compositor called Wayland instead of the older X11 display system. A window manager controls how application windows are arranged, animated, and styled on screen. HyDE layers on top of Hyprland with a collection of themes, configuration files, scripts, and companion tools to produce a visually polished desktop that works out of the box. The project is aimed at users who want a highly customized, aesthetically focused Linux desktop without having to piece together each component themselves. It includes support for switching between multiple visual themes, toggling between dark and light modes, and changing wallpapers in a way that adjusts the color scheme of the entire desktop to match. The community around the project places emphasis on appearance, which is common in the Linux customization hobby often called "rice" or "unix porn." Installation is handled by a shell script and is designed for Arch Linux, a distribution known for being highly configurable but also requiring more manual setup than consumer-oriented distributions. The script also works on some Arch-based distributions. It detects NVIDIA graphics cards automatically and installs the appropriate drivers, though it modifies boot configuration in the process, which the README flags as something to be aware of. NixOS users are pointed to a separate community-maintained port. Updating HyDE involves re-running the install script, which overwrites configuration files. Prior configurations are backed up automatically before being replaced. The project has a Discord community and documentation wiki for support.

Copy-paste prompts

Prompt 1
How do I install HyDE on Arch Linux with an NVIDIA GPU and what should I know about the boot configuration changes it makes?
Prompt 2
How do I switch themes in HyDE and add my own wallpaper that changes the desktop color scheme automatically?
Prompt 3
Walk me through how to update HyDE to the latest version and what happens to my existing configuration files.
Prompt 4
What Arch-based Linux distributions other than Arch itself are supported by the HyDE install script?
Open on GitHub → Explain another repo

← hyde-project on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.