69b409f348fd9ef66e23ed2d2949c040a705b1cf
PSR2Linux
Clone du Problem Steps Recorder de Microsoft pour Linux.
Enregistre des étapes avec captures d'écran annotées et génère un rapport HTML standalone.
Fonctionnalités
- Capture d'écran déclenchée par Ctrl+Impr Écran (raccourci GNOME global)
- Sélection d'une région ou d'une fenêtre à capturer
- Éditeur d'annotations : flèche, rectangle, ellipse, numéro, texte, crayon
- Export en rapport HTML standalone (images embarquées en base64)
- Interface graphique PySide6 (Qt6)
Prérequis
- Linux avec session X11 (Xorg) — pynput ne fonctionne pas en Wayland
- Python 3.10+
- Un outil de capture installé :
gnome-screenshot,flameshot,scrotouimport(ImageMagick)
Installation
./setup.sh
Le script :
- Installe les dépendances système manquantes (
python3-tk,python3-venv,gnome-screenshot) - Crée le virtualenv
.venvet installe les paquets Python - Enregistre le raccourci Ctrl+Impr Écran dans GNOME (via
gsettings)
Si gsettings n'est pas disponible (session sans D-Bus), enregistrer le raccourci manuellement :
Paramètres → Clavier → Raccourcis personnalisés
Commande : <chemin>/psr2linux-trigger — Touche : Ctrl+Impr Écran
Utilisation
./run.sh
- Lancer l'application avec
./run.sh - Cliquer sur Démarrer pour commencer une session
- Appuyer sur Ctrl+Impr Écran à chaque étape à capturer
- Annoter chaque capture dans l'éditeur
- Cliquer sur Exporter HTML pour générer le rapport
Dépendances Python
| Paquet | Rôle |
|---|---|
Pillow |
Traitement des images |
PySide6 |
Interface graphique Qt6 |
pynput |
Écoute clavier/souris globale |
Diagnostic
En cas de problème avec la capture ou les événements souris :
.venv/bin/python diag.py
Vérifie : serveur d'affichage (X11/Wayland), import pynput, détection des moniteurs, réception des clics.
Structure du projet
psr2linux.py — Application principale
psr2linux-trigger — Script shell déclenché par le raccourci GNOME
diag.py — Outil de diagnostic
setup.sh — Installation et configuration
run.sh — Lancement de l'application
requirements.txt — Dépendances Python
Notes
- Les rapports générés (
rapport_psr_*.html) sont des fichiers HTML autonomes, sans dépendance externe. - Le déclencheur crée le fichier
/tmp/psr2linux.triggerque l'application surveille en polling. - Sur Wayland, relancer la session en mode X11 (XOrg) ou utiliser
DISPLAY=:0.
Description