# Intégration - TeamTracker

**URL:** <https://community.gladysassistant.com/t/integration-teamtracker/11063>\
**Category:** Développement\
**Tags:** integration-externe\
**Created:** [Octobre 12, 2026, 12:04 UTC](https://community.gladysassistant.com/t/integration-teamtracker/11063 "2026-10-12T12:04:44Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![prohand](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prohand/32/15713_2.png) [@prohand](https://community.gladysassistant.com/u/prohand)\
**Post date:** [Octobre 12, 2026, 12:04 UTC](https://community.gladysassistant.com/t/integration-teamtracker/11063/1 "2026-10-12T12:04:44Z")

</div>

Bonjour à tous,

Comme proposé dans le sujet [Intégrations Home Assistant les plus populaires](https://community.gladysassistant.com/t/integrations-home-assistant-les-plus-populaires-candidates-pour-des-integrations-externes-gladys/10385/35), je prends **Team Tracker** : voici une première version (bêta) de l’intégration externe pour Gladys.

Afficher l’image

## Ce que ça fait

Vous suivez vos équipes, et Gladys sait quand elles jouent, le score en direct, et quand elles marquent.

- **Un appareil par équipe** avec :
  - le score de l’équipe ;
  - le score adverse ;
  - une ligne « Match » : `En direct · 63' · PSG 2 – 1 OM`, `Terminé · PSG 2 – 1 OM · Victoire` ou `Prochain match · sam. 17 oct., 17:15 · à STR`.

- **5 déclencheurs de scène** :
  - Match bientôt (rappel X minutes avant le coup d’envoi)
  - Match commencé
  - **Mon équipe a marqué** 🎉
  - L’adversaire a marqué
  - Match terminé (filtre victoire / défaite / nul)

- **1 action de scène** : « Lire le match d’une équipe » (score, adversaire, résultat, résumé) pour annoncer le score ou changer les lumières.
- **2 widgets** :
  - « Match d’une équipe » : score en direct, chrono, coup d’envoi ;
  - « Mes équipes » : toutes vos équipes avec logo et badge DIRECT / résultat / À VENIR.

## Ligues gérées

- **Foot** : Ligue 1, Ligue 2, Coupe de France, Première Ligue, Premier League, LaLiga, Serie A, Bundesliga, Ligue des champions, Ligue Europa, Ligue Conférence, MLS, NWSL, Coupes du monde
- **Rugby** : Top 14, Six Nations, Coupe du monde
- **US** : NFL, NCAA Football, NBA, WNBA, NCAA basket, NHL, MLB
- **Et toute autre ligue d’équipes ESPN** via son chemin, par ex. `soccer/por.1:SLB` (Benfica)

Les sports individuels (tennis, golf, F1, MMA) ne sont pas gérés pour l’instant.

## Installation

- Gladys **5.1 ou plus** requis.
- Pas de compte, pas de clé d’API : les scores viennent de l’API publique d’ESPN (même source que l’intégration Home Assistant).
- Transport : **cloud** (rien sur votre réseau local).

1. Installez **Team Tracker** depuis le catalogue des intégrations.

2. Dans **Configuration** , champ **Équipes** , écrivez vos équipes sous la forme `LIGUE:ÉQUIPE` :

3. Pas sûr de l’abréviation ? Bouton **Trouver une équipe** : choisissez la ligue, tapez un bout du nom, il vous donne la ligne exacte à coller.

4. Bouton **Tester les équipes** : il dit, équipe par équipe, ce qui est suivi (et pourquoi une entrée ne l’est pas).

5. Ajoutez les appareils dans l’onglet **Découverte**.

## Exemples de scènes

- 💡 **Lumière de but** : « Mon équipe a marqué » → salon en vert 30 secondes.
- 🔔 **Rappel** : « Match bientôt » → message `{{triggerEvent.data.summary}}`.
- 🎵 **Victoire** : « Match terminé », résultat = victoire → lancer une musique.

## Bon à savoir

- Lecture toutes les **30 s pendant un match** , toutes les 15 min sinon (réglable). L’intégration se réveille toute seule pour le rappel et le coup d’envoi.
- Un but arrive donc avec jusqu’à 30 s de retard, plus le retard propre à ESPN.
- Si ESPN ne répond pas, les derniers scores restent affichés et le badge passe en « injoignable ».
- Un redémarrage pendant un match ne rejoue pas un but et n’en rate pas (dernière lecture gardée dans `/data`).

## Bêta : vos retours sont les bienvenus

L’API ESPN est gratuite mais non documentée : elle peut changer sans prévenir. Je l’ai testée sur des vraies données (Ligue 1, Top 14, NFL, NBA, NHL, MLB, Ligue des champions), mais pas encore pendant beaucoup de matchs en direct.

Dites-moi :

- si votre équipe ou votre ligue ne remonte pas ;
- si un but n’a pas déclenché la scène (ou l’a déclenchée deux fois) ;
- quelles ligues vous aimeriez voir ajoutées.

## Liens

- Code : [GitHub - prohand/gladys-teamtracker: Gladys external integration to provides real-time scores in multiple professional (NBA, NFL, NHL, MLB, MLS, and more), college (NCAA), and international (soccer, golf, tennis, mma, racing) sports using ESPN APIs.s in Gladys · GitHub](https://github.com/prohand/gladys-teamtracker)
- Documentation : [français](https://github.com/prohand/gladys-teamtracker/blob/main/docs/fr.md) · [English](https://github.com/prohand/gladys-teamtracker/blob/main/docs/en.md)
- Bugs et idées : [Issues · prohand/gladys-teamtracker · GitHub](https://github.com/prohand/gladys-teamtracker/issues)

Merci à @vasqued2 pour l’intégration Home Assistant [Team Tracker](https://github.com/vasqued2/ha-teamtracker) qui a servi d’inspiration (aucun code repris, celle-ci est écrite de zéro pour Gladys).

---

<div class="post-metadata">

**Author:** ![bertrandda](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/bertrandda/32/5929_2.png) [@bertrandda](https://community.gladysassistant.com/u/bertrandda)\
**Post date:** [Novembre 1, 2026, 5:40 UTC](https://community.gladysassistant.com/t/integration-teamtracker/11063/2 "2026-11-01T17:40:13Z")

</div>

Salut @prohand, merci c’est une super intégration.  
Je viens de faire une PR sur ton repo pour ajouter quelques championnats de rugby. Champions Cup, Challenge Cup, Nation Championship et les Tests matchs internationaux

---

<div class="post-metadata">

**Author:** ![prohand](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prohand/32/15713_2.png) [@prohand](https://community.gladysassistant.com/u/prohand)\
**Post date:** [Novembre 1, 2026, 6:05 UTC](https://community.gladysassistant.com/t/integration-teamtracker/11063/3 "2026-11-01T18:05:13Z")

</div>

Merci @bertrandda pour la PR ! 🏉

C’est fusionné et publié dans la \*\*version 1.3.0\*\*. Quatre nouveaux codes de ligue de rugby :

- `ERCC` : Champions Cup

- `ERCH` : Challenge Cup

- `NATC` : Nations Championship

- `TEST` : test matchs internationaux

Exemples : `NATC:FRA`, `TEST:FRA`, `ERCC:RAC`.

\*\*Attention aux clubs qui ont la même abréviation chez ESPN\*\* : en Champions Cup, `STA` désigne à la fois La Rochelle, le Stade Français et le Stade Toulousain. Dans ce cas, écrivez l’identifiant de l’équipe, par exemple `ERCC:25922` pour Toulouse. Le bouton \*\*Trouver une équipe\*\* vous donne directement la bonne ligne à coller.

À savoir : une même équipe suivie dans plusieurs compétitions donne un appareil par compétition (`SIXN:FRA` et `NATC:FRA` font deux appareils).

Notes de version : [Release v1.3.0 · prohand/gladys-teamtracker · GitHub](https://github.com/prohand/gladys-teamtracker/releases/tag/v1.3.0)
