Repolode
Submit
end-4

end-4/dots-hyprland

Hyprland desktop dotfiles centered on a Material-themed Quickshell shell with an overview, AI widgets and screen tools for Wayland.

View on GitHubWebsite
Stars
16,414
Forks
1,400
Open issues
690
Last commit
10 days ago

What is it?

This repository is a set of configuration files for the Hyprland Wayland compositor, with most of the work going into a custom graphical shell built on Quickshell. The shell provides a status bar, sidebars and widgets, and includes an overview that shows open apps with live previews.

The desktop includes AI integrations such as Gemini and Ollama, plus quality-of-life features like screen translation, an anti-flashbang option and Google Lens. Colors are generated from a chosen wallpaper using Material design themes. Keybinds are designed to feel familiar to Windows or GNOME users, and pressing Super+/ lists them.

An install script is provided, and every command is shown before it runs. The project is not a system setup script: it does not install graphics drivers or configure zram. A 0.55 update note warns that users on distributions without Hyprland 0.55 should use the pre-Luaification release.

Key features

  • 01Overview view that shows open apps with live previews
  • 02Built on Quickshell for the status bar, sidebars and widgets
  • 03AI integrations including Gemini and Ollama
  • 04Screen translation and Google Lens support
  • 05Material-style color themes generated from wallpaper

Use cases

  • Setting up a customized Hyprland desktop on a Wayland Linux system
  • Studying how a Quickshell-based desktop shell is structured
  • Adding local or cloud AI assistants to a Linux desktop

Quick start

  1. 1

    Run the official install script from the README

  2. 2

    Or clone the repo and run the setup script

    ./setup install

Things to know

  • Requires Hyprland, a Wayland compositor, so it is not for X11 or other desktops.
  • Not a system setup script; graphics drivers and similar system config are not included.
  • Hyprland 0.55 changes may break setups on distros that have not shipped that version.

Topics

#hyprland#wayland#quickshell#dotfiles#linux#material-design#rice#ricing#unixporn

FAQ

What is dots-hyprland?
Hyprland desktop dotfiles centered on a Material-themed Quickshell shell with an overview, AI widgets and screen tools for Wayland. This repository is a set of configuration files for the Hyprland Wayland compositor, with most of the work going into a custom graphical shell built on Quickshell. The shell provides a status bar, sidebars and widgets, and includes an overview that shows open apps with live previews.
Is dots-hyprland free to use? What license does it have?
dots-hyprland is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is dots-hyprland still maintained?
Actively maintained. The last commit to dots-hyprland was on Oct 11, 2026.
What can I use dots-hyprland for?
Setting up a customized Hyprland desktop on a Wayland Linux system Studying how a Quickshell-based desktop shell is structured Adding local or cloud AI assistants to a Linux desktop
How do I install dots-hyprland?
Run the official install script from the README Or clone the repo and run the setup script: ./setup install
Where can I get dots-hyprland?
The source code and installation instructions are on GitHub: https://github.com/end-4/dots-hyprland

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects