A full Hyprland rice with Quickshell, frosted glass Waybar, wallpaper picker, region screenshot/OCR/recording, translucent notification center, and an interactive installer. Quickshell modules are pulled from their own repos (lean, no vendoring).
| Component | Description |
|---|---|
| Hyprland | Lua config (v0.55+) — keybinds, window rules, animations, blur, opacity (Dusky showcase preset, 12 switchable presets in hypr/animations/; minimal fade for quickshell layers, windows sped up) |
| Launcher | One-shot app launcher (SUPER, mylauncher IPC) |
| hypr-lens | Region screenshot, OCR, search, recording — Ali120B/hypr-lens (custom record.sh overlay) |
| Waybar | Frosted glass top bar — workspaces, CPU, RAM, clock, mpris, volume, power button |
| skwd-wall | Wallpaper manager — picker + mixer, images / video / Wallpaper Engine scenes |
| Sung | Native Material 3 music player (auto-installed by install.sh) |
| Rofi | Themed app launcher + keybind cheatsheet viewer |
| Wlogout | Circular button logout screen (shutdown, reboot, logout) |
| Clipse | Clipboard manager with custom pink/blue theme |
| Dunst | Notification daemon (Tokyo Night style) |
| Kitty | Terminal with Material 3 theme |
| Fish + Starship | Interactive shell (abbrs, zoxide, eza) + matugen prompt (power profile, battery) |
| Zsh | Alt interactive shell (same aliases, autosuggestions, history search, starship) |
Add your own screenshots here!
Put screenshots in a screenshots/ folder or link them from an external host.
Suggested: fullscreen desktop, waybar closeup, rofi launcher.
| Key | Action |
|---|---|
SUPER |
App Launcher (mylauncher) |
SUPER + T |
Terminal (Foot) |
SUPER + E |
File Manager (spf in Kitty) |
SUPER + B |
Browser (Zen) |
SUPER + Q |
Close Window |
SUPER + F |
Fullscreen |
SUPER + Space |
Toggle Floating |
SUPER + H/J/K |
Focus (vim-style, arrows for right — L is lock) |
SUPER + SHIFT + H/J/K/L |
Move Window |
SUPER + CTRL + H/J/K/L |
Resize Window |
SUPER + 1-0 |
Switch Workspace |
SUPER + ALT + 1-0 |
Move Window to Workspace |
SUPER + W |
Wallpaper picker (skwd-wall) |
SUPER + SHIFT + W |
Wallpaper mixer (skwd-wall) |
SUPER + V |
Clipboard (Clipse) |
SUPER + SHIFT + S |
Region Screenshot |
SUPER + SHIFT + A |
Region Search |
SUPER + SHIFT + X |
OCR |
SUPER + R |
Screen Record (toggle) |
SUPER + SHIFT + R |
Screen Record with sound |
SUPER + SHIFT + C |
Color Picker |
SUPER + CTRL + W |
Toggle Waybar |
SUPER + N |
Notification History |
SUPER + O |
Opacity Menu (+ blur on/off toggle) |
SUPER + P / right-click on ⏻ |
Step power profile up (saver/balanced/performance + OSD) |
SUPER + L / Tab |
Lock Screen (pauses video wallpaper) |
SUPER + Escape |
Logout Menu |
SUPER + SHIFT + E |
Exit Hyprland |
F1 |
Cheatsheet |
- Arch Linux (or Arch-based distro — installer also supports Fedora/Debian)
- Hyprland v0.55+ (Lua config support)
git
git clone https://github.com/Ali120B/liquidshell.git ~/liquidshell
cd ~/liquidshell
./install.shThe installer will:
- Detect your distro
- Let you choose which components to install
- Install system dependencies (hyprland, waybar, kitty, etc.)
- Download Nerd Fonts (JetBrainsMono, Iosevka, CascadiaCode)
- Back up any existing
~/.config/configs - Deploy everything to the right places
- Replace path placeholders with your actual
$HOME - Register
liquidshellcommand to~/.local/bin/liquidshell
liquidshell update # pull all repos (rice + hypr-lens/Sung) and redeploy (overwrites)
liquidshell update --yes # no prompt
liquidshell status # show rice + app versions~/.config/
├── hypr/ ← hyprland.lua, keybinds.lua, rules.lua, hyprlock.conf, scripts/
├── waybar/ ← config.jsonc, style.css, scripts/
├── quickshell/ ← shell.qml, hyprcheatsheet/ (lean)
│ + external clone: hypr-lens/ (mylauncher vendored)
│ + custom overlay: custom/hypr-lens/record.sh
├── rofi/ ← config.rasi, cheatsheet.rasi, colors.rasi
├── wlogout/ ← layout, style.css, icons/
├── clipse/ ← config.json, custom_theme.json
├── dunst/ ← dunstrc
└── kitty/ ← kitty.conf, current-theme.conf
If you prefer not to use the installer:
- Clone the repo
- Copy each folder to
~/.config/ - Edit
wlogout/style.cssand replace__HOME__with your actual home path - Make scripts executable:
chmod +x ~/.config/hypr/scripts/*.sh
Wallpapers are handled by skwd-wall
(images + video + Wallpaper Engine scenes), running as the user service
skwd-walld. It restores the last wallpaper on login by itself.
SUPER+W— picker (skwd-wall-v2)SUPER+SHIFT+W— mixer, opened directly (skwd-wall-v2 --mixer)- Library default is
~/Pictures/Wallpapers(change in Settings > Sources); videos in~/Pictures/Livewall/apply fine too, e.g.skwd-helm apply ~/Pictures/Livewall/mist-over-the-pines.1920x1080.mp4 - Pause/resume video wallpapers:
skwd-helm pause/skwd-helm resume
The old hyprquickpaper / hyprquickpaper-live pickers and the
awww+mpvpaper helpers are fully removed (recoverable from git history
if ever needed).
Wallpaper-driven theming: hypr/scripts/wallpaper-theme.sh --watch runs at
login, recolors Hyprland borders live (hyprctl eval, no reload) and
regenerates ~/.config/waybar/colors.css (matugen palette) on every
wallpaper change, then reloads waybar. Run
hypr/scripts/wallpaper-theme.sh --current to re-theme on demand.
Locking (SUPER+L / SUPER+Tab, idle lock) pauses video wallpapers and resumes on
unlock via hypr/scripts/lock.sh.
Before hyprctl reload, run hypr/scripts/check-config.sh — it type-checks
the Lua (luac), lint-checks the scripts (bash -n), validates waybar's
config.jsonc and flags duplicate keybinds. install.sh runs it (repo
scope) before deploying anything.
install.sh keeps liquidshell lean — hypr-lens (mylauncher vendored) are cloned from their own repos, not vendored. Only hyprcheatsheet and shell.qml plus tiny custom overlays (e.g. custom/hypr-lens/record.sh) stay in-repo. Re-run install.sh or liquidshell update to git pull them.
Edit hypr/hyprland.lua to change:
- Monitor resolution/refresh rate (line ~10)
- Default terminal, browser, file manager (line ~25)
- Appearance: gaps, border, rounding, blur, opacity (lines ~80-110)
Full package list
Core:
hyprland hyprlock hypridle hyprpaper hyprpicker waybar wlogout rofi-wayland dunst kitty foot clipse wl-clipboard ffmpeg socat wf-recorder satty swappy tesseract tesseract-data-eng brightnessctl playerctl hyprpolkitagent qt6ct qt6-wayland kvantum adw-gtk3-theme grim slurp NetworkManager-applet jq imagemagick curl unzip python3
Quickshell (install separately):
quickshell material-symbols-ttf noto-fonts
Fonts:
JetBrainsMono Nerd Font Iosevka Nerd Font CaskaydiaCove Nerd Font Noto Sans Material Symbols Rounded
Hyprland won't start / crashes on login:
- Ensure you're running Hyprland v0.55+ (Lua config support)
- Check
hyprlandis in your PATH
Quickshell won't launch:
- Install quickshell separately (AUR:
quickshell-bin) - Install required fonts
Wallpaper picker shows "Caching":
- First run generates thumbnails — give it a moment
- Ensure
imagemagick(convert) is installed
Waybar is transparent / invisible:
- The bar is intentionally transparent (frosted glass effect)
- It becomes visible when apps are below it
- Hyprland
- Quickshell
- hypr-lens
- skwd-wall
- Dusky — hyprlock 001_dusky theme + matugen hyprlock-colors template + window animation presets (adapted paths only)
- Nerd Fonts
MIT