Parzij Hyprland Rice

A polished Arch Linux desktop built around Hyprland, Quickshell, Vicinae, Kitty and Zsh.

Overview

This repository contains my personal daily-driver rice for Arch Linux.

The environment combines a clean Kanagawa-inspired appearance with a keyboard-focused Hyprland workflow, a custom Quickshell desktop shell, Vicinae launcher, terminal configuration, lock screen, login screen and hardware controls.

Version 2.0.0 is a major redesign of the original Waybar and Wofi setup.

What is new in v2.0.0

Component	Change
Desktop shell	Custom Quickshell bar replaces Waybar
Application launcher	Vicinae replaces Wofi
Clipboard	Clipboard history is now opened through Vicinae
Desktop controls	New music, settings, weather, network, Bluetooth and system popups
Hyprland	Updated tiling behavior, window rules and keyboard controls
Terminal	Added Kitty, Zsh and Powerlevel10k configuration
System overview	Added a custom Fastfetch configuration and samurai logo
Appearance	New wallpaper and refreshed Kanagawa-inspired styling
Lock and login	Existing Hyprlock and SDDM design retained
Portability	User-specific home paths use the portable __HOME__ placeholder

The Jarvis voice assistant is intentionally not included in this release.

Quickshell desktop shell

The main panel is now implemented in QML with Quickshell instead of Waybar.

It provides a unified interface for:

• workspaces and the active application;
• system tray applications;
• music playback and media controls;
• Wi-Fi and Bluetooth management;
• audio, microphone and brightness controls;
• notifications;
• calendar and time;
• weather information;
• system statistics;
• power and session actions.

The shell configuration is located in:

configs/quickshell/parzij-shell/

Its Python backend handles system actions while the interface is implemented with reusable QML components and popup modules.

Vicinae launcher and clipboard

Vicinae replaces the previous Wofi launcher.

It is used for:

• launching applications;
• searching available commands;
• opening clipboard history;
• keyboard-driven desktop actions.

Kitty, Zsh and Fastfetch

Version 2 adds the terminal environment to the repository:

• Kitty terminal configuration;
• Zsh configuration;
• Powerlevel10k prompt;
• Nerd Font symbol mappings;
• Fastfetch configuration;
• custom samurai Fastfetch logo.

Hyprland workflow

The Hyprland configuration includes:

• dynamic tiling with the Dwindle layout;
• custom rules for tiled and floating windows;
• animated windows and workspace transitions;
• mouse-driven moving and resizing;
• workspace navigation from the keyboard and touchpad;
• four-finger hide and restore gestures;
• area screenshots;
• clipboard history;
• English and Russian keyboard layouts;
• hardware media keys;
• ASUS ROG performance and keyboard-backlight controls.

Main keybindings

Shortcut	Action
Super + Q	Open Kitty
Super + E	Open Thunar
Super + D	Toggle Vicinae launcher
Super + C	Open Vicinae clipboard history
Super + V	Toggle floating mode
Super + S	Select an area and take a screenshot
Super + L	Lock the session
Super + M	Open the power menu
Super + Shift + X	Close the active window
Super + Shift + H	Hide the active window
Super + Shift + R	Restore the last hidden window
Super + Arrow keys	Move focus between windows
Super + 1…0	Switch workspace
Super + Shift + 1…0	Move a window to another workspace
Super + Left mouse	Move a floating window
Super + Right mouse	Resize a floating window
Super + Space	Switch keyboard layout

Lock and login screens

Hyprlock and SDDM use the same visual language:

• blurred monochrome wallpaper;
• JetBrains Mono Nerd Font;
• clock and date;
• keyboard-layout indicator;
• Caps Lock indicator;
• battery state;
• custom password field.

The lock and login design is retained from the previous release.

Installation

This installer is intended for Arch Linux. Review the repository and hardware-specific options before running it.

Clone the repository:

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

Make the installer executable:

chmod +x install.sh

The installer installs Vicinae from the AUR when paru or yay is available. Without an AUR helper, install vicinae-bin manually before starting Hyprland.

Run the guided installer:

./install.sh

Example for an ASUS ROG laptop with NVIDIA graphics:

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

Install only configuration files:

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

Installer options

--yes             accept default answers
--no-packages         skip repository package installation
--no-aur              skip AUR packages such as Vicinae
--no-sddm             skip the SDDM theme
--no-zsh-framework    skip Oh My Zsh and Powerlevel10k
--set-zsh-default     set Zsh as the login shell
--with-asus           install ASUS/ROG packages
--with-nvidia         install NVIDIA utilities
-h, --help            show installer help

The installer creates timestamped backups before replacing existing configuration files.

Backups are stored in:

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

After installation, log out and enter Hyprland again or reboot the system.

To make Zsh the default login shell:

chsh -s /bin/zsh

Repository structure

.
├── configs
│   ├── fastfetch
│   │   ├── config.jsonc
│   │   └── logos
│   ├── hypr
│   │   ├── hypridle.conf
│   │   ├── hyprland.conf
│   │   ├── hyprlock.conf
│   │   ├── scripts
│   │   ├── kanagawa.jpg
│   │   └── samyray_logo.jpg
│   ├── kitty
│   │   └── kitty.conf
│   ├── quickshell
│   │   └── parzij-shell
│   │       ├── components
│   │       ├── popups
│   │       ├── scripts
│   │       └── shell.qml
│   ├── vicinae
│   │   └── settings.json
│   └── zsh
│       ├── .p10k.zsh
│       └── .zshrc
├── packages
│   ├── core.txt
│   ├── aur.txt
│   ├── optional-asus.txt
│   └── optional-nvidia.txt
├── screenshots
│   └── v2
├── sddm
│   └── jarvis-hyprlock
├── system
├── systemd
├── install.sh
├── LICENSE
└── README.md

Main dependencies

The core desktop uses:

• Hyprland;
• Quickshell;
• Vicinae;
• Hyprlock and Hypridle;
• Kitty;
• Zsh and Powerlevel10k;
• Fastfetch;
• NetworkManager;
• BlueZ;
• PipeWire;
• Playerctl;
• Pamixer;
• Brightnessctl;
• Grim and Slurp;
• Cliphist;
• JetBrains Mono Nerd Font.

Optional hardware-specific dependencies:

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

Hardware-specific configuration

The rice is developed on an ASUS ROG laptop with Intel and NVIDIA graphics.

Some settings may need to be changed on other hardware:

• monitor name, resolution, refresh rate and scale;
• DRM device paths;
• keyboard-backlight device;
• ASUS-specific key codes;
• NVIDIA-related environment variables;
• battery and performance-profile commands.

Review these files before installation:

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

Portable configuration paths

Repository configuration files use:

__HOME__

The installer replaces this value with the actual home directory of the user.

Do not replace __HOME__ manually inside the repository.

Validation

Validate shell scripts:

bash -n install.sh

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

Validate the Quickshell Python backend:

python -m py_compile \
  configs/quickshell/parzij-shell/scripts/backend.py

Check whitespace errors:

git diff --check

Check repository changes before committing:

git status
git diff --stat

Notes

This is a personal daily-driver configuration rather than a universal Arch Linux distribution or unattended installer.

Review all configuration and installation scripts before using them. Hardware-specific settings may require manual adjustment.

License

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

---

Built for Arch Linux with Hyprland, Quickshell and Vicinae.