Noctalia

quiet by design

A sleek, minimal, and thoughtfully crafted setup for Wayland using Quickshell. This setup includes a status bar, notification system, control panel, wifi & bluetooth support, power profiles, lockscreen, tray, workspaces, and more — all styled with a warm lavender palette.

Preview

Click to expand preview images

---

⚠️ Note:
This setup currently requires Niri as your compositor, mainly due to its custom workspace indicator integration. However if you want, you can just adapt the Workspace.qml to your own compositor.

---

Features

• Status Bar: Modular and informative with smooth animations.
• Notifications: Non-intrusive alerts styled to blend naturally.
• Control Panel: Centralized system controls for quick adjustments.
• Connectivity: Easy management of WiFi and Bluetooth devices.
• Power Profiles: Quick toggles for CPU performance.
• Lockscreen: Secure and visually consistent lock experience.
• Tray & Workspaces: Efficient workspace switching and tray icons.
• Applauncher: Stylized Applauncher to fit into the setup.

---

Theme Colors

Color Role	Color	Description
Background Primary	#0C0D11	Deep indigo-black
Background Secondary	#151720	Slightly lifted dark
Background Tertiary	#1D202B	Soft contrast surface
Surface	#1A1C26	Material-like base layer
Surface Variant	#2A2D3A	Lightly elevated
Text Primary	#CACEE2	Gentle off-white
Text Secondary	#B7BBD0	Muted lavender-blue
Text Disabled	#6B718A	Dimmed blue-gray
Accent Primary	#A8AEFF	Light enchanted lavender
Accent Secondary	#9EA0FF	Softer lavender hue
Accent Tertiary	#8EABFF	Warm golden glow
Error	#FF6B81	Soft rose red
Warning	#FFBB66	Candlelight amber-orange
Highlight	#E3C2FF	Bright magical lavender
Ripple Effect	#F3DEFF	Gentle soft splash
On Accent	#1A1A1A	Text on accent background
Outline	#44485A	Subtle bluish-gray line
Shadow	#000000B3	Standard soft black shadow
Overlay	#11121ACC	Deep bluish overlay

---

Installation & Usage

Installation

Install quickshell:

yay -S quickshell-git

or use any other way of installing quickshell-git (flake, paru etc).

Git clone the repo:

git clone https://github.com/Ly-sec/Noctalia.git

Move content to ~/.config/quickshell

cd Noctalia && mv * ~/.config/quickshell/

Usage

Start quickshell:

qs

(If you want to autostart it, just add it to your niri configuration.)

Settings:

To make the weather widget, wallpaper manager and record button work you will have to open up the settings menu in to right panel (top right button to open panel) and edit said things accordingly.

Keybinds

Toggle Applauncher:

 qs ipc call globalIPC toggleLauncher

Toggle Lockscreen:

qs ipc call globalIPC toggleLock

You can keybind it however you want in your niri setup.

---

Dependencies

You will need to install a few things to get everything working:

• qt6-5compat for some graphical effects
• cava so the audio visualizer works
• gpu-screen-recorder so that the record button works
• xdg-desktop-portal-gnome or any other xdg-desktop-portal
• material-symbols-git so the icons properly show up
• swww to add fancy wallpaper animations (optional)
• wallust to theme the setup based on wallpaper (optional)

zigstat is bundled - source can be found here.

Known issues

Currently the brightness indicator is very opiniated (using ddcutil with a script to log current brightness). This will be fixed asap!

---

💜 Credits

Huge thanks to @ferrreo for all the changes they did and all the cool features they added!

---

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

---

License

This project is licensed under the terms of the MIT License.