docs: update for sway support and package bucket rules

Deploy /etc/profile.d/10-qt-theme.sh setting QT_QPA_PLATFORMTHEME=gtk3
system-wide. The gtk3 Qt platform theme plugin (already shipped with
qt5/qt6 base on Void) makes both Qt5 and Qt6 widgets read theme name,
font, icon theme and color scheme from ~/.config/gtk-3.0/settings.ini,
so Qt apps now match the Yaru-blue-dark setup on both i3 and sway.

Also drop the stale QT_QPA_PLATFORMTHEME=qt6ct override in nymph's
session-env (qt6ct is not installed and the override would shadow the
global gtk3 setting).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

AGENTS.md

@@ -54,15 +54,24 @@ Ansible-driven personal infrastructure repo for Void desktops, Linux workstation
 - Use `no_log: true` for secret-bearing task inputs or outputs.
 
 ## Desktop Notes
-- `profile_desktop_common` owns the shared desktop bootstrap.
+- `profile_desktop_common` owns the shared desktop bootstrap; `profile_desktop_i3` (X11) and `profile_desktop_sway` (Wayland/SwayFX) install their respective session in parallel and are both wired into the `void` play in `ansible/site.yml`. `desktop_sessions_enabled` and `desktop_default_session` in host vars decide which sessions are exposed in `emptty` and which is preselected.
 - `.emacs.d` is deployed by a dedicated `profile_desktop_common` task tagged `emacs`.
 - NTFS filesystem support is provided by `ntfs-3g` in `ansible/inventory/group_vars/void.yml`.
 - Void user services are managed by `turnstile` and live under `dotfiles/desktop/.config/service/`.
 - `ssh-agent` keeps the stable socket `~/.local/state/ssh-agent/socket`.
 - Critical session entrypoints:
-  - `dotfiles/desktop/.xinitrc`
+  - `dotfiles/desktop/.xinitrc` (i3 / X11)
+  - `dotfiles/desktop/.config/sway/config` plus `host.conf` and `session-env` deployed via `host_sway_dotfiles` (sway / Wayland)
 - Do not auto-restart `emptty` during playbook runs on active Void desktop hosts; restart it manually from another TTY/SSH session if needed.
-- `nymph` is an i3/X11 Void laptop with NVIDIA Optimus; host-specific tasks in `profile_desktop_host/tasks/nymph.yml` handle GRUB NVIDIA cmdline params, `prime-run` wrapper, and the WirePlumber camera priority config.
+- `nymph` is a Void laptop with NVIDIA Optimus, running both i3 (X11) and sway (Wayland); host-specific tasks in `profile_desktop_host/tasks/nymph.yml` handle GRUB NVIDIA cmdline params, `prime-run` wrapper, and the WirePlumber camera priority config. Multi-monitor on X11 is driven by `autorandr`; on sway it is driven by `kanshi` (config deployed via `host_sway_dotfiles`).
+
+## Void Package And Dotfile Bucket Rules
+The four Void desktop package lists in `ansible/inventory/group_vars/void.yml` are kept disjoint by role:
+- `void_packages_base` — system runtime only (init/services, kernel, audio core, networking, filesystem, firewall, hardware daemons, runit logging).
+- `desktop_common_packages` — WM-agnostic GUI infra (GTK theme, polkit, keyring, NM-applet, blueman, audio GUI, file manager backend + GVFS, portal, flatpak, printing/scanning).
+- `desktop_i3_packages` / `desktop_sway_packages` — binaries specific to each session. Cross-WM packages used by both (`dunst`, `rofi`, `alacritty`) are intentionally duplicated in the two lists.
+`profile_packages` in the same file is cross-distro and is overridden by `group_vars/server.yml` and the workstation group vars; do not move desktop-specific Void entries through it.
+The dotfile vars follow the same split: `desktop_common_dotfiles` (in `group_vars/desktop.yml`) carries WM-agnostic GUI config and user scripts (Thunar, mimeapps, GTK theme setup, Udiskie, fontconfig, WirePlumber, mpv, …); `desktop_void_dotfiles` (in `group_vars/void.yml`) is reserved for files that need Void runtime (turnstile services, bash runit/dbus/ssh-agent fragments, `update-turnstile-env`).
 
 ## Workstation / Windows Notes
 - Native Linux workstation hosts can combine `workstation_host_linux` with an OS-specific dev group.

README.md

@@ -72,22 +72,25 @@ Sistema operativo:
 
 Sessioni desktop:
 
-- `ikaros`: i3
+- `ikaros`: i3 (X11) + sway (Wayland), default i3
-- `nymph`: i3
+- `nymph`: i3 (X11) + sway (Wayland), default i3
 
 Macchine:
 
 - `ikaros`
 - `nymph`
 
-Queste macchine condividono la stessa configurazione base desktop e vengono mantenute allineate tramite Ansible.
+Queste macchine condividono la stessa configurazione base desktop e vengono mantenute allineate tramite Ansible. Sia i3 sia sway/SwayFX sono installate in parallelo e selezionabili da `emptty`; `desktop_default_session` decide quale sessione viene preselezionata al login.
 
 Lo stato attuale del profilo desktop include, tra le altre cose:
 
 - dotfiles comuni e desktop
-- sessione i3 su entrambi gli host
+- sessioni i3 e sway su entrambi gli host (default i3, sway disponibile via `emptty`)
-- `emptty` con default host-specific per il desktop attivo, con `XORG_SESSIONS_PATH` puntato a `/etc/emptty/xsessions` per esporre solo le sessioni esplicitamente whitelistate
+- `emptty` con default host-specific per il desktop attivo, con `XORG_SESSIONS_PATH` puntato a `/etc/emptty/xsessions` e session file Wayland esposti su `WAYLAND_SESSIONS_PATH` per `sway`
-- pacchetti Void Linux e servizi runit
+- pacchetti Void Linux e servizi runit; le liste pacchetti Void desktop sono separate per criterio:
+  - `void_packages_base` per il runtime sistema (init, kernel, audio core, networking, firewall, hw daemons)
+  - `desktop_common_packages` per l'infrastruttura GUI WM-agnostic (tema, polkit, keyring, NM-applet, blueman, audio GUI, file manager backend, portal, flatpak, printing/scanning)
+  - `desktop_i3_packages` e `desktop_sway_packages` per i binari specifici di ciascuna sessione
 - `turnstile` per i servizi utente, inclusi `emacs` e `ssh-agent`
 - `ssh-agent` con socket stabile condiviso tra shell, SSH ed Emacs in `~/.local/state/ssh-agent/socket`
 - `.emacs.d` distribuito da un task dedicato Ansible con tag `emacs`
@@ -95,7 +98,7 @@ Lo stato attuale del profilo desktop include, tra le altre cose:
 - Flatpak con remoto Flathub
 - GNOME Keyring e bootstrap della posta via script dedicato
 - `udiskie` come backend per automount/LUKS
-- `autorandr` per profili monitor host-specifici (`nymph` ha profili `dual` e `solo`)
+- `autorandr` per profili monitor X11 host-specifici (`nymph` ha profili `dual` e `solo`); sotto sway il multi-monitor è gestito da `kanshi` (config host-specifica in `host_sway_dotfiles` su `nymph`)
 - override NVIDIA Optimus su `nymph`: parametri kernel GRUB iniettati in modo idempotente in `GRUB_CMDLINE_LINUX`, wrapper `prime-run` e config WirePlumber per priorità telecamera
 
 ---
@@ -271,7 +274,8 @@ I principali ruoli attualmente presenti sono:
 | services_runit            | gestione servizi runit              |
 | services_systemd          | gestione servizi systemd            |
 | profile_desktop_common    | bootstrap desktop Void condiviso    |
-| profile_desktop_i3        | sessione desktop i3                 |
+| profile_desktop_i3        | sessione desktop i3 (X11)           |
+| profile_desktop_sway      | sessione desktop sway / SwayFX (Wayland) |
 | profile_desktop_host      | override desktop specifici per host |
 | profile_workstation_dev_common | configurazione dev workstation condivisa |
 | profile_workstation_gnome | configurazione host workstation GNOME |
@@ -289,7 +293,7 @@ Il playbook `ansible/site.yml` e attualmente composto da sette blocchi:
 
 ```text
 all:!workstation_host_windows -> dotfiles_common
-void -> packages_void + services_runit + profile_desktop_common + profile_desktop_i3 + profile_desktop_host
+void -> packages_void + services_runit + profile_desktop_common + profile_desktop_i3 + profile_desktop_sway + profile_desktop_host
 workstation_dev_ubuntu -> packages_ubuntu + services_systemd + profile_workstation_dev_common
 workstation_dev_fedora -> packages_fedora + services_systemd + profile_workstation_dev_common
 workstation_host_linux -> profile_workstation_gnome
@@ -439,7 +443,8 @@ Allo stato attuale `ansible/site.yml` espone questi tag:
 | `dotfiles:workstation` | dotfiles dedicati alle workstation | workstation Linux, WSL |
 | `emptty` | gestione display manager `emptty` | desktop Void |
 | `gnome` | configurazione host GNOME | workstation host Linux, parte desktop |
-| `i3` | sessione/configurazione i3 | desktop Void |
+| `i3` | sessione/configurazione i3 (X11) | desktop Void |
+| `sway` | sessione/configurazione sway / SwayFX (Wayland) | desktop Void |
 | `npm` | installazione pacchetti npm globali | desktop Void, workstation Linux, WSL |
 | `nvidia` | componenti NVIDIA desktop | desktop Void |
 | `packages` | installazione e aggiornamento pacchetti | tutti i profili |
@@ -451,6 +456,7 @@ Esempi pratici:
 
 ```bash
 ansible-playbook ansible/site.yml --limit nymph --tags dotfiles:desktop,i3 --check --diff
+ansible-playbook ansible/site.yml --limit ikaros --tags sway,portal --check --diff
 ansible-playbook ansible/site.yml --limit deadalus-fedora --tags packages,vscode --check --diff
 ansible-playbook ansible/site.yml --limit prometheus --tags services,dotfiles:server --check --diff
 ```

ansible/inventory/group_vars/desktop.yml

@@ -44,6 +44,26 @@ desktop_common_dotfiles:
     src: .config/fontconfig/
     dest: .config/fontconfig/
     mode: preserve
+  - name: GTK theme setup script
+    src: .local/bin/setup-gtk-theme
+    dest: .local/bin/setup-gtk-theme
+    mode: "0755"
+  - name: MIME application defaults
+    src: .config/mimeapps.list
+    dest: .config/mimeapps.list
+    mode: "0644"
+  - name: Thunar config
+    src: .config/Thunar/
+    dest: .config/Thunar/
+    mode: preserve
+  - name: Udiskie config
+    src: .config/udiskie/
+    dest: .config/udiskie/
+    mode: preserve
+  - name: Udiskie password helper
+    src: .local/bin/udiskie-password
+    dest: .local/bin/udiskie-password
+    mode: "0755"
   - name: WirePlumber config
     src: .config/wireplumber/
     dest: .config/wireplumber/
@@ -174,6 +194,10 @@ desktop_sway_dotfiles:
     src: .config/waybar/
     dest: .config/waybar/
     mode: preserve
+  - name: flameshot config
+    src: .config/flameshot/
+    dest: .config/flameshot/
+    mode: preserve
   - name: alacritty config
     src: .config/alacritty/
     dest: .config/alacritty/

ansible/inventory/group_vars/void.yml

@@ -11,56 +11,46 @@ void_packages_base:
   - NetworkManager
   - avahi
   - base-system
-  - bat
   - clang
   - clang-tools-extra
   - cmake
-  - cups
-  - cups-filters
-  - cups-pk-helper
   - delta
   - elogind
   - fastfetch
-  - flatpak
   - fuse3
   - gcc
   - gdb
   - gist
   - github-cli
-  - gnome-keyring
   - go
-  - gvfs
   - hugo
   - ImageMagick
   - isync
-  - libsecret
   - libtool
+  - linux
+  - linux-headers
   - linux-mainline
+  - linux-mainline-headers
+  - linux-tools
   - lm_sensors
   - man-pages-devel
   - man-pages-posix
   - msmtp
   - mu4e
-  - network-manager-applet
   - nodejs
   - ntfs-3g
-  - pavucontrol
   - pipewire
   - pkg-config
+  - plocate
   - podman
   - podman-compose
   - rclone
-  - sane
-  - sane-airscan
-  - seahorse
-  - simple-scan
   - socklog
   - socklog-void
   - speech-dispatcher
   - syncthing
-  - system-config-printer
-  - tmux
   - tealdeer
+  - tmux
   - tree-sitter-grammars
   - ufw
   - void-repo-nonfree
@@ -68,7 +58,6 @@ void_packages_base:
   - vsv
   - xtools
   - yt-dlp
-  - plocate
 
 enabled_services:
   - NetworkManager
@@ -94,14 +83,6 @@ desktop_void_dotfiles:
     src: .config/service/
     dest: .config/service/
     mode: preserve
-  - name: Thunar config
-    src: .config/Thunar/
-    dest: .config/Thunar/
-    mode: preserve
-  - name: MIME application defaults
-    src: .config/mimeapps.list
-    dest: .config/mimeapps.list
-    mode: "0644"
   - name: Bash DBus session fragment
     src: .bashrc.d/14-dbus-session.sh
     dest: .bashrc.d/14-dbus-session.sh
@@ -114,18 +95,6 @@ desktop_void_dotfiles:
     src: .bashrc.d/15-runit-desktop.sh
     dest: .bashrc.d/15-runit-desktop.sh
     mode: "0644"
-  - name: GTK theme setup script
-    src: .local/bin/setup-gtk-theme
-    dest: .local/bin/setup-gtk-theme
-    mode: "0755"
-  - name: Udiskie password helper
-    src: .local/bin/udiskie-password
-    dest: .local/bin/udiskie-password
-    mode: "0755"
-  - name: Udiskie config
-    src: .config/udiskie/
-    dest: .config/udiskie/
-    mode: preserve
   - name: Turnstile environment update script
     src: .local/bin/update-turnstile-env
     dest: .local/bin/update-turnstile-env
@@ -134,11 +103,24 @@ desktop_void_dotfiles:
 desktop_common_packages:
   - blueman
   - brightnessctl
+  - cups
+  - cups-filters
+  - cups-pk-helper
   - dex
   - emptty
+  - flatpak
+  - gnome-keyring
+  - gvfs
+  - libsecret
   - network-manager-applet
+  - pavucontrol
   - pinentry-emacs
   - pinentry-gtk
+  - sane
+  - sane-airscan
+  - seahorse
+  - simple-scan
+  - system-config-printer
   - turnstile
   - udiskie
   - xdg-desktop-portal
@@ -170,13 +152,12 @@ desktop_i3_packages:
   - xorg-minimal
   - xss-lock
   - xdotool
-  
+
 desktop_sway_packages:
   - cliphist
   - dunst
   - flameshot
   - grim
-  - jq
   - kanshi
   - rofi
   - slurp

ansible/roles/profile_desktop_common/tasks/main.yml

@@ -434,6 +434,18 @@
     - "{{ user_home }}/Maildir/iCloudAccount"
     - "{{ user_home }}/Maildir/ProtonMailAccount"
 
+- name: Make Qt apps follow the GTK theme
+  tags: [theme]
+  ansible.builtin.copy:
+    dest: /etc/profile.d/10-qt-theme.sh
+    content: |
+      # Use the gtk3 Qt platform theme so Qt5/Qt6 widgets, file dialogs,
+      # icon theme and color scheme follow ~/.config/gtk-3.0/settings.ini.
+      export QT_QPA_PLATFORMTHEME=gtk3
+    owner: root
+    group: root
+    mode: "0644"
+
 - name: Ensure flathub remote is configured
   tags: [packages]
   community.general.flatpak_remote:
@@ -464,28 +476,6 @@
     - (desktop_flatpak_extensions | default([])) | length > 0
     - item | length > 0
 
-- name: Ensure /etc/flatpak/overrides exists
-  tags: [packages, flatpak, theme]
-  ansible.builtin.file:
-    path: /etc/flatpak/overrides
-    state: directory
-    owner: root
-    group: root
-    mode: "0755"
-  when: (desktop_flatpak_packages | default([])) | length > 0
-
-- name: Force dark GTK theme for Flatpak applications
-  tags: [packages, flatpak, theme]
-  ansible.builtin.copy:
-    dest: /etc/flatpak/overrides/global
-    content: |
-      [Environment]
-      GTK_THEME={{ desktop_flatpak_gtk_theme | default('Yaru-Blue-dark') }}
-    owner: root
-    group: root
-    mode: "0644"
-  when: (desktop_flatpak_packages | default([])) | length > 0
-
 - name: Bootstrap rustup toolchain installer
   tags: [packages]
   block:

dotfiles/desktop/.config/flameshot/flameshot.ini

@@ -0,0 +1,13 @@
+[General]
+copyPathAfterSave=false
+disabledTrayIcon=true
+drawColor=#4a90d9
+drawThickness=3
+filenamePattern=%Y-%m-%d_%H-%M-%S
+savePath=/home/fscotto/Pictures/Screenshots
+savePathFixed=true
+showDesktopNotification=true
+useGrimAdapter=true
+showHelp=false
+showSidePanelButton=true
+startupLaunch=false

dotfiles/desktop/.config/sway/config

@@ -74,6 +74,9 @@ for_window [class="(?i)polkit"] floating enable
 for_window [title="^Authentication Required"] floating enable
 
 # Autostart — XDG and session services
+# Propagate Wayland env to dbus so xdg-desktop-portal backends inherit
+# WAYLAND_DISPLAY/SWAYSOCK when dbus-activated (otherwise they crash).
+exec dbus-update-activation-environment DISPLAY WAYLAND_DISPLAY SWAYSOCK XDG_CURRENT_DESKTOP XDG_SESSION_TYPE XDG_SESSION_DESKTOP
 exec dex --autostart --environment sway
 exec gnome-keyring-daemon --start --components=secrets
 exec_always ~/.config/sway/scripts/setup-gtk-theme.sh
@@ -138,10 +141,10 @@ bindsym $mod+Shift+x exec ~/.config/sway/scripts/lockscreen
 bindsym $mod+Shift+q kill
 
 # Screenshot
-#   Print        → flameshot GUI (annotations, save + clipboard via portal)
+#   Print        → flameshot GUI
 #   Shift+Print  → grim+slurp region → clipboard
 #   Alt+Print    → grim focused output → clipboard
-bindsym Print exec flameshot gui --path "$HOME/Pictures/Screenshots" --clipboard
+bindsym Print exec flameshot gui
 bindsym Shift+Print exec ~/.config/sway/scripts/screenshot region
 bindsym Alt+Print exec ~/.config/sway/scripts/screenshot output
 

dotfiles/nymph/.config/sway/session-env

@@ -1,6 +1,5 @@
 export LIBVA_DRIVER_NAME=iHD
 export QT_QPA_PLATFORM=wayland
-export QT_QPA_PLATFORMTHEME=qt6ct
 export SWAY_UNSUPPORTED_GPU=1
 export WLR_DRM_DEVICES=/dev/dri/card0:/dev/dri/card1
 export WLR_NO_HARDWARE_CURSORS=1