- QML 87.6%
- Python 7.6%
- GLSL 1.5%
- CSS 0.9%
- JavaScript 0.8%
- Other 1.6%
| .github | ||
| Assets | ||
| Commons | ||
| Helpers | ||
| Modules | ||
| nix | ||
| Scripts | ||
| Services | ||
| Shaders | ||
| Widgets | ||
| .gitignore | ||
| CREDITS.md | ||
| flake.lock | ||
| flake.nix | ||
| lefthook.yml | ||
| LICENSE | ||
| README.md | ||
| shell.nix | ||
| shell.qml | ||
Noctalia shell
quiet by design
What is Noctalia?
A beautiful, minimal desktop shell for Wayland that actually gets out of your way. Built on Quickshell (Qt/QML) with a warm lavender aesthetic that you can easily customize to match your vibe.
✨ Key Features:
- 🪟 Native support for Niri, Hyprland, Sway, Scroll, Labwc and MangoWC
- 🎨 Extensive theming with predefined color schemes and automatic color generation from your wallpaper
- 🖼️ Wallpaper management with Wallhaven integration
- 🔔 Notification system with history and Do Not Disturb
- 🖥️ Multi-monitor support
- 🔒 Lock screen
- 🧩 Desktop widgets (clock, media player and more)
- 💡 OSD for volume and brightness
- 🔌 30+ plugins available (explore plugins)
- 🪄 Setup wizard for first-time users
- ⚡ Built on Quickshell for performance
Preview
https://github.com/user-attachments/assets/bf46f233-8d66-439a-a1ae-ab0446270f2d
Screenshots
📋 Requirements
- Wayland compositor (Niri, Hyprland, Sway, Scroll, MangoWC or labwc recommended)
- Quickshell
- Additional dependencies are listed in our documentation
🚀 Getting Started
New to Noctalia? Check out our comprehensive documentation and installation guide to get up and running!
🖥️ Wayland Compositors
Noctalia provides native support for Niri, Hyprland, Sway, Labwc and MangoWC. Other Wayland compositors may work but could require additional configuration for compositor-specific features like workspaces and window management.
🤝 Contributing
We welcome contributions of any size - bug fixes, new features, documentation improvements, or custom themes and configs.
Get involved:
- Found a bug? Open an issue
- Want to code? Check out our development guidelines
- Need help? Join our Discord
✨ Nix DevShell
Nix users can use the flake's devShell to access a development environment. Run nix develop in the repo root to enter the dev shell. It includes packages, utilities and environment variables needed to develop Noctalia.
⭐ Star History
💜 Credits
A heartfelt thank you to our incredible community of contributors. We are immensely grateful for your dedicated participation and the constructive feedback you've provided, which continue to shape and improve our project for everyone.
☕ Donations
While all donations are greatly appreciated, they are completely voluntary. Thank you to everyone who supports the project! 💜
📄 License
MIT License - see LICENSE for details.