22 KiB
QuickShell labfy-sway
Le moteur de thème commun fournit les couleurs effectives à QuickShell et Sway/SwayFX depuis une seule palette Catppuccin versionnée.
Barre principale et serveur de notifications de la session SwayFX.
Le haut-parleur de la barre ouvre le mixeur audio du Control Center, avec sorties, flux de lecture et microphones. Le volume général conserve son contrôleur partagé avec la barre et ses pas de 1 point au défilement.
Le bouton Arch Applications, premier élément à gauche même en mode Resize,
ouvre le menu d'applications sous la barre.
Mod+Alt+L ouvre ce menu sur la sortie focalisée.
Les boutons de workspaces conservent les cinq emplacements 1–5 et ajoutent
les autres workspaces présents sur la sortie de la barre. Workspaces.qml
réconcilie l'inventaire I3 avec get_workspaces au chargement, à la connexion
IPC et après les événements workspace/output, sans interrogation périodique.
Le filtrage utilise le nom de sortie IPC ; l'état actif vient des champs
focused/visible du relevé, pour éviter les références d'objets natives
périmées. Le diagnostic en lecture seule est accessible par
qs ipc -c labfy-sway call workspacesUi-eDP-1 state (adapter le nom de sortie).
Bar
├── Applications
├── Workspaces
├── Workspace Overview
├── Window/task switcher
├── Date Center
│ ├── MPRIS
│ └── Notifications
├── Right Status
│ ├── Network
│ ├── Bluetooth
│ ├── Battery
│ ├── Maintenir éveillé (si actif)
│ ├── Updates
│ ├── Supports amovibles
│ ├── Presse-papiers
│ ├── Tray
│ └── Control Center
└── Control Center
├── Wi-Fi
├── Bluetooth
├── Volume
├── Brightness
├── Power Profile
├── Maintenir éveillé
├── Apparence
│ └── Fond d'écran
├── Battery limit
└── Session
Dans Réglages rapides → Maintenir éveillé, sélectionner 30 minutes,
1 heure, 2 heures ou Jusqu’à désactivation. L’icône reste présente même
quand le mode est désactivé ; sa couleur et son infobulle indiquent la demande
manuelle ou applicative, et un clic rouvre
la page pour changer la durée ou désactiver le mode. Une seule barre porte
l’inhibiteur Wayland, même avec plusieurs écrans. L’icône ne prouve pas à elle
seule que le compositeur respecte l’inhibiteur. Le mode empêche l’inactivité
détectée par le compositeur, donc les actions automatiques de swayidle
(verrouillage et extinction de l’écran) tant que l’inhibition est respectée.
Il ne bloque pas le verrouillage manuel, la veille demandée explicitement ni
le verrouillage avant mise en veille. L’état est propre au processus
QuickShell : un rechargement QML conserve la sélection manuelle et l’échéance
initiale grâce à PersistentProperties, tandis qu’un arrêt ou redémarrage du
processus libère l’inhibition. Une nouvelle session graphique repart aussi
désactivée. La configuration et
le cycle de vie de swayidle.service ne sont pas modifiés.
Les demandes automatiques des applications arrivent séparément par le pont
org.freedesktop.ScreenSaver décrit dans portal/README.md.
Le même inhibiteur de la barre reste actif tant que la tasse manuelle ou au
moins une demande applicative valide est présente. La sous-page indique une
demande automatique sans changer la durée de la tasse ; désactiver la tasse
ne retire pas la demande d'une vidéo encore en lecture. La disparition du
helper efface sa seule contribution applicative, tandis que la tasse garde
son propre état.
L'icône Presse-papiers ouvre le panneau d'historique sous la zone droite de
la barre ; Mod+Alt+V conserve le même basculement sur l'écran focalisé.
L'architecture, les raccourcis, les tests isolés et le retour vers Wofi sont
décrits dans clipboard/README.md.
Super+W ouvre la vue d'ensemble visuelle sur la sortie
focalisée. Super+Shift+W conserve le layout Sway tabbed.
quickshell-labfy-sway.service est activé par
wayland-session@sway.desktop.target, sans autostart Sway parallèle.
NotificationService.qml possède org.freedesktop.Notifications ; l'historique
est écrit hors Git via Quickshell.statePath("notifications.json") dans
~/.local/state/quickshell/. Mako demeure installé, inactif et masqué ; voir
ROLLBACK.md.
labfy-quickshell-updates.timer exécute bin/check-updates.py, qui publie un
état JSON dans $XDG_RUNTIME_DIR. batlimit (CLI) et Réglages rapides →
Batterie (GUI) passent par /usr/local/sbin/batlimit-set. Le seuil courant
est 60 % ; le helper root est documenté dans bin/root/README.md.
Dépendances essentielles : quickshell, SwayFX 0.6, scenefx, une Nerd Font,
NetworkManager, BlueZ, PipeWire, TLP/tlpctl, checkupdates, yay, df,
python3, la politique /etc/pam.d/labfy-lock et le helper batterie pour le
réglage du seuil. Le
backlight utilise le noeud machine amdgpu_bl1 dans BrightnessSlider.qml.
Les scans Wi-Fi et Bluetooth
ne sont possédés que par les pages ouvertes.
Le gestionnaire de fonds d'écran local est décrit dans
WALLPAPER.md. Il utilise Sway et swaybg, sans
service permanent ni changement automatique du thème.
Supports amovibles
RemovableMediaIndicator.qml affiche dans la zone d'état un indicateur
lorsqu'au moins un support éligible est présent. Son PopupWindow natif liste
les volumes, leur état et les erreurs publiées, puis offre les actions
Ouvrir, Monter ou Démonter, et Retirer en sécurité lorsque le
contrat le permet. Ouvrir lance Yazi dans Kitty via UWSM en utilisant le
véritable point de montage UDisks pour USB/SD ou le chemin du GMount pour
MTP. Le popup participe à la même exclusion mutuelle que le Date Center, le
menu des fenêtres et le Control Center.
Le popup ouvert reste affiché lorsque la liste devient vide (« Aucun support
amovible »), puis accueille les supports qui réapparaissent. Avec Qt 6.12,
le service utilise la compilation locale corrigée via labfy-quickshell :
diagnostic, compilation et validation Wayland.
Le binaire doit être recompilé après une mise à jour Qt ; le lanceur vérifie
la version avant son exécution.
QuickShell lit exclusivement le snapshot JSON V2
$XDG_RUNTIME_DIR/labfy-removable-media.json. Il refuse intégralement un
snapshot dont schema n'est pas labfy.removable-media, dont version n'est
pas 2, ou dont les appareils ne respectent pas le contrat attendu. Le schéma
publie kind et actions. Chaque appareil publie aussi
safe_remove_runtime_id, y compris lorsque safe-remove n'est pas disponible.
Les identifiants MTP restent opaques et aucune URI MTP n'est publiée. Le chemin
de montage exact fourni par GVFS peut néanmoins contenir un identifiant de
l'appareil ; le snapshot est privé (0600). Les commandes passent sans shell à labfy-removable-mediactl, qui est
l'unique frontière de commande vers le daemon ; le socket Unix associé est
privé (0600).
Le service utilisateur est unique : il utilise l'ObjectManager UDisks pour les
systèmes de fichiers USB ou SD/MMC et Gio.VolumeMonitor/GVFS-MTP pour les
téléphones. Les blocs UDisks marqués HintIgnore ou HintSystem sont exclus.
Un volume crypto_LUKS n'est ni présenté ni déverrouillé automatiquement.
Pendant la vie du daemon, chaque support présent peut être monté
automatiquement une seule fois ; après un démontage manuel, il reste démonté
jusqu'à sa disparition puis sa réinsertion. Au démarrage ou au redémarrage, le
cold-start V1 effectue un nouveau scan : un téléphone déjà présent peut alors
être monté. Pour USB/SD, le retrait en sécurité agit au niveau du lecteur et
vérifie que ses systèmes de fichiers sont démontés avant l'éjection ou la mise
hors tension. Pour MTP, il ferme logiquement le montage GVFS sans appeler
PowerOff.
Le contrôle visuel synthétique peut être activé avec
LABFY_REMOVABLE_MEDIA_TEST_STATE (0, USB, MTP, USB+MTP, busy ou
error) dans le processus QuickShell. Ces états ne lancent aucune commande.
Les tests Python synthétiques du daemon et de son IPC sont décrits dans
systemd.md.
Cette fonction est indépendante de Session Restore : elle ne lit ni n'écrit de checkpoint de session et n'intervient pas dans son démarrage.
Les 29 tests unittest synthétiques et qmllint sont passants. Un Samsung réel
a été reconnu et les opérations ciblées de montage et de retrait en sécurité
ont été vérifiées dans le code isolé. La recette UI sur matériel MTP reste à
effectuer. La validation matérielle USB Ventoy V1 avait été effectuée avant le
commit précédent.
Défilement sur les icônes et mode Resize
Les deux indicateurs du groupe système à droite de la barre règlent séparément le volume et la luminosité par défilement vertical à deux doigts ou avec une molette. Un pas vaut un point de pourcentage. Le geste physique vers le haut augmente la valeur. Le clic sur le bouton Réglages rapides conserve son rôle.
WheelHandler accepte explicitement Mouse et TouchPad, et ne traite que
les 66 px de chaque zone « icône + pourcentage ». Pour un événement, pixelDelta.y est choisi s'il
est non nul, sinon angleDelta.y ; les deux ne sont jamais additionnés. Les
seuils initiaux sont 32 pixels pour le touchpad et 120 unités angulaires
pour un cran de molette. Le reliquat est conservé entre événements, remis à
zéro à la fin du geste si Qt fournit ScrollEnd, au changement de direction
ou au changement de source. Aucun délai ne jette les petits mouvements.
LABFY_SCROLL_DEBUG=1 permet de diagnostiquer les deltas et phases reçus.
Contrôles de barre
Le retour matériel a établi que le geste vers le haut agissait à l'envers sur
le volume. ScrollSteps.js applique la correction de signe une seule fois
aux événements de touchpad. La molette classique garde son sens et son seuil
de 120 unités. Les événements à pixelDelta non nul, ceux dont le périphérique
Qt est TouchPad et les petits deltas angulaires continus sont traités comme
gestes tactiles.
La luminosité pouvait rester bloquée après la première écriture : onSaved
plaçait la file en attente d'un nouveau onLoaded qui n'arrivait pas dans le
cas reproduit. Le watcher FileView peut charger la valeur avant onSaved ;
attendre ensuite un autre chargement n'est pas fiable. La variable
awaitingReadback restait alors vraie ; les demandes suivantes étaient
accumulées sans nouvelle écriture. Le diagnostic a reproduit ce cas avec le
Control Center fermé : le composant recevait −1, tandis que sysfs restait à
376000/400000. La correction libère la file depuis saved, relit la valeur matérielle
après le callback FileView, puis lance la dernière consigne en attente. La
relecture de ce petit fichier sysfs est bornée ; saveFailed, loadFailed et
les données invalides sont signalés. Aucun pourcentage optimiste n'est affiché.
La présentation reprend celle des indicateurs Wi-Fi, Bluetooth et batterie :
icône Nerd Font, pourcentage réel à largeur fixe, fond transparent hors survol
et infobulle. Le soleil remplace le glyphe ambigu . La disposition
finale, avec le tray tout à droite, est décrite ci-dessous.
Validation des contrôles : tests unitaires de ScrollSteps, qmllint et injection
synthétique dans ScrollIcon.applyWheel via un IPC temporaire retiré après
essai. Avec le Control Center fermé, le volume a fait 67 → 68 → 67 % ; la
luminosité a fait 372000 → 376000 → 372000 sur 400000, puis trois pas
rapprochés 93 → 96 % → 93 %. L'essai panneau ouvert puis refermé a conservé
la synchronisation à 93 %. L'appel direct au contrôle a également fonctionné
panneau fermé. L'injection était synthétique ; les essais tactiles et visuels
de la série ont été validés séparément et ne sont pas rejoués pour cette
publication.
Les bornes 0/100 % pour le volume et 10/100 % pour la luminosité sont testées
avec node tests/quickshell/test_percent_math.js, sans pousser le matériel
aux extrêmes.
Le volume utilise Pipewire.defaultAudioSink et son PwObjectTracker, comme
le curseur du Control Center. Il est borné entre 0 et 100 %, sans changer
muted. La luminosité utilise le FileView sysfs déjà employé par le
Control Center, avec un minimum sûr de 10 % et un maximum de 100 %. Ses
écritures sont sérialisées ; la valeur du matériel est relue après chaque
écriture, y compris si le pilote arrondit. L'absence de sortie audio ou de
rétroéclairage désactive l'icône concernée.
L'OSD des réglages est décrit dans osd/README.md. Il observe ces mêmes valeurs confirmées, ainsi que la sourdine de la source audio par défaut, sans modifier les commandes des touches matérielles.
Le libellé RESIZE en Catppuccin Peach apparaît à gauche des workspaces
quand l'événement IPC Sway mode annonce resize. Un seul abonnement
I3IpcListener partage cet état entre toutes les sorties. Une requête
ponctuelle get_binding_state récupère le mode courant au démarrage et à la
reconnexion. L'indicateur n'intervient dans aucun raccourci Sway.
Validation : qmllint, node tests/quickshell/test_scroll_steps.js,
sway -C, git diff --check, transition IPC default → resize → default,
raccourci Super+R puis Escape injectés, rechargement QuickShell pendant
resize, et inspection visuelle de la barre. Les fonctions des contrôles ont été
appelées temporairement par IPC : PipeWire est passé de 60 à 61 %, et sysfs
de 374815/400000 à 380000/400000 (95 %) ; les niveaux initiaux ont ensuite
été restaurés et le point IPC de test retiré. Aucun geste multitouch physique
n'a été généré par l'automatisation.
Présentation de la zone droite
La batterie, le volume et la luminosité partagent PercentIndicatorContent :
une zone d'icône de 22 px, un écart fixe de 4 px et une valeur alignée à gauche
dans une réserve de 38 px. Le composant mesure 66 × 26 px. La police mono à
12 px affiche partout un espace avant % (9 %, 10 %, 99 %, 100 %) ;
une donnée indisponible affiche —. La réserve empêche le changement de
largeur sans éloigner le nombre de son icône. Les silhouettes des glyphes sont
ajustées individuellement : batterie 21 px, volume 22 px, soleil 23 px.
Le groupe système garde l'ordre Wi-Fi, Bluetooth, batterie, volume,
luminosité, avec 6 px entre indicateurs. Les deux séparateurs utilisent le
même token Theme.separator, mesurent 1 × 14 px et disposent chacun de 8 px
de marge latérale. Le tray garde les icônes et menus des applications, avec
des images centrées de 20 × 20 px dans les cibles existantes de 26 × 26 px et
4 px entre cibles. Les actions QuickShell gardent 5 px entre elles ; le bouton
Control Center mesure 30 × 26 px, sans fond au repos et avec un fond discret
au survol ou lorsque le panneau est ouvert.
La zone de défilement du volume et de la luminosité couvre les 66 × 26 px de chaque indicateur, texte compris.
Validation de la présentation : qmllint sur les composants modifiés, tests Node de
PercentPresentation, PercentMath et ScrollSteps, git diff --check,
chargement de la configuration par QuickShell et inspection d'une capture de
la barre réelle à l'échelle de la sortie. Les formats 9/10/99/100 % ont été
testés sans modifier les niveaux matériels. Les essais tactiles et visuels de
la série ont également couvert le tray.
Disposition finale de la zone droite
L'ordre visuel est désormais : Wi-Fi, Bluetooth, batterie, volume,
luminosité ; séparateur ; actions QuickShell, bouton Control Center compris ;
séparateur ; tray applicatif tout à droite. Le second séparateur disparaît
avec un tray vide. Les deux traits visibles utilisent Theme.separator,
mesurent 1 × 14 px et sont séparés des groupes par 8 px. Les cibles des
statuts, actions et icônes du tray gardent leur hauteur de 26 px ; les groupes
conservent respectivement 6, 5 et 4 px d'espacement interne.
La police commune des glyphes ne leur donne pas une hauteur de dessin commune : les formes Wi-Fi, haut-parleur, soleil et réglages occupent moins de hauteur que les formes Bluetooth et batterie. Les tailles de police sont donc ajustées sur la barre réelle : Wi-Fi 30 px, Bluetooth 18 px, batterie 18 px, volume 28 px, luminosité 26 px, mises à jour 26 px, presse-papiers 24 px et bouton Control Center 28 px. L'icône de support amovible conserve ses 18 px et les images du tray leurs 20 × 20 px. Ces ajustements ne changent ni les zones interactives, ni les callbacks, ni les contrôleurs du volume et de la luminosité.
Accents Catppuccin de la barre
Les pictogrammes utilisent directement les propriétés de Theme, alimentées
par l'unique catppuccin.json : Wi-Fi connecté sky, Bluetooth actif blue,
batterie normale green, volume non muet mauve, luminosité disponible
yellow, mises à jour disponibles peach, support amovible teal,
presse-papiers pink et menu système lavender. Les nombres et pourcentages
restent en foreground. PercentIndicatorContent sépare désormais la
couleur du glyphe de celle de la valeur, sans changer ses dimensions.
StatusColorRoles.js choisit les rôles selon les états réels, sans contenir
de valeur hexadécimale : Wi-Fi bloqué ou Bluetooth inactif atténués, volume
muet atténué, batterie sous 30 % en avertissement et à 15 % ou moins en
danger, erreur de mise à jour ou de support en danger, opération de
support en warningForeground. Une vérification de mises à jour encore en
attente reste neutre. Les couleurs du tray et les fonds existants ne changent
pas. Les états rares sont vérifiés avec des données isolées par
tests/quickshell/test_status_color_roles.js, sans agir sur le matériel.
Impression CUPS
PrintingIndicator est placé après les supports amovibles dans la barre. Son
popup montre l'imprimante par défaut, toutes les imprimantes configurées et les
travaux non terminés. Le backend ponctuel printing/backend.py lit les
attributs IPP structurés avec pycups et renvoie sur stdout le schéma JSON
labfy.printing version 1 (scheduler, default_printer, printers, jobs).
Les états inconnus restent « Indisponible ». Le nom d'un document ne figure
que dans la réponse éphémère et dans le popup ouvert ; aucun snapshot n'est
écrit. cancel reçoit uniquement un identifiant décimal validé via argv
direct, puis le panneau rafraîchit son état.
Le rafraîchissement a lieu à l'ouverture, après une annulation, toutes les
5 secondes si la file est occupée ou le popup ouvert, sinon toutes les
30 secondes. Un service CUPS indisponible laisse une icône atténuée et un
popup explicite. LABFY_PRINTING_TEST_STATE=empty|jobs|unavailable alimente
la fixture visuelle PrintingVisualFixture.qml sans contacter CUPS ni pouvoir
annuler un vrai travail. Le backend se teste avec
python3 -B -m unittest discover -s printing -p 'test_*.py' depuis ce dossier.
Parité avec i3status-rs
| Ancien bloc | QuickShell |
|---|---|
| scratchpad indicator | tiroir natif SwayFX, voir scratchpad/README.md |
| focused_window | WindowStrip |
| music | Date Center MPRIS |
| bluetooth | status + Control Center |
| net | status + Control Center |
| sound | icône à défilement + Control Center |
| backlight | icône à défilement + Control Center |
| battery | status + page Batterie |
| TLP | PowerProfile |
| packages | Updates |
| time | Clock / Date Center |
| menu | page Session |
Session V2 au démarrage
Limusic reste possédé par l’autostart Sway (managed-autostart, aucun lancement
par Session V2). Après un clic explicite sur Restaurer, le dialogue retire
sa surface focusable et attend deux observations de son retrait, avec un délai
maximal de 1,5 seconde. Un reçu passif affiche ensuite la progression sans
reprendre le clavier. Le backend vérifie séparément deux observations cohérentes
du focus et l’identité de session avant toute reprise, mutation ou création de
journal de restauration. Un focus réellement inconnu ou instable produit
DEFERRED ; Réessayer et Nouvelle session restent accessibles.
Une interruption ou un redémarrage conserve le claim et présente l’état sans
relancer automatiquement la restauration ; un journal ambigu reste protégé.
Le focus final d’un client tiers présent au début du lot est rétabli avec son
identité et son emplacement vérifiés ; les transitions intermédiaires restent
prédites et contrôlées avant et après IPC. Les intentions exactes précèdent chaque IPC autorisée, jamais un refus préalable.
État actuel : phase 0 prewarm validée sur SwayFX 0.6 headless ; prochain
login réel encore à tester. Le premier login du 17 octobre a échoué avec
l’ancienne séquence et a nécessité une récupération manuelle. Le moteur ouvre
désormais les applications absentes avant les mutations, puis vérifie
arbre et focus final ; une divergence durant la transaction reste un refus.
Les tests focus Python et Qt/QML avec fixtures simulées sont complétés par
tests/session_v2/phase3b_ui.py sur un compositeur privé et le vrai QuickShell,
dont le refus avec focus nul puis activation utilisateur explicite et retry.
Après DEFERRED, le dialogue ne capte plus le clavier : activez vous-même une
fenêtre ou un espace avec vos raccourcis Sway puis cliquez Réessayer ; aucune
relance n’est automatique, y compris après redémarrage QuickShell.
Voir Session Restore V2 pour les
commandes, les preuves et les limites de l’environnement. La recette réussie
du 7 octobre est historique ; elle ne valide pas cette révision au login réel.