Integración domótica Cycles, gratuita y de código abierto

Custodia compartida y turnos como calendarios de Gladys: quién tiene a los niños, turno del día.

• Publicado por guim31
• Dispositivos
• Versión 1.0.0
• Requiere Gladys >=5.2.0
• ★ 0

Ver en GitHubTodas las integraciones

Custodia compartida y trabajo por turnos, como calendarios de Gladys. Elija un modelo (una semana de cada dos, 2-2-3, 5x8, turnos de 12 h, semanas de guardia…) y la fecha de su primer día: la integración genera el calendario con meses de antelación y lo mantiene al día cada noche. No se descarga nada ni hace falta ninguna cuenta: cada evento se calcula dentro de Gladys.

Lo que obtiene

• Un calendario por ciclo, hasta tres por usuario: «Niños conmigo» / «Niños con el otro progenitor» de una entrega a la siguiente, o «Turno de mañana», «Turno de noche», «Guardia»… con sus horarios. Aparecen en la vista de calendario de Gladys como cualquier otro calendario.
• Dos desencadenantes de escena: llegan o se van los niños, empieza o termina un turno.
• Una acción de escena que dice en qué punto está un ciclo: niños en casa o no, turno del día, próximo cambio y los minutos que faltan.
• Un widget del panel: quién tiene a los niños, el turno en curso y los próximos cambios.
• Como son calendarios normales, las escenas integradas de Gladys también funcionan: «un evento se acerca», «hay un evento en curso».

Configurar sus ciclos

Cada usuario configura sus propios ciclos: abra Integraciones → Cycles y luego el bloque Mis calendarios. Rellene un hueco y pulse Activar (o Guardar). Para cada ciclo:

• Modelo: vea las listas más abajo. «Sin usar» deja el hueco vacío (y quita su calendario).
• Nombre del calendario: opcional. Las escenas y el widget se refieren al ciclo con este nombre.
• Fecha de inicio: el primer día del modelo, por ejemplo el viernes en que los niños llegaron a su casa para la primera semana. Puede ser de hace años: la integración cuenta los días. Escríbala 04/09/2026 o 2026-09-04.
• Hora de entrega: cuándo cambian de casa los niños, o cuándo empieza una semana de guardia. Vacío: 18:00 en custodia, 08:00 en guardia. Se entienden 18:00, 18h y 18h30.
• En la fecha de inicio: solo custodia, quién tiene a los niños en la fecha de inicio. En los modelos de fines de semana, «Con el otro progenitor» invierte los papeles.
• Secuencia personalizada y Horarios de los turnos: vea más abajo.

Después, comparta el calendario en la lista bajo el formulario: un calendario compartido lo ve todo el hogar, en el panel y en las escenas. Un calendario privado solo aparece en su propia vista de calendario.

Modelos de custodia

Modelo	Secuencia (desde la fecha de inicio)
Una semana de cada dos	7 días con usted, 7 días con el otro progenitor
2-2-3	2, 2, 3 días por turnos: el fin de semana largo cambia de progenitor cada semana
2-2-5-5	2 días con usted, 2 con el otro, 5 con usted, 5 con el otro progenitor
3-4-4-3	3 días con usted, 4 con el otro, 4 con usted, 3 con el otro progenitor
1.º, 3.º y 5.º fin de semana	de viernes a domingo, los fines de semana cuyo sábado es el 1.º, 3.º o 5.º del mes
2.º y 4.º fin de semana	lo mismo con los sábados 2.º y 4.º

Cada periodo va de la hora de entrega de su primer día a la hora de entrega del día siguiente a su último día: con el modelo 2-2-3 empezado un lunes a las 18:00, los niños están con usted del lunes 18:00 al miércoles 18:00. Los modelos de fines de semana no necesitan fecha de inicio: los fines de semana se cuentan por su sábado, la regla habitual de las sentencias francesas.

Modelos de trabajo por turnos

Modelo	Secuencia	Horarios por defecto
2x8	5 mañanas, 2 de descanso, 5 tardes, 2 de descanso	06:00-14:00, 14:00-22:00
3x8 por semanas	5 mañanas, 2 libres, 5 tardes, 2 libres, 5 noches, 2 libres	noche 22:00-06:00
5x8 continuo	2 mañanas, 2 tardes, 2 noches, 4 días de descanso	igual
12 h día / noche	2 días, 2 noches, 4 días de descanso	07:00-19:00, 19:00-07:00
Guardia una semana de cada N	7 días de guardia, luego N-1 semanas sin	desde la hora de entrega, 24 h

Un turno de noche pertenece al día en que empieza: en el calendario y para el «turno del día», la noche del lunes va del lunes 22:00 al martes 06:00. Los días de guardia seguidos forman un solo evento.

Secuencias personalizadas

• Custodia personalizada: los días de cada bloque, alternando los progenitores en cada bloque, empezando por el elegido en «En la fecha de inicio». 2/2/5/5 es el modelo 2-2-5-5; 7 es una semana de cada dos; con un número impar de bloques (2/2/3), los progenitores se intercambian en la vuelta siguiente. Bloques de 1 a 31 días.
• Turnos personalizados: días y letras, M mañana, A tarde, N noche, D (o J) día de 12 h, O guardia, R descanso. 2M 2A 2N 4R y MMAANNRRRR son la misma secuencia. Hasta 140 días.
• Horarios de los turnos: solo lo que difiere de M=06:00-14:00; A=14:00-22:00; N=22:00-06:00; D=07:00-19:00, por ejemplo M=05:00-13:00; N=21:00-05:00. Un fin anterior al inicio cae al día siguiente.

Ajustes del administrador

• Generar los eventos hasta: 3, 6 o 12 meses por delante (6 por defecto). Los calendarios avanzan cada noche: la semana pasada se mantiene, este horizonte se conserva por delante. Los eventos más antiguos quedan como historial.
• Idioma de los textos de las escenas: los textos y fechas que se pasan a las escenas. Los calendarios siguen el idioma de su propietario.

En Gladys

Los calendarios llevan una descripción: la fecha de inicio y la hora de entrega, o por qué el calendario está vacío cuando un campo no se puede leer. Cambiar un ajuste regenera el calendario al momento, sin duplicados. Desactivar la sincronización de un calendario en «Mis calendarios» lo vacía; reactivarla lo vuelve a llenar.

Widget del panel

Añada el widget Cycles a un panel. Muestra una línea por ciclo compartido (en verde cuando los niños están con usted o hay un turno en curso) y luego los cambios de los próximos 3, 7 o 14 días. Ajustes: los calendarios que se muestran (nombres separados por comas, vacío: todos), el periodo y un interruptor para ocultar los próximos cambios.

Desencadenantes de escena

• Llegan o se van los niños: a la hora de entrega de un calendario de custodia compartido. Filtros: el calendario, llegada y/o salida. Variables: el calendario, su propietario, el cambio, «niños conmigo» (1 o 0) y la próxima entrega.
• Empieza o termina un turno: un turno o una guardia de un calendario compartido empieza o termina. Filtros: el calendario, inicio y/o fin, el tipo de turno (solo noche…). Variables: el calendario, su propietario, el cambio, el turno, su inicio y su fin.

Un desencadenante se activa en los 30 segundos siguientes al cambio. No se activa nada al arrancar la integración ni cuando usted cambia un ajuste.

Acción de escena

Consultar el estado de un ciclo (por nombre de calendario, si no el primer ciclo compartido) devuelve: found (1/0), active (1 cuando los niños están con usted o hay un turno en curso), el estado actual, el turno del día (o quién tiene a los niños a mediodía), el estado siguiente, el próximo cambio y los minutos que faltan (-1 si no hay ninguno).

Ejemplos de escenas

• Llegan los niños → calefacción de sus habitaciones en confort; se van → vuelta a eco.
• Cada noche a las 21:00, consultar el ciclo «Trabajo»: si el turno del día es de mañana, poner la escena despertador a las 05:00.
• Empieza un turno de noche → modo silencio para los avisos de la casa hasta que termine.
• Miércoles 17:00, niños ausentes (active = 0) → no lanzar la escena «vuelta del colegio».

Solución de problemas

• El calendario está vacío: lea su descripción en la vista de calendario, indica qué campo no se puede leer. Revise la fecha de inicio (04/09/2026 o 2026-09-04) y la secuencia personalizada.
• El calendario está desplazado un periodo: la fecha de inicio es el primer día del modelo, el día en que llegaron los niños (si no, «En la fecha de inicio» debe indicar el otro progenitor). Corríjala y guarde.
• No se lanza ninguna escena: el calendario debe estar compartido, y el filtro de un desencadenante necesita el nombre exacto del calendario (la acción de escena ignora mayúsculas y acentos).
• El widget dice que no hay nada compartido: comparta el calendario en «Mis calendarios».

Límites

• Las vacaciones escolares repartidas por mitades no se gestionan: sus reglas (qué mitad, qué año, qué zona) varían demasiado de una sentencia a otra. Durante las vacaciones, cambie la fecha de inicio o el modelo, o añada las vacaciones al calendario a mano.
• Una sola hora de entrega por ciclo (la misma el viernes y el domingo en los fines de semana).
• Los festivos no desplazan nada: los ciclos siguen.
• Hasta tres ciclos por usuario; de tres meses a un año por delante.

Privacidad

Nada sale de Gladys: la integración no hace ninguna petición de red fuera de Gladys y no guarda nada en su volumen. Los ciclos están en los ajustes de su cuenta, los calendarios son privados hasta que usted los comparte. Sin relación con ningún empleador ni tribunal.

Parámetros de configuración

Estos son los parámetros que Cycles te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Funcionamiento	section	No	Cada usuario configura sus propios ciclos en «Mis calendarios» abajo: no se descarga nada, cada evento se calcula aquí. Estos ajustes valen para todos.
Generar los eventos hasta	select	No	Los calendarios avanzan cada noche: la semana pasada se mantiene, este horizonte se conserva por delante.
Idioma de los textos de las escenas	select	No	Textos y fechas que se pasan a las escenas. Los calendarios siguen el idioma de su propietario.

Cómo instalar Cycles en Gladys

1. En Gladys, abre Integraciones: Cycles 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/guim31/gladys-cycles:1.0.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/guim31/gladys-cycles.

Cycles 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

Cycles 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 guim31, 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

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 🙂