refactor(modules): organize module tree

modules/desktop/utilities/audio.nix

@@ -0,0 +1,19 @@
+{ config, lib, ... }:
+# PipeWire as the desktop audio server.
+let
+  cfg = config.modules.desktop.utilities.audio;
+in
+{
+  options.modules.desktop.utilities.audio.enable = lib.mkEnableOption "the PipeWire audio server";
+
+  config = lib.mkIf cfg.enable {
+    # Realtime scheduling for the audio threads, so playback survives load.
+    security.rtkit.enable = true;
+
+    services.pipewire = {
+      enable = true;
+      alsa.enable = true;
+      pulse.enable = true;
+    };
+  };
+}

modules/desktop/utilities/clipboard.nix

@@ -0,0 +1,48 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+# Clipboard history: cliphist records every copy, picked back through rofi.
+let
+  cfg = config.modules.desktop.utilities.clipboard;
+  user = config.user.name;
+
+  cliphist = "${pkgs.cliphist}/bin/cliphist";
+  rofi = "${pkgs.rofi}/bin/rofi";
+  wl-copy = "${pkgs.wl-clipboard}/bin/wl-copy";
+
+  # The picker reuses the themed rofi, so history looks like every other menu
+  # the launcher drives.
+  # decode is needed because list emits id-prefixed lines rather than the copied
+  # bytes, so the chosen id has to be resolved back before it can be re-copied.
+  picker = pkgs.writeShellScript "clipboard-picker" ''
+    ${cliphist} list \
+      | ${rofi} -dmenu -i -p Clipboard \
+      | ${cliphist} decode \
+      | ${wl-copy}
+  '';
+in
+{
+  options.modules.desktop.utilities.clipboard.enable = lib.mkEnableOption "cliphist clipboard history";
+
+  config = lib.mkIf cfg.enable {
+    home-manager.users.${user} = {
+      # wl-copy and wl-paste on PATH, so the shell can pipe into and out of the
+      # clipboard.
+      # The watchers and picker above reach wl-clipboard by store path, so this
+      # is for interactive use alone.
+      home.packages = [ pkgs.wl-clipboard ];
+
+      # Two watchers record text and images to history, bound to the graphical
+      # session so uwsm starts and stops them with it.
+      services.cliphist.enable = true;
+
+      # $mod is defined by the compositor config these binds share.
+      wayland.windowManager.hyprland.settings.bind = [
+        "$mod SHIFT, V, exec, ${picker}"
+      ];
+    };
+  };
+}

modules/desktop/utilities/osd.nix

@@ -0,0 +1,39 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+# SwayOSD: a transient on-screen popup for volume and brightness changes.
+let
+  cfg = config.modules.desktop.utilities.osd;
+  user = config.user.name;
+in
+{
+  options.modules.desktop.utilities.osd.enable = lib.mkEnableOption "the SwayOSD volume and brightness popup";
+
+  config = lib.mkIf cfg.enable {
+    environment.systemPackages = [ pkgs.swayosd ];
+
+    # The udev rule chgrps each backlight's brightness node to `video` and adds
+    # group write, so the server dims the panel without root.
+    # Membership below grants the running session that access.
+    services.udev.packages = [ pkgs.swayosd ];
+    users.users.${user}.extraGroups = [ "video" ];
+
+    # The server draws the popups, so it runs for the whole graphical session.
+    # It binds to the target uwsm activates.
+    home-manager.users.${user}.systemd.user.services.swayosd = {
+      Unit = {
+        Description = "SwayOSD on-screen display server";
+        PartOf = [ "graphical-session.target" ];
+        After = [ "graphical-session.target" ];
+      };
+      Service = {
+        ExecStart = "${pkgs.swayosd}/bin/swayosd-server";
+        Restart = "on-failure";
+      };
+      Install.WantedBy = [ "graphical-session.target" ];
+    };
+  };
+}

modules/desktop/utilities/recording.nix

@@ -0,0 +1,54 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+# Keybound screen recording: pick a region, then toggle a video-only capture.
+let
+  cfg = config.modules.desktop.utilities.recording;
+  user = config.user.name;
+
+  slurp = "${pkgs.slurp}/bin/slurp";
+  wf-recorder = "${pkgs.wf-recorder}/bin/wf-recorder";
+  notify-send = "${pkgs.libnotify}/bin/notify-send";
+  pgrep = "${pkgs.procps}/bin/pgrep";
+  pkill = "${pkgs.procps}/bin/pkill";
+  date = "${pkgs.coreutils}/bin/date";
+  mkdir = "${pkgs.coreutils}/bin/mkdir";
+  xdgUserDir = "${pkgs.xdg-user-dirs}/bin/xdg-user-dir";
+
+  # A single key both starts and stops.
+  # A running wf-recorder is stopped with SIGINT so it finalises the file.
+  # Otherwise slurp picks a region and wf-recorder runs in the foreground until
+  # that stop arrives, so this instance lives for the whole recording and then
+  # reports it saved.
+  # No -a means no audio is captured.
+  toggle = pkgs.writeShellScript "screen-record-toggle" ''
+    if ${pgrep} -x wf-recorder >/dev/null; then
+      ${pkill} -INT -x wf-recorder
+      exit 0
+    fi
+
+    region=$(${slurp}) || exit 0
+    dir="$(${xdgUserDir} VIDEOS)/Recordings"
+    ${mkdir} -p "$dir"
+    file="$dir/recording-$(${date} +%Y%m%d-%H%M%S).mp4"
+
+    ${notify-send} -a "Screen recording" "Recording started" "Region capture, no audio."
+    ${wf-recorder} -g "$region" -f "$file"
+    ${notify-send} -a "Screen recording" "Recording saved" "$file"
+  '';
+in
+{
+  options.modules.desktop.utilities.recording.enable = lib.mkEnableOption "wf-recorder screen recording";
+
+  config = lib.mkIf cfg.enable {
+    home-manager.users.${user} = {
+      # $mod is defined by the compositor config these binds share.
+      wayland.windowManager.hyprland.settings.bind = [
+        "$mod SHIFT, R, exec, ${toggle}"
+      ];
+    };
+  };
+}

modules/desktop/utilities/screenshot.nix

@@ -0,0 +1,57 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+# Keyboard-driven screenshots that open in satty for annotation, then land in
+# both the clipboard and a dated file.
+let
+  cfg = config.modules.desktop.utilities.screenshot;
+  user = config.user.name;
+
+  grimblast = "${pkgs.grimblast}/bin/grimblast";
+  satty = "${pkgs.satty}/bin/satty";
+  wl-copy = "${pkgs.wl-clipboard}/bin/wl-copy";
+  xdgUserDir = "${pkgs.xdg-user-dirs}/bin/xdg-user-dir";
+
+  # satty's copy action also saves, so one keystroke lands the shot in both the
+  # clipboard and a file.
+  capture =
+    target:
+    pkgs.writeShellScript "screenshot-${target}" ''
+      dir="$(${xdgUserDir} PICTURES)/Screenshots"
+      mkdir -p "$dir"
+      ${grimblast} save ${target} - \
+        | ${satty} --filename - \
+          --output-filename "$dir/screenshot-%Y%m%d-%H%M%S.png" \
+          --copy-command ${wl-copy} \
+          --save-after-copy \
+          --early-exit \
+          --actions-on-enter save-to-clipboard
+    '';
+in
+{
+  options.modules.desktop.utilities.screenshot.enable = lib.mkEnableOption "screenshots via grimblast and satty";
+
+  config = lib.mkIf cfg.enable {
+    home-manager.users.${user} = {
+      # satty is a one-shot annotation surface, so float it rather than letting
+      # it claim a tile in the layout.
+      # windowrule v3 syntax: space-separated field/value tokens, comma
+      # separated, with matchers under a match: prefix and effects bare.
+      wayland.windowManager.hyprland.settings.windowrule = [
+        "float 1, match:class ^(com\\.gabm\\.satty)$"
+      ];
+
+      # Print with plain/Shift/Ctrl for region/window/full.
+      # Super+L is already the hjkl focus and movement bind, so screenshots take
+      # the Print key instead.
+      wayland.windowManager.hyprland.settings.bind = [
+        ", Print, exec, ${capture "area"}"
+        "SHIFT, Print, exec, ${capture "active"}"
+        "CTRL, Print, exec, ${capture "screen"}"
+      ];
+    };
+  };
+}

modules/desktop/utilities/theming.nix

@@ -0,0 +1,73 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+# Nord theming for the graphical layer, driven from one base16 scheme by Stylix.
+let
+  cfg = config.modules.desktop.utilities.theming;
+  user = config.user.name;
+
+  # A single static Nord wallpaper, drawn as a vertical gradient across the
+  # Polar Night shades so it needs no committed binary and no network fetch.
+  wallpaper = pkgs.runCommand "nord-wallpaper.png" { } ''
+    ${pkgs.imagemagick}/bin/magick \
+      -size 2560x1440 gradient:'#2E3440'-'#3B4252' \
+      "$out"
+  '';
+in
+{
+  options.modules.desktop.utilities.theming.enable =
+    lib.mkEnableOption "Nord theming of the graphical layer via Stylix";
+
+  config = lib.mkIf cfg.enable {
+    stylix = {
+      enable = true;
+
+      # Nord is a dark scheme.
+      # The polarity steers Stylix's contrast choices.
+      polarity = "dark";
+      base16Scheme = "${pkgs.base16-schemes}/share/themes/nord.yaml";
+
+      image = wallpaper;
+
+      # Regreet is not enabled, so its styling target stays off.
+      targets.regreet.enable = false;
+
+      cursor = {
+        package = pkgs.bibata-cursors;
+        # Solid white with a dark outline, so it stays easy to spot against the
+        # dark Nord wallpaper.
+        name = "Bibata-Modern-Ice";
+        size = 24;
+      };
+
+      fonts = {
+        monospace = {
+          package = pkgs.jetbrains-mono;
+          name = "JetBrains Mono";
+        };
+
+        # A step below Stylix's defaults (applications 12, desktop/popups 10,
+        # terminal 12), which read oversized on this display.
+        sizes = {
+          applications = 10;
+          desktop = 9;
+          popups = 9;
+          terminal = 10;
+        };
+      };
+    };
+
+    home-manager.users.${user} = {
+      # Stylix drives the cursor through home-manager's pointer-cursor config,
+      # whose generation must be switched on explicitly.
+      home.pointerCursor.enable = true;
+
+      # nvim keeps its dedicated Nord colorscheme, which is richer than the
+      # base16 mapping Stylix would apply, so its target stays off.
+      stylix.targets.nixvim.enable = false;
+    };
+  };
+}

modules/desktop/utilities/userdirs.nix

@@ -0,0 +1,15 @@
+{ config, lib, ... }:
+# Declares the XDG user directories, so a tool that queries them lands in a
+# well-known folder a host can relocate from one place.
+let
+  cfg = config.modules.desktop.utilities.userdirs;
+  user = config.user.name;
+in
+{
+  options.modules.desktop.utilities.userdirs.enable = lib.mkEnableOption "XDG user directories";
+
+  config = lib.mkIf cfg.enable {
+    # Write ~/.config/user-dirs.dirs from the option defaults.
+    home-manager.users.${user}.xdg.userDirs.enable = true;
+  };
+}