Couleur Tempo EDF dans Home Assistant, Jeedom et Domoticz

Notre API JSON publique est gratuite et sans clé. Pour Home Assistant, le plus simple est notre composant, installable avec HACS. Les configurations plus bas lisent aussi l'API directement : rien à installer, aucun compte à créer.

Seule la couleur publiée par EDF fait foi. Nos prévisions couvrent les 15 prochains jours et sont indicatives : leur fiabilité est mesurée sur les prévisions faites 2 à 5 jours à l'avance (J+2 à J+5), notre zone la plus fiable ; de J+6 à J+15, elles donnent une tendance. Historique complet, erreurs comprises : historique des prévisions.

Home Assistant

Deux options : notre composant Calendrier Tempo EDF, le plus complet, ou des capteurs REST à copier, sans rien installer.

Option 1 : le composant Calendrier Tempo EDF (HACS)

Composant libre et gratuit. Il ajoute :

Chaque prévision indique sa fiabilité : officielle, zone la plus fiable ou tendance indicative. La journée Tempo va de 6 h à 6 h (heures pleines de 6 h à 22 h) : le composant donne aussi la couleur qui s'applique en ce moment, celle de la veille jusqu'à 6 h.

Prérequis : HACS installé, Home Assistant 2025.3 ou plus récent.

Ajouter à HACS

  1. Cliquez sur « Ajouter à HACS », indiquez l'adresse de votre Home Assistant si elle est demandée, puis confirmez l'ajout dans HACS.
  2. Dans HACS, cliquez sur Télécharger, puis redémarrez Home Assistant.
  3. Dans Paramètres, Appareils et services, ajoutez l'intégration Calendrier Tempo EDF. Aucun compte ni clé.

Sans HACS : téléchargez l'archive (version 0.2.0) et décompressez-la dans le dossier de configuration de Home Assistant, celui qui contient configuration.yaml : elle crée le dossier custom_components/calendrier_tempo. Redémarrez, puis ajoutez l'intégration comme ci-dessus.

Liste des entités et exemples d'automatisations : documentation complète du composant.

Option 2 : capteurs REST, sans installation

L'intégration native rest suffit. Copiez ce bloc dans configuration.yaml, puis redémarrez Home Assistant. Vous obtenez la couleur du jour et de demain, les jours rouges et blancs restants, la prévision à J+2, le prochain jour rouge (officiel ou prévu) et un capteur « prévisions 15 jours » : son état est le nombre de jours rouges sur tout l'horizon, son attribut predictions la liste complète, jour par jour.

rest:
  - resource: https://www.calendrier-tempo.fr/api/today
    scan_interval: 3600
    sensor:
      - name: "Tempo couleur du jour"
        unique_id: calendrier_tempo_jour
        value_template: "{{ value_json.couleur if value_json.status == 'ok' else 'inconnue' }}"

  - resource: https://www.calendrier-tempo.fr/api/tomorrow
    scan_interval: 1800
    sensor:
      - name: "Tempo couleur de demain"
        unique_id: calendrier_tempo_demain
        value_template: "{{ value_json.couleur if value_json.status == 'ok' else 'inconnue' }}"

  - resource: https://www.calendrier-tempo.fr/api/remaining
    scan_interval: 3600
    sensor:
      - name: "Tempo jours rouges restants"
        unique_id: calendrier_tempo_rouges_restants
        unit_of_measurement: "jours"
        value_template: "{{ value_json.remaining.ROUGE }}"
      - name: "Tempo jours blancs restants"
        unique_id: calendrier_tempo_blancs_restants
        unit_of_measurement: "jours"
        value_template: "{{ value_json.remaining.BLANC }}"

  - resource: https://www.calendrier-tempo.fr/api/predictions
    scan_interval: 3600
    sensor:
      - name: "Tempo prévision J+2"
        unique_id: calendrier_tempo_j2
        value_template: >-
          {%- set jour = (now() + timedelta(days=2)).strftime('%Y-%m-%d') -%}
          {{ value_json.predictions | selectattr('date', 'eq', jour)
             | map(attribute='couleur_predite') | first | default('inconnue') }}
      - name: "Tempo prochain jour rouge"
        unique_id: calendrier_tempo_prochain_rouge
        value_template: >-
          {{ value_json.predictions | selectattr('couleur_predite', 'eq', 'ROUGE')
             | map(attribute='date') | first | default('aucun') }}
      - name: "Tempo prévisions 15 jours"
        unique_id: calendrier_tempo_previsions_15_jours
        value_template: >-
          {{ value_json.predictions | selectattr('couleur_predite', 'eq', 'ROUGE')
             | list | count }}
        json_attributes:
          - predictions
          - generated_at

Pour un autre jour, jusqu'à J+15, dupliquez le capteur J+2 en remplaçant days=2 par le nombre de jours voulu. Les couleurs valent BLEU, BLANC ou ROUGE ; inconnue signifie que la couleur n'est pas encore disponible. Dans la liste predictions, confirmed vaut true pour une couleur officielle EDF et false pour une prévision.

Exemple d'automatisation (capteurs REST) : être prévenu la veille d'un jour rouge

Dans Paramètres, Automatisations, créez une automatisation, choisissez « Modifier en YAML » et collez :

alias: "Tempo : jour rouge demain"
triggers:
  - trigger: state
    entity_id: sensor.tempo_couleur_de_demain
    to: "ROUGE"
    not_from: "unavailable"
actions:
  - action: notify.notify
    data:
      title: "Jour Tempo rouge demain"
      message: "EDF annonce un jour rouge demain : pensez à décaler vos usages."
mode: single

Le déclencheur ne réagit qu'à la couleur officielle de demain, jamais à une prévision. EDF publie la couleur Tempo du lendemain chaque jour en fin de matinée, généralement vers 11 h.

Jeedom

Sans plugin tiers, avec le plugin officiel Virtuel et un scénario :

  1. Plugin Virtuel : créez un équipement Tempo (objet Maison dans l'exemple) avec trois commandes de type info, sous-type autre : Couleur du jour, Couleur de demain et Rouges restants.
  2. Créez un scénario programmé avec le cron */30 * * * * (toutes les 30 minutes).
  3. Ajoutez un bloc Code, collez le code ci-dessous et adaptez les noms entre crochets s'ils diffèrent.
$api = 'https://www.calendrier-tempo.fr/api/';
$ctx = stream_context_create(['http' => ['timeout' => 10]]);
$lire = function ($route) use ($api, $ctx) {
  return json_decode(@file_get_contents($api . $route, false, $ctx), true);
};

$jour = $lire('today');
if (($jour['status'] ?? '') == 'ok') {
  cmd::byString('#[Maison][Tempo][Couleur du jour]#')->event($jour['couleur']);
}
$demain = $lire('tomorrow');
if (($demain['status'] ?? '') == 'ok') {
  cmd::byString('#[Maison][Tempo][Couleur de demain]#')->event($demain['couleur']);
}
$reste = $lire('remaining');
if (($reste['status'] ?? '') == 'ok') {
  cmd::byString('#[Maison][Tempo][Rouges restants]#')->event($reste['remaining']['ROUGE']);
}

Domoticz

Créez un matériel « Dummy », puis deux capteurs virtuels de type Texte nommés Tempo jour et Tempo demain. Ajoutez ensuite ce script dzVents (Configuration, Plus d'options, Événements) :

local API = 'https://www.calendrier-tempo.fr/api/'

return {
  on = {
    timer = { 'every 30 minutes' },
    httpResponses = { 'tempo_jour', 'tempo_demain' },
  },
  execute = function(domoticz, item)
    if item.isTimer then
      domoticz.openURL({ url = API .. 'today', callback = 'tempo_jour' })
      domoticz.openURL({ url = API .. 'tomorrow', callback = 'tempo_demain' })
    elseif item.isHTTPResponse and item.ok and item.isJSON then
      local r = item.json
      if r.status == 'ok' then
        local capteur = (item.trigger == 'tempo_jour') and 'Tempo jour' or 'Tempo demain'
        domoticz.devices(capteur).updateText(r.couleur)
      end
    end
  end
}

Limites d'usage

Tous les champs et endpoints sont décrits sur la page API Tempo EDF.