01. Overview & Architecture

Profile: v0.1.0
Schema validatedSource pinned
Purpose
Aesthetic, dynamic and minimal dotfiles for Arch Linux Hyprland with dynamic theming.
Compatibility
Arch Linux, EndeavourOS (Server: WAYLAND)
Window Manager & Theme
Hyprland / Catppuccin Mocha / Dynamic
Key Components
Bar:Waybar (Multi-theme)•Terminal:Kitty•Launcher:Rofi-wayland•Notifications:Dunst•Editor:Neovim•Shell:zsh + Starship
Full Description
HyDE (Hyprdots Desktop Environment) provides a modular, fluid and heavily customized Arch Linux environment on Hyprland. Features custom dynamic theme switching across 15+ styles, Waybar integration, Kitty terminal styling, Rofi-wayland app launcher, Dunst notifications, and streamlined pacman/AUR package workflows.

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactPackages: base-devel, gitWrites: ~/HyDERuns the upstream installer ./install.sh, which manages its own files. The guided installer backs up your usual desktop config folders first.
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: back up first (Option A, step 3).
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/prasanthrangan/hyprdots ~/0xtsoa-review/prasanthrangan-hyprdots# 1. clone to a review folder
$git -C ~/0xtsoa-review/prasanthrangan-hyprdots checkout --detach 3c8b0dfb5e7f8e41a67b80463513f10d57cab1a4# 2. the reviewed commit
$for p in ~/HyDE ~/.config/hypr ~/.config/quickshell ~/.config/waybar ~/.config/eww ~/.config/ags ~/.config/hyprpanel ~/.config/kitty ~/.config/foot ~/.config/alacritty ~/.config/wezterm ~/.config/ghostty ~/.config/rofi ~/.config/wofi ~/.config/fuzzel ~/.config/dunst ~/.config/mako ~/.config/swaync ~/.config/i3 ~/.config/sway ~/.config/niri ~/.config/bspwm ~/.config/sxhkd ~/.config/awesome ~/.config/polybar ~/.config/picom ~/.config/qtile ~/.config/wlogout ~/.config/swaylock ~/.config/fish ~/.config/nvim ~/.config/fastfetch ~/.config/starship.toml ~/.config/matugen ~/.config/wal ~/.config/gtk-3.0 ~/.config/gtk-4.0 ~/.config/Kvantum ~/.config/qt5ct ~/.config/qt6ct ~/.bashrc ~/.zshrc ~/.themes; do [ -e "$p" ] && cp -a "$p" "$p.bak-0xtsoa"; done# 3. back up what the steps write
Read the upstream installer in ~/0xtsoa-review/prasanthrangan-hyprdots before running it, and every script it calls.Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Prerequisites & Base Dependencies
$sudo pacman -Syu --needed base-devel git
$git clone --filter=blob:none https://github.com/prasanthrangan/hyprdots ~/HyDE
$git -C ~/HyDE checkout 3c8b0dfb5e7f8e41a67b80463513f10d57cab1a4
2Interactive Install Script Execution
$cd ~/HyDE/Scripts
$./install.sh
3Session Initialization
$hyprctl reload
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/prasanthrangan/hyprdots/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // HyDE Hyprdots

Capture 01 // Fullscreen
HyDE banner showcasing Hyprland Waybar and desktop theming
01 / 03

04. Documentation & Guide

Source: prasanthrangan/hyprdotsRef: 3c8b0dfb5e
README.md|GitHub Flavored Markdown
// design by t2

hyde_banner


⚠️ Deprecation Notice:

This repository is not maintained anymore.
Please refer to Hyde-project/hyde for the latest updates and contributions.

GitHub Flavored Markdown (github-markdown-css)README snapshot at 3c8b0dfb5e

05. Keyboard Shortcuts

Total: 5 shortcuts
SUPER + QShortcut
exec, kitty
Launch Kitty terminal
SUPER + CShortcut
killactive
Close active window
SUPER + SPACEShortcut
exec, rofi -show drun
Application launcher
SUPER + TShortcut
exec, themeselect.sh
Open theme switcher
SUPER + LShortcut
exec, swaylock
Lock screen