An aesthetic, modern, and fluid Hyprland desktop environment configured for Fedora and Linux. Built with a macOS-inspired experience: natural gestures, smooth window animations, dynamic wallpaper-extracted color theming, and a floating glassmorphism status bar.
- Compositor: Hyprland with native Lua configuration (
hyprland.lua). - Dynamic Theming: Automatically extracts color palettes from your active wallpaper to theme Waybar and Wofi.
- Status Bar: Waybar with floating pill modules, live download/upload network bandwidth, battery health, volume, brightness, clock, settings, and system tray.
- Spotlight Launcher: Wofi redesigned with a macOS Spotlight aesthetic: centered modal, border-only active highlights, no scrollbars, and background blur/dimming.
- macOS-like Gestures:
- Natural 2-finger scrolling and tap-to-click.
- 3-Finger horizontal swipe for fluid 1:1 workspace switching.
- 4-Finger swipe up to instantly switch wallpapers with animated transitions.
- Window Controls: Dedicated Maximize (
SUPER + M), True Fullscreen (SUPER + F), and Minimize to Magic Tray (SUPER + H/SUPER + S). - Wallpaper Chooser: Custom GTK3 Layer-Shell wallpaper picker with two-column layout, real-time right-panel image preview, and live desktop preview sync.
- Global Font Scaling: Dynamic font and scaling controller (
fontsize.sh) to easily adjust UI size across GTK, Waybar, Wofi, and notifications. - Notifications: Mako styled to match the dark glass aesthetic.
- Snipping Tool: Area screenshot straight to clipboard via the physical
Print(PrtSc) key.
| Shortcut | Action |
|---|---|
SUPER or SUPER + Space or SUPER + R |
Toggle App Launcher (Wofi Spotlight) |
SUPER + I or SUPER + , |
Settings & Preferences Hub (Theme Accent Color, Glass Blur, Wallpaper, Font Size, Wi-Fi, Audio) |
SUPER + Q |
Open Terminal (kitty) |
SUPER + E |
Open File Manager (nautilus) |
SUPER + W |
Interactive Wallpaper Picker (live preview card on the right, live background sync, press again to cancel) |
SUPER + Shift + W |
Cycle Next Wallpaper |
SUPER + N |
Interactive Wi-Fi / Network Dropdown (or click Network pill on Waybar) |
SUPER + B |
Glass / Blur Theme Switcher (Liquid, Frosted, Crystal, Deep, Off) |
Print (PrtSc) |
Area Screenshot to clipboard (press again or Escape to cancel) |
| Shortcut | Action |
|---|---|
SUPER + Tab |
Visual window switcher (Rofi window modal) |
SUPER + C |
Close active window |
SUPER + M |
Maximize window (keeps top status bar) |
SUPER + F |
True Fullscreen |
SUPER + V |
Toggle floating mode |
SUPER + J |
Toggle split layout |
SUPER + Arrow Keys |
Move window focus |
SUPER + Mouse Drag |
Smart Drag Window: Drag across screen, drag to left/right edge to shift workspaces, or drop onto top status bar workspace buttons (1-5)! |
SUPER + Shift + Left / Right |
Move active window to previous / next workspace |
| Shortcut | Action |
|---|---|
ALT + Tab |
Cycle forward between workspaces |
ALT + Shift + Tab |
Cycle backward between workspaces |
SUPER + 1-9 |
Switch to Workspace 1-9 |
SUPER + Shift + 1-9 |
Move active window to Workspace 1-9 |
SUPER + Scroll Up / Down |
Scroll through workspaces |
SUPER + Left Click Drag to Edge |
Drag window to left edge to move to next workspace (ws + 1) or right edge for previous (ws - 1) |
SUPER + Drop onto Status Bar |
Drop dragged window onto workspace button (1-5) on Waybar to place it there |
SUPER + Escape |
Exit session / Power menu |
- 2-Finger Scroll: Natural scrolling (content moves with your fingers, macOS style).
- 3-Finger Swipe (Left / Right): Fluid, animated 1:1 workspace switching. Continuous scrolling enabled—swipe through existing workspaces or seamlessly into a fresh new workspace if no apps are there!
- Wallpaper Switching: Press
SUPER + Wto select from the live preview picker, orSUPER + Shift + Wfor the next wallpaper.
Clone this repository and run the automated installer:
git clone https://github.com/Adams-404/cryo-hypr.git ~/dotfiles
cd ~/dotfiles
./install.shThe installer will:
- Detect your package manager (
dnforpacman) and install required packages & fonts. - Back up any existing configs to
~/.config_backup_<timestamp>. - Create live symlinks from
~/.config/{hypr,waybar,wofi,mako}directly to~/dotfiles/. - Make all scripts executable and reload Hyprland live.
~/dotfiles/
├── hypr/
│ ├── hyprland.lua # Main Hyprland Lua configuration
│ └── scripts/
│ ├── autostart.sh # Boot lifecycle daemon manager
│ ├── settings.sh # Unified Settings & Preferences hub
│ ├── theme_color.sh # Theme accent color selector (manual or auto)
│ ├── fontsize.sh # Global font scaling controller
│ ├── glass.sh # Glassmorphism & blur level switcher (persistent)
│ ├── wifi.sh # Interactive Wi-Fi manager
│ ├── screenshot.sh # PrtSc area screenshot with cancel toggle
│ ├── menu.sh # Toggleable launcher script
│ ├── wallpaper.sh # Wallpaper rotator and picker launcher
│ ├── wallpaper_picker.py # Modern GTK3 layer-shell wallpaper chooser with preview
│ └── extract_colors.py # Wallpaper color extractor (PIL)
├── waybar/
│ ├── config.jsonc # Modular status bar layout & network speeds
│ ├── style.css # Glassmorphism pill styling
│ └── colors.css # Dynamic wallpaper palette
├── wofi/
│ ├── config # Spotlight modal configuration
│ ├── style.css # Border-only active state & no scrollbars
│ └── colors.css # Dynamic wallpaper palette
├── mako/
│ └── config # Dark glass notification theme
├── rofi/
│ └── config.rasi # Modern window switcher modal
├── install.sh # Automated multi-distro setup script
├── AGENT.md # Mandatory AI maintenance guidelines
└── README.md # Documentation & keybinding guide
Simply drop any .png, .jpg, or .jpeg images into your ~/Pictures/Wallpapers folder:
cp your_image.png ~/Pictures/Wallpapers/Press SUPER + W to pick it from the interactive live preview chooser, or swipe 4 fingers up on your trackpad to cycle through your wallpapers!