noctalia-shell/README.md
2025-07-11 14:14:28 +02:00

6.7 KiB

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 indicators, power profiles, lockscreen, tray, workspaces, and more — all styled with a warm lavender palette.

Preview

Click to expand preview images

Main

Control Panel

Applauncher



⚠️ 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 performance and battery modes.
  • 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
#0C0D11 Background Primary — Deep indigo-black
#151720 Background Secondary — Slightly lifted dark
#1D202B Background Tertiary — Soft contrast surface
#1A1C26 Surface — Material-like base layer
#2A2D3A Surface Variant — Lightly elevated
#CACEE2 Text Primary — Gentle off-white
#B7BBD0 Text Secondary — Muted lavender-blue
#6B718A Text Disabled — Dimmed blue-gray
#A8AEFF Accent Primary — Light enchanted lavender
#9EA0FF Accent Secondary — Softer lavender hue
#8EABFF Accent Tertiary — Warm golden glow (from lantern)
#FF6B81 Error — Soft rose red
#FFBB66 Warning — Candlelight amber-orange
#E3C2FF Highlight — Bright magical lavender
#F3DEFF Ripple Effect — Gentle soft splash
#1A1A1A On Accent — Text on accent background
#44485A Outline — Subtle bluish-gray line
#000000B3 Shadow — Standard soft black shadow
#11121ACC Overlay — 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

Open Applauncher:

 qs ipc call globalIPC toggleLauncher

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


Known issues

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


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.