Chill Dots

A complete Hyprland rice for Arch Linux with automatic wallpaper-based theming.

Screenshots • Features • What's Included • Installation • Auto Theming • Keybindings

---

Screenshots

Every screenshot above uses the same config — the only difference is the wallpaper. Colors are generated automatically.

---

Features

• Auto-theming — wallust extracts a 16-color palette from your wallpaper and applies it across your entire desktop in real-time
• Wallpaper rotation — systemd timer swaps wallpapers every 20 minutes with smooth awww transitions, re-theming everything automatically
• 106 curated wallpapers included out of the box
• Custom animations — bezier-curved window open/close, smooth workspace transitions, animated borders
• Blur & transparency — layered blur with vibrancy on panels, launchers, and lock screen
• Weather in your bar — live weather module in Waybar
• One-command install — backs up your existing configs, installs everything, and applies the theme

---

What's Included

Component	Tool	Description
Window Manager	Hyprland	Tiling Wayland compositor with animations & blur
Status Bar	Waybar	Customizable bar with weather, system stats, workspaces
Terminal	Kitty / Ghostty / Alacritty	GPU-accelerated terminals
App Launcher	Walker	Wayland-native application launcher
Notifications	Mako	Lightweight Wayland notification daemon
Wallpaper	awww + Waypaper	Smooth transitions + GUI wallpaper picker
Auto-theming	wallust	Color extraction & template system
Shell	Oh My Zsh + Starship	Zsh with autosuggestions, syntax highlighting, zoxide, mise, aliases
OSD	SwayOSD	On-screen display for volume/brightness
Lock Screen	Hyprlock	Hyprland-native lock screen
Idle Daemon	Hypridle	Auto-lock & screen off on idle
Theme Base	Omarchy	Base theme layer

Full package list (180 official + 5 AUR)

Official packages are listed in pkglist-official.txt and AUR packages in pkglist-aur.txt. Key categories:

• Dev tools — neovim, git, docker, lazygit, lazydocker, nodejs, python, rust, ruby, mise, pnpm, uv
• Browsers — chromium, brave (AUR), cursor (AUR)
• Media — obs-studio, kdenlive, mpv, ffmpeg, imagemagick
• Apps — obsidian, signal-desktop, spotify, libreoffice
• CLI utilities — btop, eza, bat, fzf, ripgrep, fd, tldr, jq, tmux, zoxide, wget
• Zsh plugins — zsh-autosuggestions, zsh-syntax-highlighting, zsh-completions (system packages)
• Fonts — JetBrains Mono Nerd Font, Noto (CJK + Emoji)

---

Installation

Prerequisites

• Arch Linux with an active internet connection
• Omarchy installed first

Steps

# Clone the repo
git clone https://github.com/kabir0st/chill-dots.git
cd chill-dots

# Run the installer
chmod +x install.sh
./install.sh

The installer will:

1. Install all packages (official + AUR via yay)
2. Back up your existing configs to ~/.config-backup-<timestamp>/
3. Copy 106 wallpapers to ~/Pictures/Wallpapers/
4. Deploy all config files to ~/.config/
5. Set up Oh My Zsh with plugins, aliases, zoxide, mise, fzf, and tool integrations
6. Enable systemd services (wallpaper rotation + audio)
7. Apply the default theme and generate initial color scheme

After installation, log out and back in (or reboot). If your monitors look wrong, edit ~/.config/hypr/monitors.conf.

---

Auto Theming

The auto-theming system is the core of this rice. Here's how it works:

┌─────────────┐     ┌─────────┐     ┌──────────────────────┐
│  Wallpaper   │────▶│ wallust │────▶│  Template Engine      │
│  (any image) │     │ kmeans  │     │  7 config templates   │
└─────────────┘     └─────────┘     └──────────┬───────────┘
                                               │
                    ┌──────────────────────────┐│
                    │  Live-updated configs:    ││
                    │  ├─ Hyprland (borders)    │◀
                    │  ├─ Waybar (panel)        │
                    │  ├─ Kitty (terminal)      │
                    │  ├─ Mako (notifications)  │
                    │  ├─ Walker (launcher)     │
                    │  ├─ Starship (prompt)     │
                    │  └─ Shell env vars        │
                    └──────────────────────────┘

wallust uses k-means clustering to extract a 16-color dark palette from the current wallpaper. It then renders 7 template files that inject those colors into every themed application — no restart needed.

Trigger methods

Trigger	What happens
Automatic (every 20 min)	systemd timer picks a random wallpaper → sets it with awww → runs wallust → reloads all apps
Manual switch	Super + W opens Waypaper GUI → pick a wallpaper → colors regenerate
Omarchy theme change	The theme-set hook re-runs wallust so colors stay in sync

Configuration

The wallust config lives at configs/wallust/wallust.toml:

backend = "kmeans"        # Color extraction algorithm
color_space = "labmixed"  # Perceptual color space
palette = "dark16"        # 16-color dark palette
check_contrast = true     # Ensure readability
threshold = 11            # Minimum contrast ratio

Templates are in configs/wallust/templates/ — edit these to customize how colors map to each application.

---

Keybindings

Key	Action
Super + Enter	Open terminal (Kitty)
Super + Alt + Enter	Tmux session
Super + Shift + Return	Open browser
Super + Shift + W	Wallpaper picker (Waypaper)
Super + Shift + R	Random wallpaper
Super + Shift + S	Screenshot (select area)
Super + V	Clipboard history (CopyQ)
Super + E	File manager
Super + Shift + M	Spotify
Super + Shift + N	Editor
Super + Shift + D	Lazydocker
Super + Shift + O	Obsidian

Full keybindings are in configs/hypr/bindings.conf.

---

Structure

chill-dots/
├── install.sh              # One-command installer
├── pkglist-official.txt    # 180 official Arch packages
├── pkglist-aur.txt         # 5 AUR packages
├── configs/
│   ├── hypr/               # Hyprland (WM, animations, blur, bindings)
│   ├── wallust/            # Auto-theming engine + 7 color templates
│   ├── waybar/             # Status bar + weather script
│   ├── kitty/              # Terminal config
│   ├── ghostty/            # Alt terminal config
│   ├── alacritty/          # Alt terminal config
│   ├── mako/               # Notification daemon
│   ├── starship/           # Shell prompt
│   ├── walker/             # App launcher
│   ├── swayosd/            # On-screen display
│   ├── waypaper/           # Wallpaper manager
│   └── omarchy/            # Theme hooks & menu extensions
├── shell/
│   └── .zshrc              # Zsh config with Oh My Zsh
├── systemd/                # Wallpaper rotation timer + services
├── wallpapers/             # 106 curated wallpapers
└── screenshots/

---

---

^{AMD GPU users: If you have an RX 6800 (or similar RDNA2 card) and want to run ML workloads with ROCm, see the ROCm setup guide.}

Built on Hyprland + Omarchy + wallust on Arch Linux