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 avec vMix, 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 graphiques et titres (GT) de vMix 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 vMix : export JSON et API compatibles avec les titres GT de vMix (mise à jour directe sans datasource)
• 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 vMix même lorsqu'il est sur une autre machine via l’API réseau
• 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 de l'export lien¶

Le fichier export-vmix.json contient plus de 2000 variables organisées en catégories :

Variables système¶

• STATUS : État du système (3 = actif)
• ERROR : Messages d'erreur
• MESSAGE : Messages d'information

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 (E1/E2)¶

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

Joueurs (1-21 par équipe)¶

• Informations personnelles : Nom, prénom, numéro
• Position : Poste de jeu
• Sanctions : Cartons et avertissements
• Images : Photos des joueurs

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",
  "VILLE": "SAINT-BRIEUC",
  "STADE": "STADE FRED-AUBERT",
  "E1NOM_FULL": "STADE BRIOCHIN",
  "E1NOM_BUG": "SB",
  "E2NOM_FULL": "FC VERSAILLES",
  "E2NOM_BUG": "FCV",
  "E1SCORE": "0",
  "E2SCORE": "1",
  "E1FORMATION": "3-5-2",
  "E2FORMATION": "3-5-2"
}

Organisation de la documentation¶

Cette documentation est organisée en plusieurs sections :

1. Variables vMix : référence complète des variables par discipline (basketball, football, futsal, hockey, tennis)
2. Software : configuration d’AppSport (config.appsport) et automatisations
3. Interface : écrans de configuration (championnat, club, company, permissions)
4. OCR & workflow de composition : feuille de match, cadrage, guides de lignes, revue, ajout de joueur, quota
5. Guides d’intégration : connexion vMix et bonnes pratiques GT-title
6. Support : FAQ et résolution de problèmes courants

Navigation rapide par sport¶

• Basketball
• Football
• Futsal
• Hockey sur glace
• Tennis

Technologies utilisées¶

• Format de données : JSON
• Intégration vidéo : vMix (Graphics Titles)
• Chemins d'images : Windows (C:/)
• Encodage : UTF-8 pour les caractères spéciaux

Configuration requise¶

Système¶

• Windows (chemins compatibles C:/)
• vMix (version compatible GT)
• Accès réseau pour la synchronisation des données

Structure des fichiers¶

Votre Projet/
├── Config.appsport
├── SOURCE/
│   ├── vmix.config
│   ├── MonvMix.vmix
│   ├── IMAGES/
│   │   ├── PICTO_METEO/
│   │   ├── BG_BUT/
│   │   ├── PROGRAMME/
│   │   ├── BG_VS/
│   │   ├── RESULTAT/
│   │   └── BG_CG/
│   └── LOGO_EQUIPE/
│       ├── /logo_equipe1
│       │   └── 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
├─── cache/ 
└── LIVE/

Nouveautés 2026¶

• Support multi-sports consolidé (football, futsal, hockey, basketball, tennis) avec variables dédiées.
• API réseau pour piloter vMix à distance (même machine ou serveur séparé).
• Générateur AppSport enrichi pour cloner les projets vMix/Premiere et injecter les assets automatiquement.
• Import de composition par OCR avec cadrage manuel, guides de lignes et revue avant application.
• Quota d'import de composition par OCR affiché côté company, avec consommation uniquement à la validation finale.
• Sécurisation renforcée des fichiers servis par le championnat et meilleure homogénéisation des messages d’erreur côté interface.

Mise en route rapide¶

1. Installation : déployez les fichiers dans le répertoire du projet, installez AppSport et vMix.
2. Configuration vMix : importez les titres GT correspondant aux variables et vérifiez que l’API est activée.

Support et maintenance¶

Fichiers principaux¶

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

Convention de nommage¶

Tous les noms de variables dans le JSON correspondent exactement aux titres GT à créer dans vMix. Cette correspondance est critique pour le bon fonctionnement du système.

Version du projet : MY-LIVE-SPORT v1.2.3 Dernière mise à jour : Mars 2026 Compatibilité : vMix 26+, Windows 10/11