Integración domótica Fête du jour, gratuita y de código abierto
Santoral del calendario francés: un calendario Gladys, un disparador, un widget.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.2.0
- ★ 0
Presentación
Esta integración trae a Gladys el santo de cada día del calendario tradicional francés: «Santo: Valérie» el 28 de abril, «Fête nationale · Santo: Camille» el 14 de julio.
- Un calendario de Gladys «Santoral» para cada usuario que lo active: un evento de día completo por día, desde 7 días atrás hasta un año por delante.
- Un disparador de escena «Santo del día», cada día a la hora elegida, o solo el día del santo de los nombres que elija (el suyo, los de su familia).
- Una acción de escena «Obtener el santo del día» (hoy o mañana), con una frase lista para enviar.
- Un widget «Santo del día»: el santo de hoy y de los próximos días.
La imagen de arriba es una ilustración generada, no una captura de pantalla.
Requisitos
- Gladys Assistant 5.2.0 o posterior (integraciones de calendario).
- La zona horaria de Gladys bien configurada (Ajustes > Sistema): los días cambian a su medianoche.
- Nada más con la lista integrada. Para fetedujour.fr: una clave gratuita y una dirección IP pública fija (ver más abajo).
Configuración
| Campo | Descripción |
|---|---|
| Hora del evento de escena | La hora (0 a 23) a la que el disparador «Santo del día» se inicia cada día. 8 por defecto. |
| Idioma de los textos | Resúmenes de escenas y estado. Automático: el idioma de su panel en cuanto se haya mostrado el widget, deducido de la zona horaria antes de eso. El calendario sigue el idioma de cada usuario. |
| Clave de fetedujour.fr | Opcional. Vacía: la lista integrada. |
Después, en el bloque Mis calendarios de la página de la integración, pulse Activar para mí: su calendario «Santoral» aparece en el calendario de Gladys. Empieza siendo privado: para usarlo en escenas o mostrarlo al hogar, active Compartir con el hogar. Cada usuario activa el suyo.
De dónde vienen los nombres
- Lista integrada (por defecto): el calendario tradicional francés, un santo por día (351 nombres), con las fiestas y festivos (Toussaint, Noël, Fête nationale…). Cuando una fiesta tiene un nombre asociado, viene con ella: Martin el 11 de noviembre, Camille el 14 de julio, Marie el 15 de agosto. No hace falta ninguna conexión. El 29 de febrero (Auguste) solo existe en los años bisiestos.
- fetedujour.fr (opcional): genere una clave gratuita en fetedujour.fr/api con la dirección IP pública de su router y péguela en la configuración. La clave solo funciona desde esa dirección IP: si su proveedor le da una dirección que cambia, la clave dejará de funcionar. La integración pide cada día del año una sola vez (una petición cada 30 segundos, unas tres horas la primera vez, hoy primero) y conserva las respuestas; las fiestas de la lista integrada se quedan como están. Mientras un día no se haya leído, y cada vez que fetedujour.fr rechace la clave o no responda, la lista integrada toma el relevo.
El estado en la parte superior de la página de configuración indica la fuente usada y el avance («fetedujour.fr: 120 de 366 días leídos»).
Uso
Calendario
El calendario «Santoral» aparece en la vista de calendario de Gladys, junto a los demás. El disparador de Gladys «Se acerca un evento del calendario» también funciona con él, una vez compartido con el hogar.
Widget
Santo del día: el nombre del día en grande (o la fiesta), la fecha y un «¡Feliz santo a los Valérie!», y luego los próximos días (0 a 7, ajuste «Días siguientes»). Las fiestas aparecen en azul.
Escenas
Disparador Santo del día, enviado una vez al día a la hora de la configuración (nunca dos veces el mismo día; si Gladys estaba detenida a esa hora, llega a su vuelta, el mismo día). Filtro Nombres: vacío, la escena se inicia cada día; si no, solo el día del santo de los nombres elegidos.
Variables: nombre del día, fiesta o festivo (vacío casi siempre), día (AAAA-MM-DD) y una frase lista («Hoy es el santo de Valérie.»).
Acción Obtener el santo del día: hoy o mañana; devuelve el nombre, la fiesta, el día y la frase («Mañana es el santo de Catherine de Sienne.»).
Ejemplos:
- Cada día a las 8:00 (disparador Santo del día) → enviar «{{triggerEvent.data.summary}}» a la mensajería de la familia.
- Santo del día, nombres Valérie y Martin → enviar un mensaje para no olvidar felicitarles.
- Cada noche a las 20:00 → obtener el santo de mañana → anunciarlo por el altavoz del salón.
Transporte
Local con la lista integrada: nada sale de su Gladys. Con una clave, la integración también llama a fetedujour.fr (nube), y solo a ese sitio.
Solución de problemas
- «fetedujour.fr ha rechazado la clave»: la clave está vinculada a una dirección IP pública fija. Compruebe que la dirección de su router es la que dio al crear la clave; si no, genere una nueva. Mientras tanto se usa la lista integrada; la integración lo vuelve a intentar cada 6 horas, y enseguida tras un cambio de clave.
- El calendario no aparece: active la integración para usted en «Mis calendarios». Para las escenas, compártalo con el hogar.
- El santo aparece desplazado un día: compruebe la zona horaria de Gladys (Ajustes > Sistema).
- Otra cosa: abra una issue en GitHub (https://github.com/William-De71/gladys-fete-du-jour/issues) con las versiones de Gladys y de la integración, la fuente usada, el estado mostrado en la configuración y los registros de la integración (Ajustes > Supervisión). No pegue nunca su clave.
Parámetros de configuración
Estos son los parámetros que Fête du jour te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Santoral | section | No | Cómo funciona: 1. Active la integración para usted en «Mis calendarios» más abajo: obtiene un calendario «Santoral», un evento de día completo por día, para un año. Compártalo con el hogar para usarlo en las escenas. 2. Añada el widget «Santo del día» a un panel. 3. En una escena, el disparador «Santo del día» se inicia cada día a la hora indicada abajo, o solo el día del santo de los nombres que elija. Los nombres proceden del calendario tradicional francés integrado: nada que ajustar, ninguna conexión necesaria. |
| Hora del evento de escena | number | No | El disparador «Santo del día» se inicia cada día a esta hora (0 a 23, en la zona horaria de Gladys). |
| Idioma de los textos | select | No | Resúmenes de escenas y estado. Automático: el idioma de su panel en cuanto se haya mostrado el widget, deducido de la zona horaria de Gladys antes de eso. El calendario sigue siempre el idioma de cada usuario. |
| fetedujour.fr (opcional) | section | No | En lugar de la lista integrada, los nombres pueden venir de fetedujour.fr. Su clave es gratuita, pero está vinculada a UNA dirección IP pública fija: genérela en la página de abajo con la dirección pública de su router. Si la dirección cambia, la clave deja de funcionar y la lista integrada toma el relevo. Cada día del año se pide una sola vez (una petición cada 30 segundos, unas tres horas la primera vez) y luego se conserva. |
| Clave de fetedujour.fr (opcional) | secret | No | Vacía: la lista integrada. |
Cómo instalar Fête du jour en Gladys
- En Gladys, abre Integraciones: Fête du jour aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/william-de71/gladys-fete-du-jour:0.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/William-De71/gladys-fete-du-jour.
Fête du jour requiere Gladys >=5.2.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
Fête du jour 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 William-De71, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación