The best Hyprland dotfiles and rices in 2026
Hyprland is a dynamic tiling Wayland compositor known for its animations and for how far it can be customized. Out of the box it gives you windows and a config file, nothing else: the bar, launcher, widgets, wallpaper and colors come from the setup you put on top. That is why most people start from someone else’s dotfiles.
The setups below range from complete desktops with their own installer and settings app, to small personal rices you copy by hand. They differ a lot in what they do to your system. Several replace your existing ~/.config folders, install dozens of packages and run their own install script, so the "What it changes" and "Difficulty" columns matter more than the screenshot.
Hyprland also changes its config format between releases. Every entry here is pinned to an exact commit, so the version you read about is the version you install.
19 entries · each pinned to an exact upstream version · updated
Picks by need
- A complete desktop with a settings app
ML4W DotfilesA guided installer, a settings app for the whole desktop and colors taken from your wallpaper. It runs on Arch-based distros, Fedora and openSUSE, and a Live ISO lets you try it in a virtual machine first.
AdvancedActive - The most polished interface
Illogical Impulse Dots
A Quickshell interface with a live overview of your windows, an AI sidebar and Material colors. It is mostly a shell rather than a system setup, and its installer shows every command before running it.
AdvancedActive - Many looks to switch between
HyDEThe maintained successor of Hyprdots, with a theme switcher and a gallery of themes. It expects a fresh, minimal Arch install and also takes over GTK and Qt theming, your shell, SDDM and GRUB.
AdvancedActive - On NixOS
Misterio77 nix-configA complete flake with home-manager and a heavily configured Hyprland. It also sets up disk layout, Secure Boot and secrets, so copy the parts you need rather than switching to it as it is.
Manual setupActive - Building your own, piece by piece
Hyprland Reference CompositorHyprland and its default Lua config from your distro’s packages. Add hyprlock and hyprpaper from the same project, then a bar and launcher of your choice: the slowest start, and the one you will understand best.
ModerateActive
All 19 entries, compared
Filter in the catalogue →| Setup | Works with | Difficulty | What it changes | Maintenance | Stars |
|---|---|---|---|---|---|
| Hyprland Reference CompositorOfficial dynamic tiling Wayland compositor that doesn't sacrifice on the looks. | Works with: Hyprland (Wayland) · Arch Linux, NixOS, Fedora, openSUSE | Moderate | Changes: 4 packages · 1 folder in ~ | Active | Stars: 39k |
| Works with: Hyprland (Wayland) · Arch Linux, Fedora, NixOS | Advanced | Changes: 1 folder in ~ · own installer | Active | Stars: 16k | |
| Caelestia ShellQuickshell-based desktop shell for Hyprland with dashboard, launcher and dynamic colors. | Works with: Hyprland (Wayland) · Arch Linux | Manual setup | Changes: Nothing for you: follow the upstream guide | Active | Stars: 13k |
| HyDESuccessor of Hyprdots: themeable Hyprland desktop with a theme switcher and gallery. | Works with: Hyprland (Wayland) · Arch Linux | Advanced | Changes: 1 folder in ~ · own installer | Active | Stars: 9.7k |
 HyDE HyprdotsAesthetic, dynamic and minimal dotfiles for Arch Linux Hyprland with dynamic theming. | Works with: Hyprland (Wayland) · Arch Linux, EndeavourOS | Advanced | Changes: 2 packages · 1 folder in ~ · own installer | Quiet | Stars: 8.5k |
| Awesome HyprlandCommunity list of Hyprland plugins, tools, bars and dotfiles. | Works with: Hyprland (Wayland) | Reading list | Changes: — | Active | Stars: 5.4k |
| ML4W DotfilesFull Hyprland desktop with a settings app, wallpaper-driven colors and guided installer. | Works with: Hyprland (Wayland) · Arch Linux, Fedora, openSUSE | Advanced | Changes: own installer | Active | Stars: 5.1k |
 JaKooLit Arch HyprlandComplete automated Arch Linux Hyprland installation and configuration setup. | Works with: Hyprland (Wayland) · Arch Linux, EndeavourOS, Manjaro | Advanced | Changes: 1 folder in ~ · own installer | Quiet | Stars: 4.6k |
| Aylur DotfilesPersonal Hyprland setup by the author of AGS, built around a custom GTK shell. | Works with: Hyprland (Wayland) | Manual setup | Changes: Nothing for you: follow the upstream guide | Active | Stars: 3.1k |
| Works with: Hyprland (Wayland) | Manual setup | Changes: Nothing for you: follow the upstream guide | Active | Stars: 2.0k | |
| hyprlockFast, GPU-accelerated lock screen for Hyprland. | Works with: Hyprland (Wayland) | Moderate | Changes: 1 package | Active | Stars: 1.7k |
| hyprpaperFast wallpaper utility for Hyprland with IPC. | Works with: Hyprland (Wayland) | Moderate | Changes: 1 package | Active | Stars: 1.4k |
| Misterio77 nix-configFlake-based NixOS and home-manager setup with Hyprland and generated colors. | Works with: Hyprland (Wayland) · NixOS | Manual setup | Changes: Nothing for you: follow the upstream guide | Active | Stars: 1.3k |
 gBarLightweight status bar for Wayland written in C++ with GTK. | Works with: Hyprland (Wayland) | Advanced | Changes: 1 package | Quiet | Stars: 540 |
 nwg-dock-hyprlandGTK3 dock for Hyprland, styled with CSS. | Works with: Hyprland (Wayland) | Moderate | Changes: 1 package | Active | Stars: 456 |
 Catppuccin HyprlandSoothing pastel color themes (Mocha, Macchiato, Frappe, Latte) for Hyprland. | Works with: Hyprland (Wayland) · Arch Linux, NixOS, Fedora, Void Linux | Easy | Changes: 2 folders in ~ | Active | Stars: 425 |
 HyprPanelAll-in-one panel for Hyprland with dashboards, notifications and a settings dialog. | Works with: Hyprland (Wayland) | Advanced | Changes: 1 package | Archived upstream | Stars: 2.2k |
 linuxmobile Hyprland DotsCompact Hyprland rice with eww widgets and a warm, low-contrast palette. | Works with: Hyprland (Wayland) | Manual setup | Changes: Nothing for you: follow the upstream guide | Archived upstream | Stars: 1.7k |
 Ax-ShellHyprland shell written with Fabric: notch bar, dashboard, launcher and wallpaper colors. | Works with: Hyprland (Wayland) · Arch Linux | Advanced | Changes: own installer | Archived upstream | Stars: 1.6k |
Avoid or migrate
These still install, but their projects have stopped. Pick a maintained alternative for a new setup.
- HyprPanel
The upstream repository is archived: it may still work, but bugs will not be fixed.
- linuxmobile Hyprland Dots
The upstream repository is archived: it may still work, but bugs will not be fixed.
Move to: flick0 Dotfiles, Illogical Impulse Dots
- Ax-Shell
The upstream repository is archived: it may still work, but bugs will not be fixed.
Move to: Caelestia Shell, ML4W Dotfiles
- HyDE Hyprdots
No longer maintained: development continues as HyDE.
Move to: HyDE
- JaKooLit Arch Hyprland
Announced to be archived from March 2026, with maintenance moving to the LinuxBeginnings fork.
Move to: HyDE, ML4W Dotfiles
How to choose
- Start from your distro: most complete setups target Arch Linux, a few support Fedora or NixOS. Check the "Works with" column first.
- Prefer "Manual setup" or "Easy" entries if you want to understand your desktop; pick a complete desktop if you want everything working on day one and accept a bigger install.
- Look at the shell it is built on (Quickshell, AGS, Fabric, eww or Waybar): that is what you will edit later.
Questions
Can I try Hyprland dotfiles without breaking my current desktop?
Yes. Create a second user account and install there first: dotfiles only touch that user’s home folder, apart from the packages they install. On your main account, run the 0xTsoa installer with --dry-run to see the plan, and keep its backups so --rollback can restore your files.
Which Hyprland dotfiles are best for beginners?
The complete desktops with a guided installer and a settings app are the quickest to get working, but they change the most files. If you want to learn how Hyprland fits together, start from a smaller setup marked Manual or Easy and add pieces one at a time.
Why does a Hyprland config stop working after an update?
Hyprland renames and removes options between releases. Setups that track the latest version are updated quickly; quiet or archived ones may need fixes. The Maintenance column shows when each upstream project was last updated.