Installer l'agent sous Linux, en une seule condition.
Le paquet .deb installe tout ce qu'il faut et se lance seul au démarrage. Il ne reste qu'à ouvrir votre session en Xorg / X11, jamais en Wayland.
Session Wayland : la capture reste inactive
Sous Wayland, l'agent ne capte rien - ni écran, ni fenêtre active, ni URL, ni frappe. Il tourne, le panneau s'ouvre, mais vos heures ne remontent pas. C'est le piège n°1 sous Linux, et il se corrige au moment de la connexion.
Sous une session Wayland, l'agent ne capte absolument rien.
L'installeur désactive Wayland au niveau de GDM. Mais sur KDE Plasma avec SDDM - courant sur Kali - ce réglage reste sans effet : c'est à vous de choisir la session au moment de la connexion.
Vérifier votre session
Dans un terminal, une réponse wayland signale le problème ; x11 confirme que tout est en ordre.
echo $XDG_SESSION_TYPEBasculer en Xorg / X11
- Fermez votre session (déconnexion, pas seulement le verrouillage).
- Sur l'écran de connexion, ouvrez le sélecteur de session (engrenage, en bas).
- Choisissez Plasma (X11) - ou Ubuntu on Xorg selon votre bureau - puis reconnectez-vous. Le changement ne s'applique pas à chaud.
L'accessibilité du bureau, une fois
Une session Xorg suffit à la capture d'écran et à la fenêtre active. La lecture d'URL, elle, passe par l'accessibilité AT-SPI2.
Paquet at-spi2-core
Il fournit l'accessibilité du bureau (AT-SPI2), sur laquelle l'agent lit la barre d'adresse. C'est une dépendance obligatoire du .deb : sans elle, aucune lecture d'URL, quel que soit le navigateur. En cas de doute, une réinstallation la remet en place.
sudo apt install --reinstall at-spi2-coreCe que chaque navigateur donne
L'URL est lue dans la barre d'adresse via l'accessibilité du bureau (AT-SPI2). Selon le navigateur, l'agent obtient l'adresse complète avec sa durée, ou seulement le domaine par repli SNI.
Chrome, Chromium
L'adresse complète est lue dans l'omnibox, avec la durée passée par page. Chrome allège cependant son arbre d'accessibilité quand sa fenêtre perd le focus.
Si l'URL manque : relancez le navigateur après l'agent, ou lancez Chromium avec --force-renderer-accessibility.
Firefox
Firefox n'expose pas d'interface exploitable pour l'URL. L'agent bascule sur les domaines observés dans le trafic (repli SNI), sans durée par page.
C'est assumé : le temps de travail et l'activité restent mesurés normalement.
Repli SNI
Quand l'accessibilité ne donne pas l'URL exacte, l'agent retombe sur les domaines lus dans le trafic réseau. On garde le domaine visité, pas l'adresse complète ni la durée par page.
Cinq étapes, et le nom exact de celle qui casse
Quand les URL ne remontent pas, l'agent ne vous laisse pas deviner. Lancez la commande de diagnostic dans votre session graphique : elle déroule la chaîne complète et s'arrête sur le maillon fautif.
/usr/lib/gits-monitor/agent -role=urlcheckEnvironnement de session
Vérifie que la session est bien en Xorg / X11 et que le serveur X est accessible.
Si ça bloque : Session Wayland : aucune capture possible, la chaîne s'arrête ici.
Bus de session D-Bus
Vérifie que le bus de session est joignable depuis le worker de capture.
Si ça bloque : Aucun bus de session : le worker tourne en dehors de la session graphique.
Accessibilité activée
Interroge org.a11y.Status pour confirmer qu'at-spi2-core répond.
Si ça bloque : org.a11y.Status introuvable : at-spi2-core absent ou accessibilité désactivée.
Arbre d'accessibilité
Liste les applications visibles et repère le navigateur au premier plan.
Si ça bloque : Le navigateur n'apparaît pas : relancez-le après l'agent.
Barre d'adresse
Localise l'omnibox et lit l'URL exacte de la page ouverte.
Si ça bloque : Omnibox non exposée : Chrome allège son arbre quand la fenêtre perd le focus.
Linux en quelques cas
Du plus fréquent au plus rare. Si aucun ne correspond, le diagnostic intégré nommera l'étape fautive.
Ce que le paquet installe
- Un service systemd système (réseau, mises à jour)
- Une unité systemd --user pour le worker de capture
- Des entrées XDG autostart pour XFCE et bureaux similaires
- Le binaire dans /usr/lib/gits-monitor/agent
Le même agent, ailleurs
Seule la manière d'accorder les autorisations change d'un système à l'autre.
Windows
Windows 10 et 11. Installation en quelques écrans, aucune permission à accorder.
Guide d'installationRevenir à l'agent
La présentation du produit, ses fonctions et sa politique de confidentialité.
Vue d'ensemble