feat(noctalia): Migrate to Noctalia

README.md

@@ -23,10 +23,6 @@ It follows a structure to keep related configurations together, but not too much
 ```bash
 # On fresh systems
 nix develop
-
-# Dedicated devshell targets
-switch-zion
-switch-firefly
 ```
 
 <details>
@@ -49,9 +45,6 @@ nix build .#nixosConfigurations.vinox.config.system.build.isoImage
 nh os boot --hostname kubex . -d always --target-host kubex
 nh os boot --hostname nixberry . -d always --target-host <IP>
 
-# nix remote switch
-nixos-rebuild switch --flake .#kubex --target-host 192.168.55.10 --sudo
-
 # enable experimental-features
 export NIX_CONFIG="experimental-features = nix-command flakes"
 # OR
@@ -80,6 +73,7 @@ sudo nixos-install --flake .#zion
 
 - [Gaming and Battle.net](./docs/guides/gaming.md)
 - [Hyprland - Keymap](./docs/reference/hyprland.md#keymap)
+- [Noctalia shell](./docs/reference/noctalia.md)
 - [NVIM - Keymap](https://github.com/RAPSNX/neonix/tree/main/docs/keymap.md)
 
 ## Licenses

dev-shells.nix

@@ -12,35 +12,60 @@ let
       deadnix.enable = true;
     };
   };
-
-  # Makefile like targets
-  switch-firefly = pkgs.writeShellScriptBin "switch-firefly" ''
-    NIX_CONFIG="experimental-features = nix-command flakes" \
-      nh home switch -c nix@firefly . --show-activation-logs
-  '';
-
-  switch-zion = pkgs.writeShellScriptBin "switch-zion" ''
-    nh os switch && nh home switch
-  '';
+  mkTargets = t: builtins.mapAttrs (name: script: pkgs.writeShellScriptBin name script) t;
 in
 {
   default = pkgs.mkShell {
     inherit (pre-commit-check) shellHook;
 
-    packages = builtins.attrValues {
-      inherit (pkgs)
-        nh
-        statix
-        deadnix
-        nixfmt
-        nix-inspect
-        nix-tree
-        ;
-
-      inherit
-        switch-firefly
-        switch-zion
-        ;
-    };
+    packages = builtins.attrValues (
+      {
+        inherit (pkgs)
+          nh
+          statix
+          deadnix
+          nixfmt
+          nix-inspect
+          nix-tree
+          ;
+      }
+      // mkTargets {
+        check = "nix flake check";
+
+        sw-zion = ''
+          nh os switch && nh home switch
+        '';
+
+        swh-zion = ''
+          nh home switch
+        '';
+
+        swo-zion = ''
+          nh os switch
+        '';
+
+        sw-fly = ''
+          nh home switch -c nix@firefly . --show-activation-logs
+        '';
+
+        bld-fly = ''
+          nh home build -c nix@firefly . --show-activation-logs
+        '';
+
+        bld-iso = ''
+          nix build .#nixosConfigurations.vinox.config.system.build.isoImage
+        '';
+
+        swr-kubex = ''
+          nh os boot --hostname kubex . -d always --target-host kubex
+        '';
+
+        swr-berry = ''
+          nh os boot --hostname nixberry . -d always --target-host nixberry
+        '';
+      }
+    );
+
+    NIX_CONFIG = "experimental-features = nix-command flakes";
   };
 }

docs/hosts/firefly.md

@@ -23,7 +23,7 @@ sh <(curl --proto '=https' --tlsv1.2 -L https://nixos.org/nix/install) --daemon
 
 ```bash
 nix develop
-switch-firefly
+sw-fly
 ```
 
 4. Create Hyprland desktop file.
@@ -68,7 +68,6 @@ Comma-separated list of URLs:
 *://*.google.com/*, *://chat.ske.eu01.stackit.cloud/*
 ```
 
-
 ### GTK Theme
 
 `nwg-look` is used to configure theme in multiple locations.
@@ -111,3 +110,19 @@ Expected results:
 - Portal services come from the host packages, not Home Manager-generated user units.
 - `NIX_XDG_DESKTOP_PORTAL_DIR` is absent from the user systemd environment.
 - The `find` command does not show Home Manager-generated portal config under `~/.config/xdg-desktop-portal` or Nix profile portal definitions under `~/.nix-profile/share/xdg-desktop-portal`.
+
+## Screen Locking
+
+Firefly uses the Ubuntu-managed `/usr/bin/swaylock`, rather than a Nix-built
+locker.
+May swaylock needs to be build without PAM support and copied over.
+Verify the native locker after switching:
+
+```bash
+readlink -f /usr/bin/swaylock
+/usr/bin/swaylock --version
+test -r /etc/pam.d/swaylock
+
+# For testing, use a autounclock as fallback
+sleep 15 && loginctl unlock-session self
+```

docs/reference/hyprland.md

@@ -13,10 +13,12 @@ General docs for hyprland.
 |---|---|
 | `Super+Enter` | Terminal |
 | `Super+E` | Launcher |
-| `Super+P` | Wlogout |
+| `Super+P` | Noctalia session panel |
 | `Super+Q` | Kill active |
-| `Super+N` | Notification Center |
-| `Super+.` | Emoji picker |
+| `Alt+Shift` | Switch keyboard layout |
+| `Alt+Tab` | Window switcher |
+| `Super+N` | Enter Noctalia mode |
+| `Super+.` | Noctalia emoji search |
 
 ## Window
 
@@ -61,7 +63,21 @@ General docs for hyprland.
 |---|---|
 | `Super+Z` | Mumble mute |
 | `Super+Shift+Z` | Mumble deaf |
-| `Super+.` | Emoji picker |
+| `Super+.` | Noctalia emoji search |
+
+## Noctalia Mode
+
+Enter: `Super+N`
+
+| Key | Action |
+|---|---|
+| `N` | Notifications / Control Center |
+| `M` | System monitor |
+| `C` | Calendar |
+| `S` | Screenshot region (Noctalia) |
+| `Shift+S` | Screenshot fullscreen (Noctalia) |
+| `A` | Annotated screenshot (Satty) |
+| `Enter` / `Esc` | Exit |
 
 ## Resize Mode
 
@@ -75,7 +91,7 @@ Enter: `Super+R`
 
 ## Window Mode
 
-Enter: `Super+W`
+Enter: `Super+G`
 
 | Key | Action |
 |---|---|

docs/reference/noctalia.md

@@ -0,0 +1,38 @@
+# Noctalia
+
+Noctalia is the desktop shell for Hyprland.
+Hyprland remains the compositor and window-management layer, Noctalia provides the panel, application and emoji launcher, notifications, session actions, wallpapers, clipboard history, tray, OSD, and control centre.
+
+## Login session
+
+On NixOS, Greetd runs Noctalia Greeter. It discovers Wayland sessions and, after login, starts the selected session; choosing Hyprland runs its generated `start-hyprland` wrapper. The picker remembers the last selection unless a default is configured.
+
+## Migrated components
+
+| Previous component | Noctalia replacement |
+|---|---|
+| Waybar | Top bar: launcher, workspaces, submap indicator (plugin), clock, tray, system monitors and quick controls |
+| Fuzzel and Rofi Emoji | Launcher with application, calculator, emoji, wallpaper and window providers |
+| SwayNC | Notification daemon and notification history |
+| Wlogout | Session panel with lock, logout, shutdown and reboot actions |
+| Hyprpaper | Native wallpaper service |
+| Hyprlock | Native Noctalia screen locking; Firefly delegates to its system `swaylock` |
+| NetworkManager and Blueman tray applets | Noctalia control-centre widgets and tray |
+| Pavucontrol | Noctalia audio controls |
+| Grimblast package | Noctalia screenshot service |
+
+Noctalia additionally enables clipboard history, screen time, per-output wallpaper selection, a system monitor, calendar, scheduled night light, brightness OSD, a Windows-reboot session action on Zion, and a dynamic `hypr-submap` bar plugin widget to visually display active Hyprland modes (`resize`, `windows`, `noctalia`).
+
+## Wallpapers
+
+Noctalia manages wallpapers directly. The declarative configuration supplies `minimal-space.jpg` as the global fallback; use Noctalia's wallpaper picker to assign images to individual outputs. Those per-output selections are stored in Noctalia's state directory and persist across rebuilds.
+
+## Shell shortcuts
+
+| Key | Action |
+|---|---|
+| `Super+E` | Toggle launcher |
+| `Super+P` | Toggle session panel |
+| `Super+N` | Enter Noctalia mode (`n` notifications, `m` monitor, `c` calendar, `s` region capture, `S` full capture, `a` annotate with satty) |
+| `Super+.` | Open emoji search |
+| `Alt+Tab` | Open window switcher |