Install Dotfiles — WifeRice

One-Click Installer (Recommended)

The one-liner does everything — asks what to preserve, detects your hardware (NVIDIA, AMD, Intel), and installs Hyprland, QuickShell, SDDM, wallpapers, and all required dependencies. This is the same command the update notifier runs, so it works for both fresh installs and updates.

bash -c 'eval "$(curl -fsSL https://raw.githubusercontent.com/eprahemi/WifeRice/main/install.sh)"'

Step-by-Step Manual

Clone the repo and cherry-pick what you need.

# Clone the repository
git clone --depth 1 https://github.com/eprahemi/WifeRice.git

# Copy configuration files
cp -r WifeRice/Hyprland/* ~/.config/hypr/

# Install QuickShell files
rsync -a --exclude='.env' WifeRice/Hyprland/scripts/quickshell/ ~/.config/hypr/scripts/quickshell/

# Set up SDDM theme (optional)
sudo rm -rf /usr/share/sddm/themes/matugen-minimal
sudo mkdir -p /usr/share/sddm/themes/matugen-minimal
sudo cp -r WifeRice/SDDM/matugen-minimal/* /usr/share/sddm/themes/matugen-minimal/

# Install wallpapers
cp WifeRice/Wallpapers/* ~/Pictures/Wallpapers/
sudo cp WifeRice/SDDM-Wallpaper/wallpaper.png /usr/share/wallpapers/lock.png  # supports PNG, JPG, JPEG, WEBP, BMP

What the Installer Does

Asks what to preserve (keybinds, terminal configs, desktop configs, wallpapers, telemetry, SDDM theme override, Himeno face icon, weather API)
Installs Hyprland, QuickShell, SDDM, and all required dependencies
Detects and installs GPU drivers (NVIDIA, AMD, Intel)
Deploys QuickShell UI files (GuidePopup, WallpaperPicker, Floating sidebar, etc.)
Sets up wallpapers: Himeno as default, lock screen, SDDM login theme
Pre-generates wallpaper thumbnails for fast picker startup
Creates systemd timers for health monitoring
Enables audio auto-switch service
Writes version info for update detection

Important Notes

The installer asks what to preserve and never wipes your personal data. Your settings.json is updated every release with the latest monitor config and scaling fixes — a safety backup is saved to /tmp/wiferice_settings_backup.json and restored if validation fails. Customize your settings via the Settings UI (Super+Shift+S) instead of editing the file directly. Your custom lock screen wallpapers go to ~/.config/hypr/Lockscreen Wallpaper/ and survive updates. Your weather .env config survives updates.

After install, reboot and log into SDDM. Press Super+H for the guide, Super+W for the wallpaper picker.

Back to Home