mshell dots - Hyprland Rice

August 31, 2026 · View on GitHub

This was made on a 1920x1080 display

Video showcasing the animations

https://github.com/mel-edo/awesome-setup/assets/90543784/25acfe82-682d-4f04-9ef8-c2461703d929

Window Manager: Hyprland
Terminal: alacritty
Shell: zsh
Desktop shell / bar: Quickshell
Color theming: matugen
System fetch: fastfetch
Cursor theme: catppuccin-dark
Folder theme: Papirus with Catppuccin folder colors
GTK theme: catppuccin
QT theme: catppuccin with kvantum

Configuration you need to change

This rice is tuned to my machine. You'll want to edit these.

File	What to change
`config/quickshell/mshell/scripts/calendar/weather.sh`	`API_KEY` and `CITY`. Get from openweathermap.org
`config/hypr/settings.json` → `wallpaperDir`	Add path to your wallpaper dir. Wallpaper picker looks in your wallpaper dir by default and also picks up Wallpaper Engine wallpapers if you have those.
`config/hypr/hyprland.lua` → `hl.monitor(...)`	`output = ""`, `mode = "1920x1080@120"`
`config/hypr/hyprland.lua` → env vars	`NVD_BACKEND`, `LIBVA_DRIVER_NAME`, `__GLX_VENDOR_LIBRARY_NAME`. Modify according to your hardware
`config/hypr/hypridle.conf`	Modify lock, suspend timers

Install Instructions

Required programs

(For yay on Arch Linux)

yay -S --needed hyprland hypridle hyprpicker quickshell-git matugen cava awww grim slurp wl-clipboard tesseract playerctl brightnessctl

Optional Programs

copyq, hyprsunset, fastfetch, mpv, polkit-gnome, pokemon-colorscripts-git, gpu-screen-recorder, catppuccin-cursors-mocha, catppuccin-gtk-theme-mocha

Manual method

git clone -b Hyprland https://github.com/mel-edo/awesome-setup mshell-dots
Backup your ~/.config folder (or create it if it doesn't exist)
cp -r ~/mshell-dots/config/* ~/.config
cp -r ~/mshell-dots/fonts/* ~/.local/share/fonts
fc-cache -v -f
cp ~/mshell-dots/.zprofile ~/mshell-dots/.zshrc ~/
Go through Configuration you need to change above before launching
mshell launches automatically via Hyprland's autostart. Run it manually using launch script - ~/.config/quickshell/mshell/launch.sh

Autostart

Runs on Hyprland startup. Change as you wish

dbus-update-activation-environment
polkit-gnome auth agent
hyprsunset -t 5000
hypridle
awww-daemon
discord, zen-browser
kdeconnect-indicator
launch.sh - Starts the Quickshell desktop shell
Applies catppuccin-mocha-dark-cursors

Keybinds

mainMod = SUPER

Keybind	Action
`SUPER + Return`	Open terminal (alacritty)
`SUPER + Q`	Close window
`SUPER + F`	Toggle fullscreen
`SUPER + E`	Open file manager (nemo)
`SUPER + Space`	Toggle floating, resize + center
`ALT + Tab`	Cycle to next window / bring to top
`SUPER + A`	Toggle launcher
`SUPER + Escape`	Toggle power menu
`SUPER + W`	Toggle overview
`SUPER + L`	Lock screen
`SUPER + Z` / `SUPER + X`	Kill / relaunch quickshell
`SUPER + 1–8`	Focus workspace 1–8
`SUPER + Shift + 1–8`	Move window to workspace 1–8
`SUPER + S` / `SUPER + Shift + S`	Toggle special workspace / move window to it
`SUPER + mouse:272 / mouse:273`	Drag / resize window using left and right click
`Next` (PgDn) / `F12`	Screenshot region → saved + copied to clipboard
`Shift + Next` / `Shift + F12`	OCR screenshot region → copied to clipboard (tesseract)
`Shift + Alt + 0`	Toggle screen recording (`gsr-toggle.sh`)
`SUPER + V`	Toggle clipboard manager (copyq)
`SUPER + P`	Color picker (hyprpicker)
`SUPER + N` / `SUPER + Ctrl + N`	Minimize / restore last window niflveil
`SUPER + Up/Down` or volume keys	Volume +/- 5%
`SUPER + Left/Right` or brightness keys	Brightness +/- 5%
`XF86Audio(Mute/MicMute)`	Toggle mute / mic mute
`XF86Audio(Next/Prev/Play/Pause)`, `Prior`, `F11`	Media controls (playerctl)
`XF86Calculator`	Open galculator
`SUPER + scroll`	Adjust cursor zoom
3-finger swipe horizontal	Switch workspace
3-finger swipe down / up	Minimize / restore niflveil
4-finger swipe down	Close window
4-finger swipe up	Toggle launcher

niflveil is a window-minimizer for Hyprland by Mauitron, not included in this repo. It needs to be built and installed separately:
git clone https://github.com/Mauitron/NiflVeil.git
cd NiflVeil/niflveil
cargo build --release
sudo cp target/release/niflveil /usr/local/bin/
Go through it's repo for more info!

Window & layer rules

App / match	Behavior
zen (browser)	→ workspace 1 (silent)
discord	→ workspace 2 (silent)
Obsidian	→ workspace 3 (silent)
codium, steam	→ workspace 4 (silent)
youtube-music	→ workspace 5 (silent)
PrismLauncher, twintaillauncher, Lutris	→ workspace 6 (silent), floating & centered
Betterbird	→ workspace 7 (silent)
yad, copyq, nm-connection-editor, pavucontrol, blueberry, file-roller, Godot, qBittorrent	Floating, fixed size, centered
Picture-in-Picture windows	Floating, pinned to position (1280, 35)
"Friends List" (Steam)	Floating
Empty-class/title XWayland floats	No focus (suppresses stray ghost windows)
All windows	Maximize event suppressed
`quickshell:expose` layer	Blurred + dimmed background
`quickshell:*` layers, `selection` layer	No animation