Skip to content

About

A full Hyprland rice with frosted glass Waybar, wallpaper picker, hypr-lens, and an interactive installer

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

77 Commits

Folders and files

Repository files navigation

LiquidShell

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).

Hyprland Quickshell License


What's Inside

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)

Screenshots

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.

Keybinds

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

Installation

Prerequisites

  • Arch Linux (or Arch-based distro — installer also supports Fedora/Debian)
  • Hyprland v0.55+ (Lua config support)
  • git

Quick Start

git clone https://github.com/Ali120B/liquidshell.git ~/liquidshell
cd ~/liquidshell
./install.sh

The installer will:

  1. Detect your distro
  2. Let you choose which components to install
  3. Install system dependencies (hyprland, waybar, kitty, etc.)
  4. Download Nerd Fonts (JetBrainsMono, Iosevka, CascadiaCode)
  5. Back up any existing ~/.config/ configs
  6. Deploy everything to the right places
  7. Replace path placeholders with your actual $HOME
  8. Register liquidshell command to ~/.local/bin/liquidshell

Update

liquidshell update        # pull all repos (rice + hypr-lens/Sung) and redeploy (overwrites)
liquidshell update --yes  # no prompt
liquidshell status        # show rice + app versions

What Gets Installed

~/.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

Manual Installation

If you prefer not to use the installer:

  1. Clone the repo
  2. Copy each folder to ~/.config/
  3. Edit wlogout/style.css and replace __HOME__ with your actual home path
  4. Make scripts executable: chmod +x ~/.config/hypr/scripts/*.sh

Configuration

Wallpaper (skwd-wall)

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.

Config validation

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.

Quickshell externals

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.

Display Settings

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)

Dependencies

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


Troubleshooting

Hyprland won't start / crashes on login:

  • Ensure you're running Hyprland v0.55+ (Lua config support)
  • Check hyprland is 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

Credits


License

MIT

About

A full Hyprland rice with frosted glass Waybar, wallpaper picker, hypr-lens, and an interactive installer

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages