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, 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
• 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 :

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

Navigation rapide par sport¶

• Socle général live output v2
• Basketball v2
• Football v2
• Futsal v2
• Hockey sur glace v2
• Tennis v2

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.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¶

1. Installation : préparez le projet dans AppSport et installez le moteur de sortie utilisé en production.
2. 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.0.0 Dernière mise à jour : 7 mai 2026 Compatibilité : vMix 26+, CasparCG via AppSport, Windows 10/11