❄️ Onyxshell

A sleek, modular, and dynamic desktop suite for Hyprland — crafted for daily driving with maximum stability, fluid animations, and modern aesthetics.

Features • 1-Line Installation • Keybindings • Customization

---

📸 Screenshots

App Launcher	Control Center
Wallpaper Selector	Wi-Fi Menu

---

✨ Features

• Compositor: Hyprland configured with clean, modular Lua scripts.
• Desktop Shell: Custom Quickshell QtQuick/QML modular suite:
  • 🚀 App Launcher: Fast fuzzy search with desktop categories and keyboard navigation (Alt + Space).
  • 📊 Status Bar: Dynamic workspaces, active window title, system telemetry, clock, and quick tray popups.
  • 📋 Clipboard Manager: Searchable clipboard history with inline image thumbnails (Super + V).
  • 🎛️ Control Center: Quick action toggles, live media controls, volume/brightness sliders, and power grid (Super + M).
  • 🔔 Notification Center & Toast HUD: Interactive notifications with actions, mute toggles, and smooth popup animations (Super + N).
  • 📶 Live Wi-Fi Manager: Scan, select, and connect to Wi-Fi networks directly from the bar.
  • 🖼️ Wallpaper Selector: Visual thumbnail wallpaper gallery with automatic Matugen dynamic palette generation (Super + Shift + W).
  • ⌨️ Keybinds Cheat Sheet HUD: Instant search popup displaying all configured keybindings (Super + /).
• Terminal: Kitty with dropdown terminal scratchpad (Super + Q).
• Shell & Prompt: Fish Shell & Starship Prompt with fuzzy finding (fzf), Matugen live colors, and productivity aliases.
• Wallpaper Engine: Native Quickshell background renderer with fluid animated crossfades and live Matugen theming.
• Dynamic Theming: matugen material color palette extraction synchronized across Quickshell, Hyprland Lua, Kitty, Fish, and desktop components.
• Screen Locker & Idle: hyprlock & hypridle.
• Screenshots: hyprshot with region, window, and full-screen capture (Super + Shift + S).

---

🚀 Installation

⚡ 1-Line Quick Install

Run this single command in your terminal to clone and install 100% of the desktop environment:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/sadid56/onyxshell/main/install.sh)"

Or for automated installation accepting all defaults without prompts:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/sadid56/onyxshell/main/install.sh)" -- --yes

---

📦 Manual Installation

git clone https://github.com/sadid56/onyxshell.git
cd onyxshell
chmod +x install.sh
./install.sh

---

⌨️ Keybindings

Press Super + / at any time inside Hyprland to bring up the interactive Keybinds HUD.

🚀 App Launchers & Menus

Keybinding	Action
Alt + Space	Quickshell App Launcher
Super + Return	Open Terminal (kitty)
Super + Q	Toggle Dropdown Quake Terminal
Super + E	Open File Manager (nautilus)
Super + B	Open Web Browser (firefox)
Super + L	Lock Screen (hyprlock)
Super + /	Show Keybindings Cheat Sheet

---

🎨 Customization & Theming

Changing Wallpapers & Dynamic Colors

• Press Super + Shift + W to open the Wallpaper Selector.
• Select any wallpaper from your ~/Pictures/wallpapers directory.
• matugen will automatically generate harmonized color palettes in .config/quickshell/colors.json, ~/.config/kitty/kitty-colors.conf, and ~/.config/fish/conf.d/matugen_colors.fish in real time.

---

🙏 Credits & Acknowledgements

Note

This configuration and desktop suite is inspired by:

• caelestia-dots / caelestia-shell – Beautiful Quickshell components and design patterns.
• end-4 / dots-hyprland – Incredible Hyprland desktop experience, theming workflows, and aesthetic inspiration.

---

📜 License

This project is licensed under the MIT License.