🎮 Home Assistant - Xbox Subscription Expiration Sensor

Monitor your Xbox subscription expiration date directly in Home Assistant and receive an automatic notification when it expires.

---

🇮🇹 Italiano

Monitora la scadenza del tuo abbonamento Xbox direttamente in Home Assistant e ricevi una notifica automatica quando scade.

✨ Funzionalità

• 📅 Sensore che mostra la data di scadenza dell'abbonamento.
• ✅ Sensore di stato che indica se l'abbonamento è Attivo o Scaduto.
• 🔔 Automazione che invia una notifica quando l'abbonamento scade.
• ⚙️ Facile da personalizzare modificando solamente la data di scadenza.

---

📦 Contenuto

Sensori

• sensor.scadenza_abbonamento_xbox
• sensor.stato_abbonamento_xbox

Automazione

• Notifica automatica alla scadenza dell'abbonamento Xbox.

---

🚀 Installazione

1. Aggiungi i sensori

Copia questo blocco nel tuo configuration.yaml (oppure nel file dedicato ai template, se utilizzi una configurazione separata).

template:
  - sensor:
      - name: "Scadenza abbonamento Xbox"
        unique_id: scadenza_xbox
        default_entity_id: sensor.scadenza_abbonamento_xbox
        state: >
          {% set data_scadenza = as_timestamp(strptime('2026-08-26', '%Y-%m-%d')) %}
          {% if now().timestamp() >= data_scadenza %}
            L'abbonamento Xbox è scaduto
          {% else %}
            L'abbonamento Xbox scade il 26-08-2026
          {% endif %}

      - name: "Stato abbonamento Xbox"
        unique_id: stato_abbonamento_xbox
        default_entity_id: sensor.stato_abbonamento_xbox
        state: >
          {% set data_scadenza = as_timestamp(strptime('2026-08-26', '%Y-%m-%d')) %}
          {% if now().timestamp() >= data_scadenza %}
            Scaduto
          {% else %}
            Attivo
          {% endif %}

📝 Personalizzazione: sostituisci 2026-08-26 con la data di scadenza del tuo abbonamento.

---

2. Aggiungi l'automazione

Copia questo blocco nel tuo configuration.yaml sotto la sezione automation: (oppure nel tuo file automations.yaml).

automation:
  - alias: Notifica scadenza abbonamento Xbox
    description: Invia una notifica quando l'abbonamento Xbox scade
    trigger:
      - platform: state
        entity_id: sensor.stato_abbonamento_xbox
        to: "Scaduto"
    action:
      - service: notify.NOTIFICA_TUA
        data:
          message: "⚠️ L'abbonamento Xbox è scaduto!"
    mode: single

🔔 Importante: sostituisci notify.NOTIFICA_TUA con il tuo servizio di notifica (ad esempio notify.mobile_app_mio_telefono).

---

3. Riavvia Home Assistant

Dopo aver salvato la configurazione:

1. Controlla la configurazione da Impostazioni → Sistema → Controlla configurazione.
2. Riavvia Home Assistant.

---

📢 Integrazione Xbox (Opzionale)

Per un'esperienza ancora più completa puoi installare anche l'integrazione ufficiale Xbox:

https://my.home-assistant.io/redirect/config_flow_start?domain=xbox

---

🇬🇧 English

Monitor your Xbox subscription expiration date directly in Home Assistant and receive an automatic notification when it expires.

✨ Features

• 📅 Sensor showing your Xbox subscription expiration date.
• ✅ Status sensor displaying Active or Expired.
• 🔔 Automatic notification when your subscription expires.
• ⚙️ Easy to customize by changing only the expiration date.

---

📦 Included

Sensors

• sensor.xbox_subscription_expiration
• sensor.xbox_subscription_status

Automation

• Automatic notification when your Xbox subscription expires.

---

🚀 Installation

1. Add the sensors

Copy this block into your configuration.yaml (or your templates file if you use one).

template:
  - sensor:
      - name: "Xbox subscription expiration"
        unique_id: xbox_subscription_expiration
        default_entity_id: sensor.xbox_subscription_expiration
        state: >
          {% set expiration_date = as_timestamp(strptime('2026-08-26', '%Y-%m-%d')) %}
          {% if now().timestamp() >= expiration_date %}
            Xbox subscription has expired
          {% else %}
            Xbox subscription expires on 2026-08-26
          {% endif %}

      - name: "Xbox subscription status"
        unique_id: xbox_subscription_status
        default_entity_id: sensor.xbox_subscription_status
        state: >
          {% set expiration_date = as_timestamp(strptime('2026-08-26', '%Y-%m-%d')) %}
          {% if now().timestamp() >= expiration_date %}
            Expired
          {% else %}
            Active
          {% endif %}

📝 Customization: replace 2026-08-26 with your own subscription expiration date.

---

2. Add the automation

Copy this block into your configuration.yaml under the automation: section (or into your automations.yaml file).

automation:
  - alias: Xbox subscription expiration notification
    description: Sends a notification when the Xbox subscription expires
    trigger:
      - platform: state
        entity_id: sensor.xbox_subscription_status
        to: "Expired"
    action:
      - service: notify.YOUR_NOTIFICATION_SERVICE
        data:
          message: "⚠️ Your Xbox subscription has expired!"
    mode: single

🔔 Important: replace notify.YOUR_NOTIFICATION_SERVICE with your own notification service (for example notify.mobile_app_my_phone).

---

3. Restart Home Assistant

After saving your configuration:

1. Check your configuration.
2. Restart Home Assistant.

---

📢 Optional Xbox Integration

For an even better experience, you can also install the official Xbox integration:

https://my.home-assistant.io/redirect/config_flow_start?domain=xbox

---

📄 License

Released under the MIT License.

Feel free to use, modify, and share this project.