# Core Hyprland components
sudo pacman -S hyprland hyprlock hyprshot wlogout

# Terminal emulator
sudo pacman -S kitty

# Status bar & Wallpaper manager
sudo pacman -S waybar swww waypaper hyprpaper

# Application launcher
sudo pacman -S wofi

# File manager
sudo pacman -S nautilus

# Audio control (PipeWire)
sudo pacman -S wireplumber pipewire-pulse

# Brightness control
sudo pacman -S brightnessctl

# Media player control
sudo pacman -S playerctl

# Cursor theme
sudo pacman -S adwaita-cursors

# Pywal for dynamic colors (optional but recommended)
sudo pacman -S python-pywal

# Install rust/cargo if you don't have it (needed for Caelestia)
sudo pacman -S rust

Step 2: Install Optional Applications

# Applications referenced in config (adjust to your preference)
sudo pacman -S telegram-desktop spotify code

# AUR packages (requires yay or another AUR helper)
yay -S google-chrome zen-browser-bin  # or your preferred browser

Step 3: Install Caelestia Shell (Optional)

Caelestia is a modern shell with AI features that integrates with the pywal theming system.

# Install Caelestia via cargo
cargo install caelestia

# Start Caelestia daemon (it will auto-restart when pywal colors change)
caelestia shell -d &

Note: Caelestia runs as a background service and integrates with pywal for dynamic color theming.

Step 4: Clone This Repository

# Clone to a temporary location
cd ~/Downloads
git clone https://github.com/yourusername/hyprduma-config.git
cd hyprduma-config

Step 5: Backup Existing Configs (If Any)

# Backup existing Hyprland config
[ -d ~/.config/hypr ] && mv ~/.config/hypr ~/.config/hypr.backup

# Backup existing waybar config
[ -d ~/.config/waybar ] && mv ~/.config/waybar ~/.config/waybar.backup

# Backup existing wlogout config
[ -d ~/.config/wlogout ] && mv ~/.config/wlogout ~/.config/wlogout.backup

Step 6: Install Hyprland Configuration

# Create Hypr config directory
mkdir -p ~/.config/hypr

# Copy main config
cp hyprland.conf ~/.config/hypr/

# Create screenshots directory (used by config)
mkdir -p ~/Pictures/Screenshots

Step 7: Configure Your Applications

IMPORTANT: Edit the config file to set your preferred applications.

# Open the config file
nvim ~/.config/hypr/hyprland.conf

# Find lines 27-34 and adjust these variables:
# $terminal = kitty              # Your terminal
# $fileManager = dolphin         # Your file manager
# $menu = wofi --show drun       # Your app launcher
# $telegram = Telegram           # Path to Telegram
# $spotify = spotify             # Path to Spotify
# $vscode = code                 # Path to VSCode
# $browser = your-browser        # Your browser command

Step 8: Install Pywal Integration (Optional but Recommended)

Pywal provides dynamic color theming based on your wallpaper.

# Install pywal templates
mkdir -p ~/.config/wal/templates
cp -r wal/templates/* ~/.config/wal/templates/

# Copy the color application script
cp apply-pywal-colors.sh ~/.config/hypr/
chmod +x ~/.config/hypr/apply-pywal-colors.sh

# Test pywal with a wallpaper
wal -i /path/to/your/wallpaper.png

# Apply colors to Hyprland and Caelestia
~/.config/hypr/apply-pywal-colors.sh

What this does:

Generates a color scheme from your wallpaper
Applies colors to Hyprland window borders
Applies colors to Caelestia shell (if installed)
Restarts necessary services to apply changes

Step 9: Install Waybar Config (If You Have It)

# If you have waybar configs in this repo
mkdir -p ~/.config/waybar
cp -r waybar/* ~/.config/waybar/

Step 10: Install Wlogout Config (If You Have It)

# If you have wlogout configs in this repo
mkdir -p ~/.config/wlogout
cp -r wlogout/* ~/.config/wlogout/

Step 11: Start Hyprland

# If you're in a TTY, start Hyprland
Hyprland

# If already in Hyprland, reload the config
# Press SUPER + SHIFT + R (or restart Hyprland session)

Step 12: Set Up Autostart for Caelestia (Optional)

If you want Caelestia to start automatically with Hyprland:

# Edit your Hyprland config
nvim ~/.config/hypr/hyprland.conf

# Add this line in the Autostart section (around line 21-25):
# exec-once = caelestia shell -d

Post-Installation

Setting Wallpaper with Pywal

# Generate colors and apply them
wal -i /path/to/wallpaper.png && ~/.config/hypr/apply-pywal-colors.sh

# Or use waypaper GUI to select wallpapers
waypaper

Monitor Configuration

If you have different monitors, adjust lines 4-18 in ~/.config/hypr/hyprland.conf:

nvim ~/.config/hypr/hyprland.conf

# Edit monitor configuration:
# monitor = eDP-1, 1920x1080@144, 1920x0, 1
# monitor = HDMI-A-1, 1920x1080@144, 0x0, 1, transform, 2

Keyboard Layout

Default is US/RU with ALT+SHIFT toggle. To change, edit ~/.config/hypr/hyprland.conf line 42:

kb_layout = us, ru  # Change to your layouts

Documentation

KEYBINDS.md - Complete keybindings reference
PYWAL-SETUP.md - Detailed pywal integration guide

Troubleshooting

Hyprland won't start

Check if all required packages are installed
Review error logs: journalctl -b | grep hyprland

Applications don't launch

Make sure you edited the app variables in hyprland.conf (lines 27-34)
Check if the applications are actually installed

Pywal colors not applying

Ensure the script is executable: chmod +x ~/.config/hypr/apply-pywal-colors.sh
Check if pywal cache exists: ls ~/.cache/wal/
Manually reload: ~/.config/hypr/apply-pywal-colors.sh

Caelestia colors not updating

# Restart Caelestia daemon
pkill caelestia && sleep 0.5 && caelestia shell -d &

Note

Everything is still in progress. Feel free to customize and adjust to your needs!