Hyprland Dotfiles

Hyrpland dotfiles for Arch Linux — Chrome OS style with Material Design 3.

Gallery

Desktop	Lock Screen	App Launcher

Control Center	Notification	Theme Panel

Terminal

Prerequisites

• Arch Linux (or Arch-based distro)
• Hyprland installed
• An AUR helper (yay or paru) is recommended

Installation

git clone https://github.com/cxOrz/dotfiles-hyprland.git
cd dotfiles-hyprland
./install.sh

After installation, log out and start a Hyprland session via greetd.

Post-install

# Set GTK dark theme
gsettings set org.gnome.desktop.interface gtk-theme Material-Black-Blueberry
gsettings set org.gnome.desktop.interface color-scheme prefer-dark

# Enable login manager
sudo systemctl enable greetd

Keybindings

General

Key	Action
Super + Q	Terminal (Kitty)
Super + E	File Manager (Yazi)
Super + Space	App Launcher (Rofi)
Super + X	Close Window
Super + F	Toggle Floating
Super + L	Lock Screen
Super + V	Clipboard History
Super + Escape	Window Switcher
Super + Delete	Power Menu
Super + A	Control Center
Super + Shift + S	Screenshot
Super + Shift + P	Color Picker

Window Management

Key	Action
Super + Arrow Keys	Move Focus
Super + Shift + Arrow Keys	Move Window
Super + Ctrl + Arrow Keys	Resize Window
Super + P	Pseudo Tile
Super + J	Toggle Split

Workspaces

Key	Action
Super + 1-0	Switch to Workspace 1-10
Super + Shift + 1-0	Move Window to Workspace 1-10
Super + Tab	Next Workspace
Super + [ / ]	Previous / Next Workspace
Super + Scroll	Cycle Workspaces

Media

Key	Action
Volume Up/Down/Mute	Audio Control
Brightness Up/Down	Screen Brightness
Media Play/Next/Prev	Playback Control

Directory Structure

.
├── .config/
│   ├── dunst/              # Notification daemon
│   ├── fcitx5/             # Chinese input method
│   ├── hypr/               # Hyprland window manager
│   │   ├── hyprland.conf   #   Main config (keybinds, rules, appearance)
│   │   ├── hyprlock.conf   #   Lock screen
│   │   ├── hyprpaper.conf  #   Wallpaper
│   │   ├── monitors.conf   #   Monitor setup
│   │   └── scripts/
│   ├── kitty/              # Terminal emulator
│   ├── quickshell/         # Custom desktop UI
│   │   ├── modules/
│   │   │   ├── controlcenter/  # WiFi, Bluetooth, Volume, Brightness, Themes
│   │   │   ├── notifications/  # Notification center + toast popups
│   │   │   ├── powermenu/      # Shutdown, Reboot, Suspend, Lock
│   │   │   └── shelf/          # Bottom bar with workspaces
│   │   ├── scripts/        # Theme switching script
│   │   ├── shell.qml       # Main shell entry point
│   │   └── Theme.qml       # Theme definitions (6 themes)
│   ├── rofi/               # App launcher
│   ├── uwsm/               # Wayland session environment
│   ├── waybar/             # Status bar
│   └── yazi/               # File manager
├── .local/share/
│   └── fcitx5/             # Rime config & input themes
├── examples/               # Screenshots
├── install.sh
├── uninstall.sh
├── LICENSE
└── README.md

Dependencies

Full package list

Package	Description
uwsm	Universal Wayland Session Manager
greetd	Login manager
kitty	Terminal emulator
dunst	Notification daemon
quickshell	QML-based desktop shell toolkit
waybar	Wayland status bar
brightnessctl	Screen brightness control
pavucontrol	PulseAudio volume GUI
playerctl	Media player control
pipewire	Audio server
pipewire-pulse	PulseAudio compatibility
pipewire-alsa	ALSA compatibility
wireplumber	PipeWire session manager
hyprpaper	Wallpaper manager
hyprlock	Lock screen
hyprpicker	Color picker
hyprpolkitagent	Authentication agent
feh	Image viewer
grim	Wayland screenshot utility
slurp	Region selector
satty	Screenshot annotation tool
rofi-wayland	Application launcher
wl-clipboard	Wayland clipboard
cliphist	Clipboard history
yazi	Terminal file manager
gtk4	GTK4 (required for Fcitx5 in Chromium)
qt6-wayland	Qt6 Wayland support
qt5-wayland	Qt5 Wayland support
qt6ct	Qt6 theme configuration
seahorse	Password manager GUI
gnome-keyring	Secret/password storage
xdg-desktop-portal-gtk	GTK file picker portal
xdg-desktop-portal-hyprland-git	Hyprland screen sharing portal
ttf-jetbrains-mono-nerd	JetBrainsMono Nerd Font

Optional — Chinese input method:

Package	Description
fcitx5	Input method framework
fcitx5-rime	Rime engine
rime-ice-git	Rime Ice pinyin schema
fcitx5-configtool	Configuration GUI

Chinese Input Method

For Fcitx5 + Rime setup, see .config/fcitx5/README.md.

Uninstall

./uninstall.sh

This removes all symlinks created by the installer. Your backups remain in ~/.dotfiles-backup/. Installed packages are not removed.

License

MIT