Parzij Hyprland Rice

A complete Arch Linux desktop configuration built around Hyprland, a dynamic Waybar island, custom lock and login screens, hardware controls, and a safe guided installer.

Overview

This repository contains the configuration I use as my daily desktop environment on Arch Linux.

The rice focuses on:

• a clean dark visual style;
• fast keyboard-driven navigation;
• a dynamic center island in Waybar;
• custom volume, microphone, and brightness OSD;
• matching Hyprlock and SDDM screens;
• automatic idle, lock, and suspend behavior;
• support for ASUS ROG laptop controls;
• safe installation with automatic backups.

Features

Dynamic Waybar island

The center module follows a simple priority system:

1. temporary system and Jarvis notifications;
2. volume, microphone, and brightness OSD;
3. the currently active application.

Spotify metadata is intentionally kept outside the center island.

Hardware volume changes are also detected through PipeWire, including changes made directly from Bluetooth headphones such as AirPods.

Hyprland workflow

The configuration includes:

• animated windows and workspaces;
• four-finger hide and restore gestures;
• screenshot tools;
• clipboard history;
• Wofi application launcher;
• keyboard layout switching;
• media and hardware controls;
• ASUS ROG power-profile controls.

Matching lock and login screens

Hyprlock and SDDM use the same visual language:

• blurred samurai wallpaper;
• JetBrains Mono Nerd Font;
• clock and date;
• keyboard layout;
• Caps Lock indicator;
• battery information;
• custom password field and animations.

Launcher and clipboard

Installation

This installer is intended for Arch Linux. Review the repository before running it on your system.

Clone the repository:

git clone https://github.com/parzij/ArchLinux-setup.git
cd ArchLinux-setup

Make the installer executable:

chmod +x install.sh

Start the guided installation:

./install.sh

The installer will:

• install required Arch packages;
• create backups of existing configurations;
• install Hyprland, Waybar, and Wofi configs;
• render user-specific paths;
• install and enable the volume watcher;
• enable Hypridle;
• optionally install the SDDM theme;
• configure English and Russian keyboard layouts;
• optionally install ASUS and NVIDIA packages.

After installation, log out or reboot.

Installer options

--yes             accept default answers
--no-packages     skip package installation
--no-sddm         skip the SDDM theme
--with-asus       install ASUS/ROG packages
--with-nvidia     install NVIDIA utilities
-h, --help        show installer help

Example for an ASUS ROG laptop with NVIDIA graphics:

./install.sh --with-asus --with-nvidia

Install only the configuration files:

./install.sh --no-packages --no-sddm

Backups

Existing user and system configurations are backed up before replacement.

Backups are stored in:

~/.local/state/parzij-rice/backups/

Each installation creates a timestamped directory.

Main keybindings

Shortcut	Action
Super + Q	Open Kitty
Super + E	Open Thunar
Super + D	Open Wofi
Super + C	Clipboard history
Super + S	Area screenshot
Super + L	Lock session
Super + M	Power menu
Super + Shift + H	Hide current window
Super + Shift + R	Restore hidden window
Win + Space	Switch keyboard layout

The hardware keys control:

• speaker volume;
• microphone mute;
• display brightness;
• keyboard backlight;
• ASUS performance profiles.

Idle behavior

Hypridle is configured to:

• dim the display after 90 seconds;
• lock the session after 3 minutes;
• suspend the system after 5 minutes;
• restore brightness after activity or resume.

These values can be changed in:

configs/hypr/hypridle.conf

Repository structure

.
├── configs
│   ├── hypr
│   │   ├── hypridle.conf
│   │   ├── hyprland.conf
│   │   ├── hyprlock.conf
│   │   └── scripts
│   ├── waybar
│   │   ├── config.jsonc
│   │   ├── style.css
│   │   └── scripts
│   └── wofi
├── packages
│   ├── core.txt
│   ├── optional-asus.txt
│   └── optional-nvidia.txt
├── sddm
│   └── jarvis-hyprlock
├── system
│   ├── bin
│   └── systemd
├── systemd
│   └── user
├── screenshots
├── install.sh
└── README.md

Main dependencies

The core configuration uses:

• Hyprland;
• Waybar;
• Hyprlock;
• Hypridle;
• Wofi;
• SwayNC;
• PipeWire and PulseAudio tools;
• Playerctl;
• Brightnessctl;
• Grim and Slurp;
• Cliphist;
• JetBrains Mono Nerd Font;
• Python and Requests.

Optional hardware-specific packages:

• asusctl;
• rog-control-center;
• nvidia-utils.

Hardware-specific configuration

Some bindings are designed for an ASUS ROG laptop:

asusctl
rog-control-center
asus::kbd_backlight
nvidia_wmi_ec_backlight

Users with different hardware should update the corresponding bindings and brightness devices in:

configs/hypr/hyprland.conf
configs/hypr/hypridle.conf

The Waybar configuration also contains optional click actions for the custom orbit utility. These actions are safely ignored when the command is unavailable.

Configuration templates

Portable configuration files use the placeholder:

__HOME__

During installation, it is replaced with the real home directory of the current user.

Do not replace this placeholder directly inside the repository.

Validation

The shell scripts can be checked with:

find configs system -type f -name '*.sh' -exec bash -n {} \;
bash -n install.sh

Python scripts:

python -m py_compile configs/waybar/scripts/*.py

Git whitespace validation:

git diff --check

Disclaimer

This is a personal daily-driver configuration, not a universal Arch Linux installer.

Review the scripts and configuration files before using them. Hardware-specific settings may require manual changes.

License

This project is distributed under the terms of the LICENSE file.