A beautiful, minimal desktop shell for Wayland that actually gets out of your way. Built on Quickshell with a warm lavender aesthetic that you can easily customize to match your vibe.

Preview

https://github.com/user-attachments/assets/72c6d6dc-48b0-48a0-bd8b-c7e70990edc4

Screenshots

⚠️ BREAKING CHANGE ⚠️

With the release of v3.0.0 we introduced a small breaking change. This is solely for niri users, we reworked how we handle the wallpaper & overview. Please read the docs to adapt your niri config.

🚀 Getting Started

New to Noctalia?
Check out our documentation & installation guide to get started!

Need help? Join our Discord community or browse the FAQ.

🖥️ Wayland Compositors

Noctalia provides native support for Niri, Hyprland and Sway. Other Wayland compositors will work but may require additional workspace logic configuration.

🤝 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 (new)

Nix users can use the flake's devShell to access a development environment. Run nix develop the repo root to enter the dev shell. It includes packages, utilities and environment variables needed to develop Noctalia.

💜 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 💜!

Gohma
DiscoCevapi
PikaOS
LionHeartP
Nyxion ツ
RockDuck
MrDowntempo
Tempus Thales
Raine
JustCurtis

📄 License

MIT License - see LICENSE for details.

Languages

QML 92.1%

JavaScript 2.4%

Shell 1.9%

GLSL 1.5%

Emacs Lisp 0.8%

Other 1.3%