Saltar al contenido principal

Integración domótica Programme Télé, gratuita y de código abierto

Integración Programme Télé para Gladys Assistant

French TV guide (TNT): what is on now, next and tonight on your favourite channels.

info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

This integration shows the TV guide of the French TNT channels in Gladys: what is on now, what comes next and what is on tonight.

What you get​

One device per selected channel (for example "Programme TV TF1"), with 3 text sensors:

  • En cours (now) — the programme on air, with its times (JT 20h (20:00 - 20:45));
  • À suivre (next) — the next programme (20:45 · Petits plats en équilibre);
  • Ce soir (tonight) — the programme on air at 21:10, Paris time (21:10 · Koh-Lanta).

Times are always displayed in the Paris time zone.

Configuration​

  1. Open the Configuration tab of the integration.
  2. Tick the channels to follow (30 TNT channels available).
  3. Save: the devices show up in the Discovery tab, ready to be added.

The sensors are updated every minute. The full guide (8 days) is downloaded at most every 6 hours.

Dashboard widget​

Add the TV guide widget to a dashboard (Gladys 5.1 or later). Settings:

  • Show: Now (with the time left) or Tonight (21:10);
  • Channels: up to 8 channels; leave empty to use the channels of the integration configuration.

Tap a row to read the programme summary. The widget refreshes itself when a programme ends.

Scenes​

Trigger "A TV programme starts" — starts a scene when a programme begins. Filters (empty = any):

  • Channels: one or more channels;
  • Exact title: e.g. Koh-Lanta (exact match, case included; "contains" is not possible).

Variables for the following actions: channel, title, sub-title, category, start time, end time, duration (min). Example: "When Koh-Lanta starts on TF1, turn on the TV and send me a message".

The trigger works for all 30 channels, even the ones not ticked in the configuration. A programme is detected within a minute of its start.

Action "Get the TV programme of a channel" — returns to the scene what is on now, next and tonight (full text, title only, time). Example: send every evening at 20:00 "Tonight on France 2: …".

Actions​

  • Test the TV guide — downloads the guide right now and shows what is on the first selected channel.

Data source​

The guide comes from the free XMLTV feed of xmltvfr.fr (TNT file). No account, no API key. The integration needs Internet access.

Troubleshooting​

  • "Aucun programme": the source has no data for this channel at that time.
  • "Disconnected" status: the guide download failed. If an older guide is in memory it keeps being used; a new try is made 15 minutes later.
  • Check the integration logs from the Gladys UI (or docker logs on the host) with LOG_LEVEL=debug for the full details.

Parámetros de configuración​

Estos son los parámetros que Programme Télé te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Getting startedsectionNoPick the channels to follow: each one becomes a device with 3 sensors (now, next, tonight). The guide comes from the free XMLTV feed of xmltvfr.fr. No account, no API key.
Channelsmulti_selectSíOne Gladys device is created per selected channel.

Cómo instalar Programme Télé en Gladys​

  1. En Gladys, abre Integraciones: Programme Télé aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/prohand/gladys-programmetele:2.2.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-programmetele.

Programme Télé requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

Programme Télé es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂