README osx-trace

Copyright © 2006—2011, Renaud Blanch.
mise à jour : 28-Mar-2007

I. Présentation

osx-trace est une sonde logicielle qui enregistre les mouvements de la souris, et, quand un clic a lieu, la position des fenêtres présentes à l'écran et du widget situé sous le curseur. Les informations enregistrées sont uniquement de nature temporelle et géométrique (le nom des applications en route, le contenu des fenêtres, les entrées du clavier ne sont pas enregistrées). La sonde produit des fichiers de log texte qui ont la forme suivante :

#format:osx-trace v0.2
#user:blanch
#host:sunset
#date:2006-11-21-10h19m31s
Y       35557298        715     173     1
X       35557298        715     173     -2
Y       35557306        715     173     1
X       35557306        715     173     -2
Y       35557322        714     173     1
X       35557322        714     173     -3
B       35561274        593     289     1       1
W       522     280     200     16      R:AXTextField
W       0       0       0       0
W       1571    0       303     22      P:186   R:AXMenuBar
W       1874    0       46      22
W       0       0       1920    22      P:10936 R:AXMenuBar

II. Installation

Pour installer la sonde, il faut lancer le terminal (/Applications/Utilities/Terminal.app) puis dans celui-ci :

[sunset:~] blanch% cd /Volumes/osx-trace/
[sunset:/Volumes/osx-trace] blanch% ./install.sh 
suppression des installations precedentes ...
suppression de osx-trace.app des "Login Items" ...
suppression de /Users/blanch/Library/osx-trace ...
/Users/blanch/Library/osx-trace/osx-trace.app/Contents/MacOS/kea: line 6: kill: (11520) - No such process
/Users/blanch/Library/osx-trace/osx-trace.app/Contents/MacOS/kea: line 6: kill: (11761) - No such process
installation de osx-trace.app dans /Users/blanch/Library/osx-trace ...
ajout de osx-trace.app dans les "Login Items" ...
verification de l'activation de l'API d'accessibilite ...
lancement de osx-trace ...
[sunset:/Volumes/osx-trace] blanch% 

L'installation vérifie que l'API d'accessibilité est activée et vous demande de l'activer si elle ne l'est pas. Il faut pour cela cocher la case située en bas à gauche du paneau de préférences :

Une fois la sonde installée, elle commence son travail et m'envoie périodiquement les logs produits par mail. Ceux-ci sont situés dans le répertoire ~/Library/Logs/osx-trace/ et observables à l'aide de la console du système (/Applications/Utilities/Console.app).

III. Suppression

Pour supprimer la sonde, un script est fourni :

[sunset:~] blanch% cd ~/Library/osx-trace/
[sunset:~/Library/osx-trace] blanch% ./uninstall.sh
suppression de osx-trace.app des "Login Items" ...
suppression de /Users/blanch/Library/osx-trace ...
/Users/blanch/Library/osx-trace/osx-trace.app/Contents/MacOS/kea: line 6: kill: (11791) - No such process
/Users/blanch/Library/osx-trace/osx-trace.app/Contents/MacOS/kea: line 6: kill: (11959) - No such process
/Users/blanch/Library/osx-trace/osx-trace.app/Contents/MacOS/kea: line 6: kill: (11963) - No such process
[sunset:~] blanch% 

IV. Problèmes

osx-trace peut faire planter certaines applications qui ont des bugs dans leur gestion de l'accessibilité. Dans le passé, l'application Mail d'Apple avait un tel problème, le client VPN de Cisco aussi. En cas de plantage suspect de certaines applications, désinstaller osx-trace, et me communiquer l'application en cause.

V. Licence

osx-trace est distribuée sous licence GPL version 3 ou supérieure. Merci d'être sûr de comprendre les implications sur la réutilisation de son code.