Guide d’utilisation d’Annotate

Annotate est une application locale d’analyse vidéo de football. Un projet contient les vidéos importées, les clips capturés, les repères, les données d’annotation, les présentations, les exports, les caches et une corbeille récupérable.

Les annotations de clip sont des objets à images clés affichés sur la vidéo. Les annotations de repère sont des documents rattachés à une image précise de la source et peuvent comporter des animations d’entrée. Le suivi génère les images clés des surlignages, et l’homographie fournit des coordonnées terrain pour les rectangles et les cercles.

Les données sont enregistrées dans le dossier du projet choisi. L’application communique avec un service Python sur le même ordinateur pour l’import vidéo, le suivi, l’homographie et l’export. Les versions de bureau incluent et gèrent ce service ; en développement dans le navigateur, il est lancé séparément.

Téléchargez le DMG pour Mac ou l’installeur Windows depuis les versions GitHub. Sur macOS, ouvrez le DMG et faites glisser Annotate dans Applications. Sur Windows, lancez l’installeur puis ouvrez Annotate depuis son raccourci sur le bureau. Les versions ciblent les Mac Apple Silicon sous macOS 14 ou plus récent, et Windows 10/11 x64.

Ce sont des versions d’évaluation non signées, même lorsque GitHub indique « Latest ». Le système peut demander une autorisation ; ne désactivez pas ses protections. Python, les outils vidéo et les modèles sont inclus. Aucun terminal ni navigateur séparé n’est nécessaire. Les services démarrent et s’arrêtent avec l’application ; le premier lancement peut être plus long le temps que les bibliothèques s’initialisent.

Les journaux des services se trouvent dans ~/Library/Application Support/Annotate/logs/services.log sur macOS et %APPDATA%\Annotate\logs\services.log sur Windows. Les éditeurs de clip et de repère s’ouvrent dans des fenêtres séparées.

Le développement dans le navigateur reste possible avec Chrome, Edge, Brave, Arc ou Chromium ; Safari et Firefox ne peuvent pas accorder l’accès nécessaire au dossier du projet. L’ancien installeur pour navigateur et ses instructions se trouvent dans le dossier legacy/browser-install du dépôt.

Le tableau de codage est une surface de travail fixe, pas un menu. Cliquez une fois sur une tuile pour démarrer un clip, puis à nouveau sur la même tuile pour le terminer. Une tuile en cours d’enregistrement affiche un point rouge et l’image de départ, et le clip en cours apparaît sur la frise avant d’être terminé. Des clips de types différents peuvent se chevaucher.

Les modificateurs ajoutent des détails structurés à la capture démarrée en dernier : choisissez-les pendant que cette capture est en cours. Leur disponibilité dépend de la tuile, mais le tableau reste en place. Il n’y a pas de marge automatique avant ou après : les images où vous cliquez deviennent les limites du clip.

Cliquez sur un clip dans la frise ou la liste pour le sélectionner et aller à son début. En pause, choisissez Recoder la sélection, puis les modificateurs et la nouvelle tuile ; le clip garde ses images et passe dans le nouveau groupe de la liste. Vous pouvez aussi faire glisser un clip sur un autre groupe. Ouvrir l’éditeur ouvre le clip, ou l’affiche s’il est déjà ouvert, dans une fenêtre séparée.

La frise de capture sépare les groupes en pistes et range les chevauchements dans des sous-pistes. Cliquez ou faites glisser pour vous déplacer, faites défiler horizontalement pour avancer dans le temps et utilisez le curseur de zoom pour passer de l’image près au match entier. Un défilement manuel suspend le suivi automatique de la tête de lecture pendant cinq secondes.

Le tableau intégré suit la langue choisie dans l’en-tête. Les tableaux personnalisés gardent leurs propres libellés. Changer de langue ne renomme pas les clips enregistrés et n’annule pas les captures en cours.

L’éditeur de clip réunit la vidéo d’origine, les objets tactiques animés, un inspecteur de propriétés et une frise d’images clés à l’image près. La lecture ne sort jamais des limites actuelles du clip.

Dessiner un objet crée sa première image clé de position à l’image courante. Avancez avec les boutons image par image ou cliquez sur la frise pour aller à une autre image, puis déplacez, redimensionnez ou faites pivoter l’objet : Annotate ajoute une image clé et interpole entre elles. Cliquez sur une image clé pour revenir à son image ; les modifications faites là changent cette image clé au lieu d’en ajouter une.

La couleur, la largeur du trait, l’opacité du remplissage, le motif, le nom et les autres propriétés de style appartiennent à l’objet entier et s’appliquent à toutes les images. Avec Sélection, cliquez sur un objet ou faites glisser sur une zone vide pour une sélection rectangulaire. Maj-clic ajoute des objets, dans la vidéo comme dans la liste, et les changements dans l’inspecteur s’appliquent alors à tous. Cmd-clic sur macOS ou Ctrl-clic sur Windows retire des objets. Fusionner les objets est disponible pour des objets du même type dont les images clés de position ne se chevauchent pas.

Choisissez Rogner et faites glisser l’une ou l’autre poignée vers l’intérieur. Le résumé indique combien de repères, d’images clés et d’objets le rognage retirerait. Appliquer valide les nouvelles limites et Annuler les laisse intactes. Annuler le rognage rétablit les limites précédentes tant qu’aucune autre modification n’a été faite. Le rognage ne fait que raccourcir un clip ; il ne peut pas l’étendre au-delà de ses limites d’origine.

Quand la continuité est perdue, le surlignage suivi se masque et les candidats provisoires réapparaissent. Sélectionnez le bon candidat et choisissez Continuer ; Annotate comble l’intervalle et reprend. Si le bon joueur n’est pas détecté sur cette image, avancez image par image jusqu’à ce qu’il le soit, puis continuez. Il faut parfois le faire plusieurs fois.

Si le suivi est passé sur le mauvais joueur, relisez jusqu’au changement, revenez à la dernière image correcte et choisissez Refaire le suivi d’ici. Sélectionnez le bon joueur et continuez. Terminer remplace la fin de l’ancien suivi ; Annuler conserve l’original.

Le suivi utilise les coordonnées de l’image et ne nécessite pas d’homographie. Les identifiants du suivi indiquent une continuité, pas l’identité d’un joueur : attendez-vous à corriger des suivis lors des chevauchements, des changements de plan et des sorties du cadre.

Sélectionnez un surlignage et saisissez le nom du joueur dans Nom. Cochez Afficher le nom pour l’afficher sur la vidéo et ajustez Taille du texte si besoin. Le nom sert aussi d’étiquette à l’objet dans la frise.

Flèche, Passe lobée, Zone d’ombre et Polygone peuvent se rattacher aux surlignages. Avec Flèche, cliquez sur un surlignage puis sur un autre : les deux extrémités sont rattachées, et la flèche suit les joueurs pendant leur déplacement sans être redessinée.

Un repère marque une image précise dans un clip. Choisissez Ajouter un repère dans l’éditeur de clip pour ouvrir le repère dans sa propre fenêtre, sur cette image. L’éditeur de repère utilise les mêmes outils de dessin que l’éditeur de clip, et une flèche tracée d’un surlignage à un autre reste rattachée aux deux. Choisissez Enregistrer, puis Fermer le repère pour revenir au clip.

Maintenez ← ou → pour voir jusqu’à cinq secondes de vidéo autour du repère ; les annotations se masquent et l’édition est verrouillée hors de l’image du repère. Espace revient à l’image modifiable. Un repère peut aussi contenir plusieurs jeux d’annotations nommés quand un même moment demande d’autres explications, et Importer dans le clip copie le jeu actif dans le clip à l’image du repère.

Ouvrez Animations dans l’éditeur de repère, sélectionnez une forme et choisissez Ajouter. Chaque étape a un effet (Apparition, Fondu, Agrandissement ou Balayage) et un déclenchement : Au clic, Avec la précédente ou Après la précédente, avec un délai et une durée réglables. Par défaut : Fondu, Au clic. Les formes sans étape sont visibles dès le début. Aperçu puis Suivant parcourent la séquence.

Quand un clip est lu jusqu’à un repère animé, la lecture s’arrête au repère avec les formes animées masquées. Lire, Espace ou un clic sur la vidéo déclenche chaque étape au clic, et le clic suivant après la dernière étape reprend le clip.

Pour dessiner sur le terrain lui-même, le clip a besoin d’une homographie. Choisissez Calculer H. La barre de progression montre le chargement des modèles, puis la calibration d’images échantillons réparties sur tout le clip ; le premier calcul après le démarrage de l’application est plus long. Annuler s’arrête sans remplacer un résultat existant. Les résultats sont mis en cache, et Recalculer H les remplace.

Afficher H superpose la grille du terrain pour la comparer aux lignes. Quand une homographie est disponible, Rectangle et Cercle dessinent sur le terrain (Dessin : terrain) : ils prennent la perspective du terrain, leurs poignées se déplacent sur le terrain, et ils restent sur la même zone de pelouse quand la caméra bouge. Les formes dessinées en coordonnées image restent au contraire fixes à l’écran.

Supprimer H retire l’homographie et revient au dessin en coordonnées image. La calibration d’un repère propose le même calcul automatique et, en secours, H manuelle pour une seule image. Le suivi n’a pas besoin d’homographie.

Créez une présentation depuis la page du projet : saisissez un nom, choisissez Créer, puis Ouvrir. L’espace de création comprend un navigateur de sources, un aperçu, une suite horizontale de diapositives et un inspecteur.

Cliquez sur une source pour la prévisualiser ; rien n’est ajouté tant que vous ne la faites pas glisser dans la présentation. Développez les repères d’un clip pour en faire glisser un comme diapositive. Utilisez Ajouter un titre pour les titres, sections ou séparateurs, et faites glisser les miniatures pour les réordonner. Sélectionnez une diapositive de clip pour choisir à quels repères elle s’arrête.

Présenter masque l’interface d’édition et occupe toute la fenêtre. Les diapositives de clip lisent la vidéo d’origine avec leurs annotations animées et s’arrêtent aux repères choisis ; les clics révèlent les étapes d’animation avant que le clip reprenne ou que la présentation avance. Coupe passe directement à la diapositive suivante, et Vidéo du match est disponible entre des repères de la même vidéo dans l’ordre chronologique.

Exporter le rapport… sur la page du projet écrit clips.csv, clips.json et une image PNG à la résolution de la vidéo pour chaque jeu d’annotations de repère, dans le dossier du projet sous exports/report/. Les PNG montrent l’annotation complète, pas un instant d’une animation.

Pour retirer un clip, sélectionnez-le dans le lecteur de capture et choisissez Supprimer le clip. Les clips, repères et jeux d’annotations supprimés sont d’abord copiés dans .trash/ ; utilisez aussitôt Annuler la suppression pour en restaurer un. Vider la corbeille efface définitivement les données de récupération conservées.

Pour retirer une vidéo, utilisez Supprimer à côté d’elle sur la page du projet et confirmez avec Supprimer la vidéo et les clips. Cela supprime définitivement la copie de la vidéo dans le projet ainsi que tous ses clips, repères et jeux d’annotations. Le fichier d’origine et les présentations ne sont pas modifiés ; les diapositives concernées signalent des sources manquantes. La suppression d’une vidéo ne peut pas être annulée.

Le rapport d’intégrité de la page du projet liste les médias manquants, les documents illisibles et les références de présentation non résolues. Il sert au diagnostic : Annotate ne devine pas comment réécrire votre travail. Pour tout protéger, sauvegardez le dossier du projet en entier.

Flèche, Passe lobée, Zone d’ombre et chaque sommet d’un Polygone peuvent se rattacher aux surlignages. Une forme rattachée suit son surlignage, que son mouvement soit manuel ou issu du suivi. Seuls Rectangle et Cercle utilisent les coordonnées terrain ; les autres outils restent en coordonnées image.

Un projet est un dossier ordinaire. Son manifeste est project.json ; les médias source sont dans media/ ; les clips et leurs documents d’annotation sont dans analysis/ ; les présentations, exports, caches et la corbeille ont leurs propres dossiers.

Ne renommez pas et ne déplacez pas les fichiers internes quand un projet est ouvert. Pour sauvegarder ou déplacer un projet, fermez-le et copiez le dossier entier. Les vidéos sont copiées dans le projet : prévoyez la place pour le fichier source et sa copie pendant l’import.

Les projets Annotate 0.2 utilisent le modèle project.v2 et ne sont pas compatibles avec Annotate 0.1. Gardez une installation 0.1 pour les anciens projets.