---

🌙 A quiet, moonlit Hyprland environment

Wallpaper collection

Caution

Matugen is required.
Moonveil relies on dynamic color generation and will not function correctly without it.

Project Note

Moonveil previously experimented with the Ax-Shell bar component only.
The rest of the environment, configuration, and workflow are original and independently maintained. Ax-Shell has since been officially discontinued and archived.
Moonveil now ships with its own maintained bar implementation (Moonshell) and does not depend on Ax-Shells-Bar.

---

✨ Features

• Clean, distraction-free layout
• Poetic and minimal design language
• Subtle, smooth animations
• Matugen & fabric-powered dynamic colors
• Carefully tuned keybindings
• Easy to extend and customize

---

Screenshots

---

Installation

Arch Linux (AUR)

curl -fsSL https://raw.githubusercontent.com/notcandy001/Moonveil/master/install.sh | bash

Required Packages

📦 Dependencies

Moonveil relies on a small, intentional set of tools.
Install the following packages for the setup to work as intended.

📦 Pacman Packages

Core

• Hyprland – Wayland compositor
• Waybar – Status bar
• Rofi – Application launcher
• Hyprlock – Lock screen
• Wlogout – Logout / power menu
• SwayNC – Notification center
• gnome-bluetooth-3.0
• vte3
• imagemagick

Shell & CLI

• Zsh – Default shell
• power-profiles-daemon

Utilities

• Grim – Screenshot utility
• Nautilus – File manager
• Pavucontrol – Audio control

Theming & Appearance

• LXAppearance – GTK theme manager

Python Dependencies

• python
• python-gobject
• python-psutil
• python-watchdog
• python-pillow
• python-toml
• python-ijson
• python-numpy
• python-requests

Fonts

• JetBrainsMono Nerd Font
• Noto Fonts Emoji
• Noto Fonts CJK

---

📦 Yay (AUR) Packages

Core

• Matugen – Dynamic color generation (required)
• python-fabric-git
• fabric-cli
• python-setproctitle
• gray

Shell & CLI

• Oh My Zsh – Zsh framework
• Powerlevel10k – Zsh prompt theme
• Eza – Modern ls replacement

Theming & Appearance

• adw-gtk-theme – GTK theme
• Bibata Modern Ice – Cursor theme

Fonts

• Geist Mono (OTF) – Primary UI & terminal font
• Geist Mono Nerd Font – Icon support
• PP Neue Machina – Display / clock font

---

📝 Notes

• Run fc-cache -fv after installing fonts
• PP Neue Machina may require manual installation
• Matugen should be integrated with Hyprland, Waybar, GTK & Rofi

Package Management

• yay – AUR helper

⚠️ Without Matugen, colors and accents will not update dynamically.

---

Roadmap

• Hyprland
• Hyprlock
• Rofi
• Waybar
• SwayNC
• Wlogout
• Calendar
• Clipboard Manager
• Emoji Picker
• Color Picker
• Customizable UI
• More polish
• Better scripts
• Additional themes
• Documentation improvements

Special Thanks to

• Hyprland Community Thanks to the Hyprland maintainers and contributors for creating and maintaining an outstanding Wayland compositor.

• Wayland Contributors Appreciation to the Wayland developers and contributors for providing the foundation for modern Linux desktops.

• aadritobasu Huge thanks to for Akaris Jsonc I’ve yanked parts of it.