Files
nixos-setup/modules/nixos/desktop/tiler/ABOUTME.md
T

2.5 KiB

modules/nixos/desktop/tiler/

Tiling Wayland compositors and their shared plumbing. The shared tiler.enable switch brings in DankMaterialShell (DMS), the gnome-keyring/secrets stack, polkit, and a common set of Wayland control/capture tools. Each compositor module turns this on automatically.

Files

tiler/
├── default.nix    # skyg.nixos.desktop.tiler.enable — DMS, keyring, polkit, shared packages
├── niri.nix                    # skyg.nixos.desktop.tiler.niri — niri compositor (sets tiler.enable)
├── niri-touchscreen-gestures.nix # skyg.nixos.desktop.tiler.niri.touchscreen-gestures — touchscreen swipe support
├── hyprland.nix                # skyg.nixos.desktop.tiler.hyprland — Hyprland (sets tiler.enable)
└── swww.nix                    # skyg.nixos.desktop.tiler.background — swww/waypaper wallpaper tools

Behaviour

  • Enabling either niri or hyprland sets skyg.nixos.desktop.tiler.enable = true, which pulls in the shared substrate. You normally enable only the compositor option.
  • The shared substrate configures gnome-keyring as the SSH agent (so programs.ssh.startAgent = false), enables polkit, and installs control tools (pavucontrol, playerctl, brightnessctl, blueman) and screen-capture tools (slurp, satty, wf-recorder).
  • background is an independent opt-in for swww + waypaper wallpaper management.

Option Namespace

skyg.nixos.desktop.tiler.enable                  → default.nix (usually set indirectly)
skyg.nixos.desktop.tiler.niri.enable
skyg.nixos.desktop.tiler.niri.touchscreen-gestures.enable  # 3/4-finger swipes → niri actions
skyg.nixos.desktop.tiler.hyprland.enable
skyg.nixos.desktop.tiler.background.enable

Conventions

  • Don't set tiler.enable directly — enable a compositor and let it flip the shared switch.
  • Greeter is DMS-managed (programs.dank-material-shell); never hand-roll services.greetd.
  • Keyring provides the SSH agent here — keep programs.ssh.startAgent off.

Touchscreen Gestures (niri only)

When skyg.nixos.desktop.tiler.niri.touchscreen-gestures.enable = true:

  • Installs niri-touchscreen-gestures package
  • Starts a user systemd service (niri-touchscreen-gestures.service)
  • Uses built-in defaults: 3-finger swipes for workspace/column navigation, 4-finger for overview
  • Can be customized by placing a TOML config at ~/.config/niri/gestures.toml
  • Requires user to be in the input group (done automatically by tiler.enable)

See pkgs/niri-touchscreen-gestures/README.md for gesture configuration details.