MY-LIVE-SPORT - Documentation¶

Vue d'ensemble du projet¶

MY-LIVE-SPORT est une solution complète de diffusion en direct pour les matchs sportifs (basketball, football, futsal, handball, hockey, tennis), intégrant un système de données dynamiques pour vMix et CasparCG, un workflow d'import de composition par OCR à partir d'une feuille de match et des outils collaboratifs pour la production vidéo en temps réel.

À propos du système¶

Ce projet fournit une interface de données pour alimenter les habillages live vMix ou CasparCG lors de retransmissions sportives en direct. Il permet l'affichage automatisé d'informations de match, statistiques joueurs, formations tactiques et données météorologiques.

Fonctionnalités principales¶

Intégration live output : export JSON, mapping de champs d'habillage, vMix Link et contrôle CasparCG via AppSport
Données de match en temps réel : scores, temps de jeu, événements, programmes et historiques
Gestion des équipes : informations complètes sur les clubs et joueurs, multi-sports
Formations tactiques : support de multiples schémas (3-4-3, 3-5-2, 4-3-3, etc.)
Interface météo : affichage des conditions climatiques du stade
Automations AppSport : duplication/paramétrage de projets vMix et Premiere Pro via config.appsport
Contrôle distant : pilotage d'un client AppSport connecté à vMix ou CasparCG depuis un navigateur
table de marque : Récupération de table de marque Bodet (beta, non conseillée en production)
Import de composition par OCR : lecture de compositions depuis photo/scan de feuille de match, revue avant insertion et consommation du quota à la validation finale uniquement
Collaboration temps réel : synchronisation des opérations clés pour réduire les écarts entre opérateurs sur un même match

Structure des variables lien ¶

La sortie live output contient plus de 2000 variables organisées en catégories :

Variables système¶

STATUS : état brut du match
ERR_MSG : messages d'erreur
MSG : messages d'information ou message championnat

Données de match¶

Informations générales : Date, ville, stade
Scores : Résultats en temps réel des deux équipes
Météo : Conditions climatiques avec icônes

Équipes (T1/T2)¶

Identité : Noms complets, abréviations, logos
Classement : Position dans le championnat
Formation : Schéma tactique utilisé

Joueurs et staff¶

Joueurs T1/T2 : titulaires du sport + max_substitutes + 5 slots de sécurité
Staff T1/T2 : nombre de slots basé sur max_staff
Informations personnelles : Nom, prénom, numéro, poste
Images : Photos des joueurs ou image vide

Formations tactiques¶

Support de 11 formations différentes avec positionnement des joueurs : - 3-4-3, 3-5-2, 4-3-3, 4-5-1, 5-3-2 - 3-4-2-1, 4-1-4-1, 4-2-3-1, 4-2-1-2-1 - 4-4-2 Trapèze, 4-4-2 Losange

Exemple de données¶

{
  "STATUS": 3,
  "DATE": "Vendredi 8 août 2025",
  "CITY": "SAINT-BRIEUC",
  "STADIUM": "STADE FRED-AUBERT",
  "T1_NAME": "STADE BRIOCHIN",
  "T1_SHORT": "SB",
  "T2_NAME": "FC VERSAILLES",
  "T2_SHORT": "FCV",
  "T1_SCORE": "0",
  "T2_SCORE": "1",
  "T1_FORM": "3-5-2",
  "T2_FORM": "3-5-2"
}

Organisation de la documentation¶

Cette documentation est organisée en plusieurs sections :

Variables live output : référence complète des variables par discipline (basketball, football, futsal, handball, hockey, tennis)
Software : configuration d’AppSport (config.appsport), vMix, CasparCG et automatisations
Interface : écrans de configuration (championnat, club, company, permissions)
Pilotage live : contrôle distant, tally, chrono, scroll score et alertes
OCR & workflow de composition : feuille de match, cadrage, revue, ajout de joueur, quota
Exploitation : sources de données, pilotage live et release notes
Support : FAQ et résolution de problèmes courants

Technologies utilisées¶

Format de données : JSON
Intégration vidéo : vMix, CasparCG (beta)
Chemins d'images : Windows
Encodage : UTF-8 pour les caractères spéciaux

Configuration requise¶

Système¶

Windows
vMix, CasparCG (beta)
Accès réseau pour la synchronisation des données

Structure des fichiers¶

Votre Projet/
├── Config.appsport
├── SOURCE/
│   ├── vmix.config
│   ├── MonvMix.vmix
│   ├── TEMPLATES
    │   └── Template.gtzip
│   ├── IMAGES/
│   │   ├── WEATHER/
│   │   ├── GOALS/
│   │   ├── SCHEDULE/
│   │   ├── VERSUS/
│   │   ├── STANDINGS/
│   │   ├── RESULTS/
│   │   └── GRAPHICS/
│   └── TEAM_LOGOS/
│       ├── /`TRIGRAMME DE L'EQUIPE`
│       │   └── logo_equipe1.png (si séquence png : logo_equipe1_0001.png, logo_equipe1_0002.png, ..., avec 0001 pour le logo par défaut)
├── export-vmix.json (sortie de données live, selon le workflow utilisé)
├─── cache/ 
└── LIVE/

Nouveautés V2.1.0¶

Refonte complète de l'interface vers le socle V3 : accueil, navigation, championnats, clubs, matchs, company et contrôles live output.
Handball intégré au parcours principal : page d'accueil, liste des championnats, édition championnat, clubs et match.
Table de marque Bodet disponible en beta pour le handball et certains usages de test.
Rendu des équipes, joueurs, staff, maillots et synthés harmonisé avec l'interface V3.
Service de rendu stabilisé avec Chrome for Testing.
Améliorations UI des pages match : GT Mapping, modal vMix GT, contrastes de listes et synthés automatiques.

Table de marque en beta

L'intégration table de marque reste expérimentale en V2.1.0. Elle n'est pas conseillée en production. Utilisez-la uniquement sur un match de test ou une répétition, avec un opérateur capable de reprendre la main manuellement.

Rappel V2.0.0¶

Support live output consolidé : vMix, CasparCG, séquences de boutons et contrôle distant via AppSport.
Programme du jour amélioré : scroll score, alertes et fenêtre journée précédente/courante/suivante.
Suggestions de compétitions et météo pour accélérer la configuration championnat.
Variables live output enrichies : staff séparé, remplaçants dynamiques et mouvements de classement.
Import de composition par OCR plus prudent : rapprochement automatique, revue utilisateur, limites image et fichiers protégés.

Consultez la liste des releases pour le détail des versions disponibles.

Mise en route rapide¶

Installation : préparez le projet dans AppSport et installez le moteur de sortie utilisé en production.
Configuration live output : reliez les champs de vos titres vMix ou templates CasparCG aux variables MY-LIVE-SPORT.

Support et maintenance¶

Fichiers principaux¶

EMPTY.png : Image par défaut pour les champs vides

Convention de nommage¶

Tous les noms de variables doivent correspondre exactement aux champs de l'habillage live. Cette correspondance est critique pour le bon fonctionnement du système.

Version du projet : MY-LIVE-SPORT V2.1.0 Dernière mise à jour : 5 juillet 2026 Compatibilité : vMix 26+, CasparCG via AppSport, Windows 10/11