whatisgithub

What is hyprdots?

prasanthrangan/hyprdots — explained in plain English

Analysis updated 2026-06-24

8,521ShellAudience · developerComplexity · 3/5Setup · hard

In one sentence

A pre-configured Arch Linux desktop setup using the Hyprland compositor, bundling themes, dotfiles, and an automated install script to give a fresh system a polished minimal look. Now deprecated, active development has moved to Hyde-project/hyde.

Mindmap

mindmap
  root((hyprdots))
    What it does
      Arch desktop setup
      Hyprland compositor
      Automated install
    Themes Included
      Catppuccin
      Gruvbox
      Tokyo Night
      Synth Wave
    Features
      NVIDIA auto-install
      Theme swapping
      Shell config
    Status
      Deprecated
      Successor Hyde-project
    Audience
      Linux enthusiasts
      Arch Linux users
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

What do people build with it?

USE CASE 1

Set up a visually polished Hyprland desktop on a fresh Arch Linux install using a single automated script

USE CASE 2

Swap between over a dozen pre-built themes like Catppuccin, Gruvbox, and Tokyo Night using the themepatcher tool

USE CASE 3

Automatically install NVIDIA graphics drivers as part of the desktop setup process

USE CASE 4

Study the configuration files as a reference for building your own custom Hyprland setup

What is it built with?

ShellArch LinuxHyprland

How does it compare?

prasanthrangan/hyprdotsthoughtbot/laptoporbstack/orbstack
Stars8,5218,5538,587
LanguageShellShellShell
Setup difficultyhardeasyeasy
Complexity3/51/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Designed for a fresh or minimal Arch Linux install, running alongside an existing desktop environment will likely cause conflicts.

The README does not specify a license for this project.

So what is it?

This repository contains a pre-configured visual setup for Arch Linux using a window manager called Hyprland. Hyprland is a compositor, meaning it controls how windows are drawn and arranged on screen. The project (called HyDE) bundles together configuration files, themes, and an install script to give an Arch Linux system a polished, minimal aesthetic without the user having to assemble each piece by hand. The install script handles almost everything: it clones the repository, installs the required packages from Arch's package manager, and sets up the desktop environment including the login screen, shell configuration, and theming tools. If the system has an NVIDIA graphics card, the script automatically installs the appropriate drivers. The README warns that running this alongside an existing desktop environment will likely conflict with it, so it is best suited for a fresh or minimal Arch install. Themes are stored in a companion repository and can be swapped using a tool called themepatcher. The project ships with over a dozen themes including Catppuccin, Gruvbox, Tokyo Night, Synth Wave, and others, each with its own color palette. Importantly, this repository is no longer actively maintained. The README displays a deprecation notice directing users to a successor project called Hyde-project/hyde for ongoing updates and contributions. The content here still works as a reference or starting point, but new development has moved elsewhere. A NixOS-compatible version is maintained separately as a third-party project called Hydenix, for users on that Linux distribution.

Copy-paste prompts

Prompt 1
I have a fresh minimal Arch Linux install. Walk me through running the hyprdots install script and what to expect at each step.
Prompt 2
After installing hyprdots, how do I use themepatcher to switch from the default theme to the Catppuccin theme?
Prompt 3
The hyprdots README says to use Hyde-project/hyde instead. What has changed between hyprdots and the new Hyde project, and how do I migrate my existing setup?
Prompt 4
My hyprdots install failed at the NVIDIA driver step. What should I check and how do I manually install the correct NVIDIA drivers for Hyprland on Arch?
Prompt 5
Show me the folder structure of hyprdots and explain what each config directory controls, waybar, hypr, kitty, etc.

Frequently asked questions

What is hyprdots?

A pre-configured Arch Linux desktop setup using the Hyprland compositor, bundling themes, dotfiles, and an automated install script to give a fresh system a polished minimal look. Now deprecated, active development has moved to Hyde-project/hyde.

What language is hyprdots written in?

Mainly Shell. The stack also includes Shell, Arch Linux, Hyprland.

What license does hyprdots use?

The README does not specify a license for this project.

How hard is hyprdots to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is hyprdots for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.