v1.3.0 — Lunar eclipses, total solar eclipses, and a visual crop frame

The headline: Eclipse Cleaner now handles lunar eclipses, total solar eclipses and planetary footage — every new capability in this release was driven by user reports and shared footage. Thank you all.

Eclipse types

• Presets sun / moon / planetary / custom — the type of eclipse is detected automatically when a video is analyzed (and always overridable, from the page or with --preset). A preset picks the measurement strategies, not just thresholds: lit-region detection, radius estimation by vote-peak scan, and the Hough-vote regime.
• Lunar eclipses — calibrated on real Seestar lunar timelapses kindly shared by users: a video that used to crash the tool with "Aucune mesure valide" now tracks 100 % of its frames. See the new before/after comparison in the README.
• Total solar eclipses — totality (dark disc ringed by the corona) used to defeat the tracker entirely. A dark-disc vote regime now locks the lunar silhouette, one radius is measured per regime (in a total eclipse the Moon's apparent disc is larger than the Sun's), and regime switching uses hysteresis so nothing flickers at the contacts.
• The custom preset reproduces the previous behavior exactly (verified bit-identical on the reference sequence). Existing analyses are re-run once on first open — cache format v8 — and your manual review decisions survive.

Viewer

• Crop frame — the crop window is drawn right on the current frame (its crosshair marks the tracked disc center) and can be resized with the mouse to trade field of view against stabilization margin; ↺ returns to the recommended size, the choice is remembered per video, and the render uses it. Visual design follows @mireianievas' ROI prototype (#1).
• Raw-video player — a collapsible player with play/pause/stop/timeline to watch the source itself, plus a clear loading state while a newly picked video is probed.
• One work folder per video — the analysis cache, review decisions, thumbnails, render and PNG export now live in <video>-eclipse/ next to the source. Files left loose by earlier versions are migrated automatically (and announced) the first time the viewer opens that video.
• No more crash when no frame yields a usable position: the page explains what to try instead.

macOS

• The Browse… dialog is properly fixed: it now opens through osascript (native NSOpenPanel), off the Cocoa main-thread trap — diagnosis and route by @mireianievas (#1), hardened and integrated with co-author credit. The v1.2.2 stopgap remains only where osascript is unavailable.

Documentation

• README (EN/FR): eclipse types and presets, a preset × parameter table, documented bounds for custom analyses, the crop frame, and a lunar before/after comparison.
• Honest known limitations: brightness normalization can blow out the corona during totality, and the planetary preset has not yet been calibrated on real footage — sample videos are very welcome.

As always: Windows SmartScreen will warn on first launch (unsigned program) — More info, then Run anyway; details in the beginners guide.

---

La nouveauté : Eclipse Cleaner traite désormais les éclipses lunaires, les éclipses solaires totales et les vidéos planétaires — chaque capacité de cette version vient des retours et des vidéos partagées par les utilisateurs, merci à tous. Le type d'éclipse est détecté automatiquement (et toujours modifiable) via des presets sun / moon / planetary / custom qui choisissent les stratégies de mesure ; une vidéo lunaire qui faisait planter l'outil est maintenant suivie à 100 % (comparaison avant/après dans le README), et la totalité solaire reste verrouillée sur la silhouette lunaire, couronne stable. Le viewer gagne un cadre de recadrage redimensionnable à la souris directement sur les frames (design du prototype de @mireianievas, #1), un lecteur de la vidéo brute, et un dossier de travail unique par vidéo (<video>-eclipse/, migration automatique annoncée des anciens fichiers). Sous macOS, le bouton Parcourir… est réparé pour de bon (route osascript, diagnostic et prototype de @mireianievas). Le preset custom reproduit exactement le comportement précédent ; les analyses existantes sont refaites une fois à la première ouverture (cache v8), vos décisions de tri sont conservées. SmartScreen avertira au premier lancement : Informations complémentaires puis Exécuter quand même — détails dans le guide débutants.