E2py — Analyseur de risques épileptiques pour vidéos Outil open-source basé sur les normes WCAG 2.3 / ITU-R BT.1702 / Harding PSE

---

🌐 Langue / Language

• 🇫🇷 Version française
• 🇬🇧 English version

---

🇫🇷 Version française

Table des matières

1. À propos
2. Normes appliquées
3. Règles de détection
4. Prérequis système
5. Installation
6. Lancement
7. Utilisation pas à pas
8. Comprendre les résultats
9. Format du rapport JSON
10. Compiler un exécutable
11. Limites et avertissements
12. FAQ

---

1. À propos

E2py est une application de bureau GTK4 qui analyse une vidéo frame par frame pour détecter les séquences susceptibles de provoquer des crises d'épilepsie photosensible chez des personnes à risque.

Elle détecte :

• Les flashs lumineux dépassant la fréquence critique de 3 Hz
• Les transitions vers du rouge saturé à fort contraste
• Les zones clignotantes couvrant ≥ 25 % de l'image

L'interface est disponible en français et en anglais, commutable en temps réel.

⚠️ Cet outil est indicatif. Pour une certification officielle (diffusion télévisée, cinéma, publicité), utilisez le Harding PSE Analyser accrédité : hardingfpa.tv

---

2. Normes appliquées

Norme	Description	Lien
WCAG 2.1 SC 2.3.1	Critère "Trois flashs ou sous le seuil"	w3.org
ITU-R BT.1702	Réduction des crises photosensibles (broadcast)	itu.int
Harding PSE Criteria	Standard industrie (BBC, ITV, Ofcom) — seuil rouge réduit de moitié	hardingfpa.tv

---

3. Règles de détection

Règle 1 — Flash général (WCAG 2.3.1 + ITU-R BT.1702)

• Un flash = transition dark→light ou light→dark avec une variation de luminance relative ≥ 10 %
• La luminance est calculée en espace sRGB linéarisé : L = 0.2126·R + 0.7152·G + 0.0722·B
• > 3 flashs par seconde sur une fenêtre glissante d'1 seconde = RISQUE
• La zone clignotante doit couvrir ≥ 25 % de l'image pour être prise en compte

Règle 2 — Flash rouge saturé (Harding)

• Détection en espace HSV : teinte H ∈ [0°–10°] ou [160°–180°], saturation S ≥ 100/255, valeur V ≥ 100/255
• Une transition vers du rouge couvrant ≥ 25 % de l'image = RISQUE ACCRU
• Le rouge est considéré deux fois plus dangereux que les autres couleurs selon le standard Harding

Règle 3 — Fenêtre temporelle

• Comptage sur une fenêtre glissante stricte d'1 seconde, purgée frame par frame
• Conforme aux spécifications Harding et WCAG

---

4. Prérequis système

Linux (Ubuntu 22.04+ / Debian 12+ / Fedora 38+)

# Ubuntu / Debian
sudo apt install python3 python3-pip python3-gi python3-gi-cairo  gir1.2-gtk-4.0 gir1.2-adw-1

# Fedora
sudo dnf install python3 python3-pip python3-gobject gtk4 libadwaita

Windows

GTK4 n'est pas natif sous Windows. Installer MSYS2 (msys2.org), puis dans le terminal MSYS2 :

pacman -S mingw-w64-x86_64-python mingw-w64-x86_64-python-pip mingw-w64-x86_64-python-gobject mingw-w64-x86_64-gtk4 mingw-w64-x86_64-libadwaita  mingw-w64-x86_64-opencv mingw-w64-x86_64-python-numpy

Dépendances Python (auto-installées)

Les packages Python suivants sont installés automatiquement au premier lancement si absents :

Package	Version minimale	Rôle
opencv-python	4.x	Décodage vidéo, traitement HSV
numpy	1.21+	Calculs matriciels (luminance)

---

5. Installation

Aucune installation requise. Il suffit de télécharger le fichier :

e2py.py

Et de le lancer directement (voir section suivante).

---

6. Lancement

python3 e2py.py

Au premier lancement, si opencv-python ou numpy sont absents, le script les installe automatiquement via pip. Un message s'affiche dans le terminal :

[auto-install] Packages manquants : opencv-python
[auto-install] ✅  opencv-python installé.

Si l'installation automatique échoue (environnement Python géré par le système) :

pip3 install opencv-python numpy --break-system-packages

---

7. Utilisation pas à pas

Étape 1 — Sélectionner la vidéo

Cliquez sur "Parcourir" ou sur l'icône 📂 dans la barre de titre pour ouvrir le sélecteur de fichiers.

Formats supportés : MP4, MKV, AVI, MOV, WEBM, FLV, WMV, TS, M4V

Le nom du fichier et son chemin s'affichent dans la zone de sélection.

Étape 2 — Choisir la langue (optionnel)

Utilisez les boutons 🇫🇷 FR / 🇬🇧 EN en haut à droite pour basculer la langue de l'interface.

Étape 3 — Lancer l'analyse

Cliquez sur le bouton "Lancer l'analyse" (bleu).

La barre de progression affiche l'avancement en temps réel :

Frame 1500/3600 — 41%

Pour interrompre à tout moment, cliquez sur "Annuler" (rouge).

Étape 4 — Lire les résultats

Une fois l'analyse terminée, trois zones s'affichent :

• Bannière colorée : résultat global (vert / orange / rouge)
• Informations vidéo : durée, FPS, frames, fréquence max
• Liste des événements : timestamp précis de chaque séquence problématique

Étape 5 — Exporter le rapport (optionnel)

Cliquez sur l'icône 💾 dans la barre de titre pour sauvegarder un rapport JSON complet.

---

8. Comprendre les résultats

Niveaux de risque

Résultat	Couleur	Signification
✅ PASS	Vert	Aucun flash problématique. Conforme WCAG 2.3 / Harding
⚠️ WARNING	Orange	Fréquence proche du seuil (> 2,4 Hz). Vérification manuelle conseillée
❌ FAIL	Rouge	Séquences dangereuses détectées. Modification de la vidéo recommandée

Informations affichées

Champ	Description
Durée	Durée totale de la vidéo en secondes
FPS	Nombre d'images par seconde
Frames totales	Nombre total de frames analysées
Fréq. flash maximale	Fréquence de flash la plus élevée observée (Hz). En rouge si > 3 Hz

Liste des flashs généraux

Chaque ligne correspond à une séquence dépassant 3 flashs/seconde :

⏱  12.34 s   —   4 flashs/seconde
⏱  45.10 s   —   5 flashs/seconde

Liste des flashs rouges

Chaque ligne correspond à une apparition soudaine de rouge saturé sur ≥ 25 % de l'image :

⏱  8.20 s   —   Rouge saturé ≥ 25 % de l'image

Le rouge est traité séparément car il est deux fois plus dangereux selon le critère Harding.

---

9. Format du rapport JSON

Le rapport exporté contient :

{
  "risk_level": "FAIL",
  "fps": 25.0,
  "total_frames": 3750,
  "duration_s": 150.0,
  "max_flash_freq": 5.0,
  "flash_events": [
    {
      "time_s": 12.34,
      "freq_hz": 4,
      "delta_luma": 0.1842
    }
  ],
  "red_flash_events": [8.2, 34.56]
}

Champ	Type	Description
risk_level	string	"PASS", "WARNING" ou "FAIL"
fps	float	FPS de la vidéo source
total_frames	int	Nombre de frames analysées
duration_s	float	Durée en secondes
max_flash_freq	float	Fréquence de flash maximale observée (Hz)
flash_events	array	Liste des séquences dépassant 3 Hz
flash_events[].time_s	float	Timestamp en secondes
flash_events[].freq_hz	int	Fréquence en flashs/seconde à ce moment
flash_events[].delta_luma	float	Variation de luminance relative déclenchante
red_flash_events	array	Timestamps des flashs rouges (secondes)

---

10. Compiler un exécutable

Linux — PyInstaller

pip install pyinstaller --break-system-packages
pyinstaller --onefile --name "E2py" e2py.py
# Résultat : dist/E2py

La machine cible doit avoir GTK4 installé : sudo apt install libgtk-4-1 libadwaita-1-0

Windows — PyInstaller via MSYS2

Dans le terminal MSYS2 :

pip install pyinstaller
pyinstaller --onefile --windowed --name "E2py" e2py.py
# Résultat : dist/E2py.exe

---

11. Limites et avertissements

• Cet outil est indicatif, pas certifié. Il ne remplace pas le Harding PSE Analyser officiel.
• La détection repose sur la luminance moyenne de la frame entière. Les flashs localisés sur une petite zone (< 25 % de l'écran) ne sont pas signalés, conformément à WCAG 2.3.1.
• Les vidéos à très bas FPS (< 10 fps) peuvent produire des résultats moins précis.
• Les codecs rares ou fichiers corrompus peuvent échouer à l'ouverture.
• Pour une certification officielle (diffusion TV, plateformes, cinéma) : hardingfpa.tv

12. FAQ

Question	Réponse
Ça marche pas, c’est normal ?	Oui. C’est probablement la faute à ton PC. Ou à toi. Ou aux deux.
Pourquoi c’est lent ?	Parce que ta vidéo est en 4K, ou que ton CPU a 10 ans. Ou les deux.
Je peux vendre ce code ?	Bien sûr ! Mais si tu deviens riche, invite-moi un café. (Ou pas.)
C’est sûr à 100% ?	Non. Rien ne l’est. Même pas la mort. (Désolé pour le spoil.)
Je peux l’utiliser pour pirater ?	Techniquement oui, mais zeima te regarde avec déception. (Et le FBI aussi.)
Je peux modifier le code ?	DO WHAT THE FUCK YOU WANT TO. (Mais assume les conséquences.)
C’est compatible Mac ?	Peut-être. Essaye et dis-moi. (Ou pas.)
Pourquoi ce nom, "E2py" ?	Parce que "EpilepsyDetector3000" était déjà pris. (Et trop long à taper.)
Je peux en faire un chapeau ?	Oui. Mais envoye une photo. (Pour la science.)

---

---

🇬🇧 English version

Table of contents

1. About
2. Standards applied
3. Detection rules
4. System requirements
5. Installation
6. Running the app
7. Step-by-step usage
8. Understanding results
9. JSON report format
10. Building an executable
11. Limitations and disclaimer
12. Q/A

---

1. About

E2py is a GTK4 desktop application that analyses a video frame by frame to detect sequences likely to trigger photosensitive epileptic seizures.

It detects:

• Luminance flashes exceeding the critical frequency of 3 Hz
• Transitions to saturated red at high contrast
• Flashing areas covering ≥ 25 % of the image

The interface supports French and English, switchable at any time.

⚠️ This tool is indicative. For official certification (broadcast TV, cinema, advertising), use the accredited Harding PSE Analyser: hardingfpa.tv

---

2. Standards applied

Standard	Description	Link
WCAG 2.1 SC 2.3.1	"Three Flashes or Below Threshold" criterion	w3.org
ITU-R BT.1702	Guidance for reduction of photosensitive epileptic seizures	itu.int
Harding PSE Criteria	Industry standard (BBC, ITV, Ofcom) — red threshold halved	hardingfpa.tv

---

3. Detection rules

Rule 1 — General flash (WCAG 2.3.1 + ITU-R BT.1702)

• A flash = dark→light or light→dark transition with relative luminance change ≥ 10 %
• Luminance computed in linearised sRGB: L = 0.2126·R + 0.7152·G + 0.0722·B
• > 3 flashes per second over a rolling 1-second window = RISK
• The flashing area must cover ≥ 25 % of the image to be counted

Rule 2 — Saturated red flash (Harding)

• Detection in HSV space: hue H ∈ [0°–10°] or [160°–180°], saturation S ≥ 100/255, value V ≥ 100/255
• A transition to red covering ≥ 25 % of the frame = HIGH RISK
• Red is considered twice as dangerous as other colours under the Harding standard

Rule 3 — Time window

• Counting uses a strict rolling 1-second window, purged frame by frame
• Fully compliant with Harding and WCAG specifications

---

4. System requirements

Linux (Ubuntu 22.04+ / Debian 12+ / Fedora 38+)

# Ubuntu / Debian
sudo apt install python3 python3-pip python3-gi python3-gi-cairo gir1.2-gtk-4.0 gir1.2-adw-1

# Fedora
sudo dnf install python3 python3-pip python3-gobject gtk4 libadwaita

Windows

GTK4 is not native on Windows. Install MSYS2 (msys2.org), then in the MSYS2 terminal:

pacman -S mingw-w64-x86_64-python  mingw-w64-x86_64-python-pip  mingw-w64-x86_64-python-gobject mingw-w64-x86_64-gtk4 mingw-w64-x86_64-libadwaita  mingw-w64-x86_64-opencv  mingw-w64-x86_64-python-numpy

Python dependencies (auto-installed)

The following Python packages are installed automatically on first launch if missing:

Package	Min version	Role
opencv-python	4.x	Video decoding, HSV processing
numpy	1.21+	Matrix calculations (luminance)

---

5. Installation

No installation needed. Just download the single file:

e2py.py

Then run it directly (see next section).

---

6. Running the app

python3 e2py.py

On first launch, if opencv-python or numpy are missing, the script installs them automatically via pip. A message is shown in the terminal:

[auto-install] Missing packages: opencv-python
[auto-install] ✅  opencv-python installed.

If automatic installation fails (system-managed Python environment):

pip3 install opencv-python numpy --break-system-packages

---

7. Step-by-step usage

Step 1 — Select the video

Click "Browse" or the 📂 icon in the title bar to open the file picker.

Supported formats: MP4, MKV, AVI, MOV, WEBM, FLV, WMV, TS, M4V

The filename and path appear in the selection area.

Step 2 — Choose language (optional)

Use the 🇫🇷 FR / 🇬🇧 EN buttons in the top-right corner to switch the interface language.

Step 3 — Start the analysis

Click the "Start analysis" button (blue).

The progress bar updates in real time:

Frame 1500/3600 — 41%

To stop at any time, click "Cancel" (red).

Step 4 — Read the results

Once analysis is complete, three sections appear:

• Coloured banner: overall result (green / orange / red)
• Video information: duration, FPS, frames, max frequency
• Event list: precise timestamp of each problematic sequence

Step 5 — Export the report (optional)

Click the 💾 icon in the title bar to save a complete JSON report.

---

8. Understanding results

Risk levels

Result	Colour	Meaning
✅ PASS	Green	No problematic flashes. Compliant with WCAG 2.3 / Harding
⚠️ WARNING	Orange	Frequency near threshold (> 2.4 Hz). Manual review recommended
❌ FAIL	Red	Dangerous sequences detected. Video modification recommended

Displayed information

Field	Description
Duration	Total video duration in seconds
FPS	Frames per second
Total frames	Total number of frames analysed
Max flash frequency	Highest observed flash frequency (Hz). Shown in red if > 3 Hz

General flash list

Each row represents a sequence exceeding 3 flashes/second:

⏱  12.34 s   —   4 flashes/second
⏱  45.10 s   —   5 flashes/second

Red flash list

Each row represents a sudden appearance of saturated red covering ≥ 25 % of the frame:

⏱  8.20 s   —   Saturated red ≥ 25 % of frame

Red is handled separately because it is twice as dangerous under the Harding criterion.

---

9. JSON report format

The exported report contains:

{
  "risk_level": "FAIL",
  "fps": 25.0,
  "total_frames": 3750,
  "duration_s": 150.0,
  "max_flash_freq": 5.0,
  "flash_events": [
    {
      "time_s": 12.34,
      "freq_hz": 4,
      "delta_luma": 0.1842
    }
  ],
  "red_flash_events": [8.2, 34.56]
}

Field	Type	Description
risk_level	string	"PASS", "WARNING" or "FAIL"
fps	float	Source video FPS
total_frames	int	Number of frames analysed
duration_s	float	Duration in seconds
max_flash_freq	float	Maximum observed flash frequency (Hz)
flash_events	array	List of sequences exceeding 3 Hz
flash_events[].time_s	float	Timestamp in seconds
flash_events[].freq_hz	int	Flash frequency at that moment
flash_events[].delta_luma	float	Triggering relative luminance variation
red_flash_events	array	Red flash timestamps (seconds)

---

10. Building an executable

Linux — PyInstaller

pip install pyinstaller --break-system-packages
pyinstaller --onefile --name "E2py" e2py.py
# Output: dist/E2py

Target machine must have GTK4: sudo apt install libgtk-4-1 libadwaita-1-0

Windows — PyInstaller via MSYS2

In the MSYS2 terminal:

pip install pyinstaller
pyinstaller --onefile --windowed --name "E2py" e2py.py
# Output: dist/E2py.exe

---

11. Limitations and disclaimer

• This tool is indicative, not certified. It does not replace the official Harding PSE Analyser.
• Detection is based on the average luminance of the full frame. Flashes localised to a small area (< 25 % of screen) are not flagged, in accordance with WCAG 2.3.1.
• Videos with very low FPS (< 10 fps) may produce less accurate results.
• Unusual codecs or corrupted files may fail to open.
• For official certification (broadcast TV, streaming platforms, cinema): hardingfpa.tv

12.Q/A

Question	Answer
Is it not working? Is that normal?	Yes. It’s probably your PC’s fault. Or yours. Or both.
Why is it so slow?	Because your video is in 4K, or your CPU is 10 years old. Or both.
Can I sell this code?	Of course! But if you get rich, buy me a coffee. (Or don’t.)
Is it 100% reliable?	No. Nothing is. Not even death. (Sorry for the spoiler.)
Can I use it for hacking?	Technically yes, but zeima is judging you. (And so is the FBI.)
Can I modify the code?	DO WHAT THE FUCK YOU WANT TO. (But own the consequences.)
Is it Mac-compatible?	Maybe. Try it and let me know. (Or don’t.)
Why the name "E2py"?	Because "EpilepsyDetector3000" was already taken. (And too long to type.)
Can I turn it into a hat?	Yes. But send a photo. (For science.)
What’s the answer to everything?	42, but I’m not Mistral, let alone Claude.

---

Licence / License

Ce projet est distribué sous licence WTFPL. This project is distributed under the WTFPL licence. Read the license thank you

---

Références / References : WCAG 2.1 — https://www.w3.org/TR/WCAG21/#three-flashes-or-below-threshold ITU-R BT.1702 — https://www.itu.int/rec/R-REC-BT.1702/en Harding PSE Analyser — https://www.hardingfpa.tv