https://github.com/noctalia-dev/noctalia-shell
A sleek and minimal desktop shell thoughtfully crafted for Wayland.
https://github.com/noctalia-dev/noctalia-shell
dotfiles hyprland linux niri noctalia quickshell rice
Last synced: about 2 months ago
JSON representation
A sleek and minimal desktop shell thoughtfully crafted for Wayland.
- Host: GitHub
- URL: https://github.com/noctalia-dev/noctalia-shell
- Owner: noctalia-dev
- License: mit
- Created: 2025-07-11T10:50:50.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-05T22:22:01.000Z (6 months ago)
- Last Synced: 2025-10-05T22:25:07.230Z (6 months ago)
- Topics: dotfiles, hyprland, linux, niri, noctalia, quickshell, rice
- Language: QML
- Homepage: https://docs.noctalia.dev/docs/
- Size: 34.1 MB
- Stars: 586
- Watchers: 4
- Forks: 70
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-niri - Noctalia - A sleek and minimal desktop shell thoughtfully crafted for niri and Hyprland, built with Quickshell. (Custom Shells)
- my-awesome-github-stars - noctalia-dev/noctalia-shell - A sleek and minimal desktop shell thoughtfully crafted for Wayland. (QML)
README
# 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 with a warm lavender aesthetic that you can easily customize to match your vibe.
**✨ Key Features:**
- 🪟 Native support for Niri, Hyprland, Sway, MangoWC and labwc
- ⚡ Built on Quickshell for performance
- 🎯 Minimalist design philosophy
- 🔌 Plugin support ([explore plugins](https://noctalia.dev/plugins/))
- 🔧 Easily customizable to match your style
- 🎨 Many color schemes available
---
## Preview
https://github.com/user-attachments/assets/bf46f233-8d66-439a-a1ae-ab0446270f2d
Screenshots






---
## 📋 Requirements
- Wayland compositor (Niri, Hyprland, Sway, MangoWC or labwc recommended)
- Quickshell
- Additional dependencies are listed in our [documentation](https://docs.noctalia.dev)
---
## 🚀 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** 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](https://github.com/noctalia-dev/noctalia-shell/issues/new)
- **Want to code?** Check out our [development guidelines](https://docs.noctalia.dev/development/guideline)
- **Need help?** Join our [Discord](https://discord.noctalia.dev)
### ✨ 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.
---
## 💜 Credits
A heartfelt thank you to our incredible community of [**contributors**](https://github.com/noctalia-dev/noctalia-shell/graphs/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
* Eynix
* MrDowntempo
* Tempus Thales
* Raine
* JustCurtis
* llego
* Grune
* Maitreya (Max)
* sheast
* Radu
---
## 📄 License
MIT License - see [LICENSE](./LICENSE) for details.