Calcio e fantacalcio su Home Assistant

Il problema

Nonostante l’argomento non sia di solito particolarmente apprezzato dagli addetti ai lavori, sono invece convinto che in mezzo a voi ci siano alcuni “infiltrati” che come me, sono degli appassionati e vogliono avere il Calcio e fantacalcio su Home Assistant.

L’idea

Perché quindi non realizzare una soluzione che ci dica quando e con chi la nostra squadra gioca la prossima partita?
Che possa indicarci quale sarà la prossima partita di Serie A e magari anche tutte le altre?
E che ci invii qualche notifica per ricordarci di inserire la formazione del fantacalcio?!?

I requisiti

I requisiti per applicare questa soluzione sono quelli di avere un account Google e di tifare per la squadra giusta: il Napoli.
Se invece la tua squadra del cuore è un’altra, pagherai pegno facendo una donazione la cui entità cambierà a seconda della stessa. Giusto per fare un esempio: se tifi una squadra che mi sta simpatica, doni poco, se invece hai scelto tuo malgrado di essere ad esempio senza colori degni di nota (tipo il bianco e il nero), allora potrebbe non esserci prezzo.

Scherzo ovviamente ma sappi che qui troverai tutto l’esempio realizzato per il mio Napoli, non dovrebbe però essere complicato fare le dovute personalizzazioni se tifi altro.

La soluzione

Innanzitutto andate a questa pagina e scegliete la squadra che volete seguire. Successivamente cliccate sull’icona di Google Calendar come da immagine seguente:

Poi sul pulsante “Log In” che appare dopo:

Si aprirà una nuova finestra dove scegliere l’account a cui associare il nuovo calendario. Sceglietelo e date le autorizzazioni in fondo cliccando su “Consenti”.

A questo punto aprite Google Calendar. Sulla sinistra in fondo, troverete una sezione chiamata “Altri calendari” nella quale dovreste vedere quello appena aggiunto riguardante la vostra squadra.

Fate ora la stessa operazione partendo da questa pagina e cliccando sul pulsante per aggiungere a Google Calendar il campionato di Serie A.

A questo punto siamo pronti per passare su Home Assistant.
Andate in “Impostazioni” -> “Dispositivi e servizi” ed aggiungete l’integrazione di Google Calendar. Quando avvierete l’installazione vi verranno chiesti Nome, ID Cliente OAuth e Segreto Cliente OAuth.

Per recuperare queste informazioni andate a questa pagina, accettate i termini e condizioni di utilizzo e poi create, se necessario, un progetto:

Successivamente cliccate sulla sinistra su “Libreria”, cercate “Google Calendar API” e abilitatela. Fatto questo andate su “Schermata consento OAuth”, spuntate la voce “Esterno” e poi cliccate su “CREA”. Inserite un nome per l’applicazione (ad esempio “Home Assistant”) e selezionate una e-mail per assistenza utenti. In fondo scrivere nelle “Informazioni di contatto dello sviluppatore” il vostro indirizzo e-mail e cliccate su tutti i “SALVA E CONTINUA” fino a tornare alla dashboard. Poi sempre nella “Schermata di consenso OAuth”, cambiate lo stato di pubblicazione cliccando su “PUBBLICA APP”.

A questo punto spostatevi nel menu a sinistra su “Credenziali” e cliccate in alto su “+ CREA CREDENZIALI”, poi su “ID client OAuth”. Scegliete come tipo di applicazione “TV e dispositivi di immissione limitata” ed infine inserite come “Nome” un valore a scelta per le credenziali di accesso. Ad esempio “Home Assistant Credentials”.

Vi apparirà una schermata con i dati del Client OAuth creato.

Questi dati, insieme al nome scelto per le credenziali sono quelli da inserire nella configurazione di Google Calendar su Home Assistant:

Vi apparirà una schermata che vi mostrerà una codice da inserire in questa pagina. Al termine, se tutto è andato a buon fine, l’integrazione vi aggiungerà delle entità corrispondenti ai calendari installati sul vostro account. In particolare dovreste averne due, chiamate rispettivamente calendar.tua_squadra_del_cuore e calendar.serie_a.

E’ il momento di creare dei sensori che ci serviranno a mostrare i dati.
Aprite il file configuration.yaml ed aggiungete il seguente codice sotto la sezione sensor: avendo cura di sostituire “calendar.napoli” con il nome dell’entità della vostra squadra:

    ##########
    # CALCIO #
    ##########
    - platform: template
      sensors:
        next_match:
          friendly_name: Prossima partita
          icon_template: "mdi:soccer"
          value_template: >-
            {% set match = state_attr('calendar.napoli', 'message') %}
            {{ match }}
        next_match_day:
          friendly_name: Data
          icon_template: "mdi:calendar"
          value_template: >-
            {% set match_day_time = state_attr('calendar.napoli', 'start_time') %}
            {% set match_date = as_timestamp(match_day_time) | timestamp_custom('%d/%m/%Y') %}
            {{ match_date }}
        next_match_week_day:
          friendly_name: Giorno
          icon_template: "mdi:calendar-week-begin"
          value_template: >-
            {% set arr_week_days = ["Domenica", "Lunedì", "Martedì", "Mercoledì", "Giovedì", "Venerdì", "Sabato"] %}
            {% set match_day_time = state_attr('calendar.napoli', 'start_time') %}
            {% set week_day = as_timestamp(match_day_time) | timestamp_custom('%w') | int %}
            {{ arr_week_days[week_day] }}
        next_match_time:
          friendly_name: Ora
          icon_template: "mdi:clock-time-three"
          value_template: >-
            {% set match_day_time = state_attr('calendar.napoli', 'start_time') %}
            {% set match_time = as_timestamp(match_day_time) | timestamp_custom('%H:%M:%S') %}
            {{ match_time }}
    
        serie_a_next_match:
          friendly_name: Prossima partita
          icon_template: "mdi:soccer"
          value_template: >-
            {% set match = state_attr('calendar.serie_a', 'message') %}
            {{ match }}
        serie_a_next_match_day:
          friendly_name: Data
          icon_template: "mdi:calendar"
          value_template: >-
            {% set match_day_time = state_attr('calendar.serie_a', 'start_time') %}
            {% set match_date = as_timestamp(match_day_time) | timestamp_custom('%d/%m/%Y') %}
            {{ match_date }}
        serie_a_next_match_week_day:
          friendly_name: Giorno
          icon_template: "mdi:calendar-week-begin"
          value_template: >-
            {% set arr_week_days = ["Domenica", "Lunedì", "Martedì", "Mercoledì", "Giovedì", "Venerdì", "Sabato"] %}
            {% set match_day_time = state_attr('calendar.serie_a', 'start_time') %}
            {% set week_day = as_timestamp(match_day_time) | timestamp_custom('%w') | int %}
            {{ arr_week_days[week_day] }}
        serie_a_next_match_time:
          friendly_name: Ora
          icon_template: "mdi:clock-time-three"
          value_template: >-
            {% set match_day_time = state_attr('calendar.serie_a', 'start_time') %}
            {% set match_time = as_timestamp(match_day_time) | timestamp_custom('%H:%M:%S') %}
            {{ match_time }}

Salvate e riavviate Home Assistant.

Realizziamo infine l’interfaccia su Lovelace.
Aggiungete una vista di tipo pannello chiamata ad esempio “Calcio” ed aggiungete un elemento manuale con il seguente codice (sempre da personalizzare):

type: horizontal-stack
cards:
  - type: vertical-stack
    cards:
      - type: markdown
        content: '**FORZA AZZURRI!**'
        title: SSC NAPOLI
      - type: entity
        entity: sensor.next_match
      - type: entity
        entity: sensor.next_match_week_day
      - type: entity
        entity: sensor.next_match_day
      - type: entity
        entity: sensor.next_match_time
      - type: calendar
        initial_view: dayGridMonth
        entities:
          - calendar.napoli
  - type: vertical-stack
    cards:
      - type: markdown
        content: '**Ecco la prossima**'
        title: SERIE A
      - type: entity
        entity: sensor.serie_a_next_match
      - type: entity
        entity: sensor.serie_a_next_match_week_day
      - type: entity
        entity: sensor.serie_a_next_match_day
      - type: entity
        entity: sensor.serie_a_next_match_time
      - type: calendar
        initial_view: dayGridMonth
        entities:
          - calendar.serie_a

Conclusioni

Inutile dire che potreste scegliere di aggiungere altre squadre, campionati oppure il mondiale in corso.
Poi non vi resta che tifare e soprattutto avvisare le vostre mogli di guardare Home Assistant prima di organizzare la prossima uscita esattamente nel giorno e nell’ora della partita.

Supporto reciproco

La realizzazione di questo articolo ha richiesto tempo, studio ed impegno.

Vi chiedo quindi mettere una mano sul cuore e l’altra sul portafogli per ricompensare il mio sforzo con un contributo libero:

Grazie.

Un piccolo extra

Per tutti coloro che fanno il fantacalcio, ho realizzato una piccola automazione per ricevere delle notifiche che mi ricordino di inserire la formazione. Eccola:

alias: Fantacalcio
description: ""
trigger:
  - platform: calendar
    event: start
    offset: "-24:0:0"
    entity_id: calendar.serie_a
  - platform: calendar
    event: start
    offset: "-3:0:0"
    entity_id: calendar.serie_a
  - platform: calendar
    event: start
    offset: "-1:0:0"
    entity_id: calendar.serie_a
condition: []
action:
  - service: notify.mobile_app_xiaomi_11_5g_lite_ne
    data:
      title: ⚽ Fantacalcio
      message: >-
        Preparati per la nuova giornata di serie A.<br />Ricordati di inserire
        la formazione!
mode: single

Come potete vedere ho scelto di ricevere tre notifiche. Una 24 ore prima dell’inizio della nuova giornata di Serie A, una tre ore prima e l’ultima un’ora prima. Ovviamente decidete per voi la soluzione più comoda.

Non mi resta che augurare a tutti voi un buon campionato e che vinca il Napoli!