X Hyprland

QuickShell QML shell + Matugen dynamic theming for Hyprland on X.

Content

Quick Install · Features · Customization · Quick Reference · Structure · Documentation · Acknowledgments · X

Gif preview, follow the link to see the video.

Old Previews

---

Quick Install

git clone https://github.com/xscriptor/hyprland.git
cd hyprland
chmod +x install.sh
./install.sh

Options: --dotfiles-only (config only), --nvidia-only (NVIDIA setup only).

The installer detects your distro and GPU, installs packages (Hyprland, QuickShell, Matugen, SwayOSD, kitty, rofi, and more), backs up existing configs, deploys all dotfiles, optionally configures NVIDIA Optimus, installs the SDDM theme, and generates initial colors from your wallpaper.

---

Features

• QuickShell QML UI -- App launcher, clipboard, calendar/weather, network, audio, battery, music (MPRIS), wallpaper picker, system monitor, RSS reader, file search, quick notes, focus timer, screen recording, QR scanner.
• Matugen Dynamic Theming -- Colors extracted from wallpaper, applied to Hyprland, Kitty, Neovim, Cava, SwayOSD, GTK, Qt, SDDM.
• Modular Config -- Split across focused files. Template-based reload from settings.json.
• NVIDIA Optimus -- GPU mode switching (integrated/hybrid/nvidia) via keybind or Rofi.
• Multi-Monitor -- Workspace binding, Rofi-based position/resolution/refresh rate manager.
• SDDM Theme -- matugen-minimal with Matugen colors and wallpaper blur.
• Screen Recording -- GPU capture with separate desktop/mic audio channels.
• Neovim Config -- lazy.nvim, LSP (Mason), Treesitter, custom themes with Matugen colors.

---

Customization

SUPER + W wallpaper picker · SUPER + SHIFT + S settings panel (scale, language, startup) · SUPER + SHIFT + B window effects (opacity, blur, rounding)

See Hyprland Config for file structure, Quick Reference for all keybinds, and Widgets for widget details.

---

Quick Reference

SUPER + Return Terminal · SUPER + D Apps · SUPER + W Wallpaper · SUPER + S Calendar · SUPER + Space Float · SUPER + L Lock · Print Screenshot · SUPER + Escape Exit

See full keybinding table.

---

Structure

hyprland/
  install.sh                  Automated installer
  uninstall.sh                Config removal
  config/hypr/                Hyprland modular configs + QuickShell QML widgets
  config/kitty/               Terminal config + Matugen colors
  config/rofi/                Launcher themes
  config/dunst/               Notification daemon
  config/cava/                Audio visualizer
  config/hypridle/            Idle management (dim, lock, suspend)
  config/matugen/             Matugen templates for all apps
  config/sddm/                SDDM login theme (matugen-minimal)
  config/nvim/                Neovim config with lazy.nvim
  scripts/                    Shell scripts and daemons
  assets/previews/            Screenshots

---

Documentation

• Installation -- Full install, uninstall, and post-install guide
• Quick Reference -- All keybindings, widgets, and scripts at a glance
• QuickShell Widgets -- Widget architecture, IPC system, and QML components
• Scripts -- All shell scripts and daemons
• Hyprland Configuration -- Modular config structure and dynamic reload
• Matugen Integration -- Dynamic color pipeline
• Screenshots & Recording -- Capture system with virtual audio
• Neovim Configuration -- Included editor setup
• Multi-Monitor Setup -- Display configuration guide
• GPU Mode Switching -- NVIDIA Optimus control

License · Code of Conduct · Roadmap · Changelog · Security

Related Repos

• Terminal
• Nvim
• Jetbrains
• VSCode
• Obsidian
• XFetch

X

Based on imperative-dots by ilyamiro -- adapted, extended, and customized

& &