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

Periodos solunares para pesca y caza, calculados en local: mayores, menores, nota del día.
Los periodos solunares en Gladys, para la pesca y la caza: los momentos del día en que peces y animales de caza estarían más activos, según la teoría que John Alden Knight publicó en 1926. Todo se calcula en el contenedor a partir de la posición de la Luna y del Sol: sin cuenta, sin clave, sin acceso a internet.
Lo que obtiene
- Un dispositivo por lugar: cada casa ubicada de Gladys y hasta tres lugares de pesca escritos en la configuración. Cada dispositivo da el periodo en curso (ninguno, mayor o menor, y su fin), un indicador «periodo activo», el próximo periodo y los minutos que faltan, la nota del día de 0 a 4, la fase lunar y su iluminación.
- Un widget del panel: los periodos del día en un lugar, el que está en curso en verde, la nota del día y la luna.
- Un disparador de escena: empieza un periodo solunar, filtrado por lugar, tipo (mayor o menor) y nota del día.
- Una acción de escena: los periodos, la nota y la luna de hoy o de mañana en un lugar, en una frase para enviar por mensaje.
Esta integración da los periodos de pesca. Para la luna en sí (fase, salida y puesta, eventos lunares), vea el widget gladys-moon-phase: ambos funcionan a la vez.
Requisitos
- Gladys Assistant 5.1.0 o posterior (widgets, disparadores y acciones de escena).
- Una casa ubicada en Gladys (Ajustes → Casas), o las coordenadas de un lugar.
La integración se instala desde GitHub: Integraciones → Instalar desde GitHub, dirección
https://github.com/guim31/gladys-solunar.
Configuración
| Ajuste | Por defecto | Función |
|---|---|---|
| Idioma de los valores | Francés | Idioma de los nombres de las funciones y de los textos enviados. |
| Un dispositivo por casa ubicada | Activado | Usa las coordenadas de las casas definidas en Gladys. |
| Lugar 1 a 3: nombre | vacío | Nombre del dispositivo del lugar (se puede cambiar luego en Gladys). |
| Lugar 1 a 3: latitud, longitud | vacío | latitud, longitud en grados decimales, p. ej. 43.6047, 1.4442. |
Las coordenadas se copian de cualquier mapa (clic derecho en OpenStreetMap o Google Maps). La coma
decimal también funciona: 43,6047; 1,4442. Vacíe las coordenadas de un lugar para quitarlo. Guarde
y cree los dispositivos en la pestaña Descubrir. El botón Comprobar los lugares lista cada lugar con su nota del día.
Las coordenadas de las casas se leen al arrancar, en cada búsqueda y cada 6 horas: después de mover una casa, pulse Comprobar los lugares.
Dispositivos
| Función | Tipo | Ejemplo |
|---|---|---|
| Periodo solunar | texto | Mayor hasta las 18:40 |
| Periodo solunar activo | binario | 1 durante cualquier periodo |
| Próximo periodo solunar | texto | Menor mañana a las 05:10 |
| Próximo periodo en (min) | duración | 95 |
| Nota del día (0-4) | número | 3 |
| Fase lunar | texto | Gibosa creciente |
| Iluminación lunar (%) | número | 78 |
Las horas son las de la zona horaria de Gladys; un día va de medianoche a medianoche. Los valores se calculan cada minuto y solo se envían los cambios.
Widget del panel
Periodos solunares: elija un lugar (el primero por defecto). Muestra la nota del día, la iluminación lunar y luego cada periodo del día: pasado, en curso (verde) o próximo. Un ☀ marca un periodo que coincide con una salida o una puesta del sol. El ajuste Mostrar la luna oculta la casilla y la fase de la luna.
Disparador de escena
Periodo solunar iniciado, cuando empieza un periodo mayor o menor en un lugar. Filtros: el lugar,
el tipo de periodo, la nota del día. Variables: place (lugar), start (inicio), end (fin),
with_sun (el periodo coincide con una salida o una puesta del sol) y summary, una frase lista.
Un reinicio de la integración en mitad de un periodo no lo vuelve a disparar.
Acción de escena
Obtener el día solunar: para un lugar y un día (hoy o mañana), devuelve summary (una frase),
rating (la nota), periods (la lista con sus horas), moon_phase e illumination.
Ejemplos de escenas
- Cada tarde a las 20 h, Obtener el día solunar de mañana en el lago y enviar el resumen por mensaje: la salida se prepara la víspera.
- Periodo solunar iniciado, tipo mayor, nota 3 o 4: una notificación «están picando».
- Condición sobre Próximo periodo en (min) inferior a 30 en la casa: hora de preparar el equipo.
Cómo se calcula
- Periodos mayores, dos horas: la Luna cruza el meridiano sobre nosotros (culminación superior) o bajo nuestros pies (culminación inferior), centrados en el paso.
- Periodos menores, una hora: salida y puesta de la luna, centrados en el evento.
- Un periodo es con el sol cuando una salida o una puesta del sol cae dentro de él o a menos de 30 minutos de sus bordes.
- Nota del día, de 0 a 4: 2 puntos a menos de 1,5 días de una luna nueva o llena (1 punto a menos de 3,5 días), más 2 puntos cuando un periodo mayor coincide con el sol (1 cuando solo lo hace uno menor).
La Luna vuelve unos 50 minutos más tarde cada día: algunos días solo tienen tres periodos (sin salida de la luna, o una sola culminación). Más allá de los círculos polares, la Luna puede quedarse sobre o bajo el horizonte varios días: entonces solo quedan los periodos mayores. Las posiciones vienen de astronomy-engine (MIT): las horas coinciden con uno o dos minutos de diferencia con las tablas del US Naval Observatory.
Solución de problemas
- Ningún dispositivo en la pestaña Descubrir: ninguna casa está ubicada y ningún lugar está rellenado. Ubique una casa en Ajustes → Casas o escriba las coordenadas de un lugar y guarde.
- «Coordenadas ilegibles» en el estado: escriba
latitud, longitud, la latitud primero, en grados decimales (no en grados y minutos). - Horas desfasadas una hora: compruebe la zona horaria de Gladys en sus ajustes.
- Registros:
LOG_LEVEL=debugmuestra cada cálculo.
Límites
- La teoría solunar es una tradición de pescadores y cazadores, no una previsión científica: el tiempo, el agua y la estación cuentan igual.
- La nota es la descrita arriba; otras tablas (solunarforecast.com, aplicaciones) usan sus propias escalas y pueden diferir.
- Las horas de un lugar se dan en la zona horaria de Gladys, incluso para un lugar en otra zona.
- Tres lugares como máximo además de las casas.
Sin afiliación con ningún editor de tablas solunares. Teoría: John Alden Knight (1926). Cálculo: astronomy-engine de Don Cross (MIT).
Parámetros de configuración
Estos son los parámetros que Solunar te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Periodos solunares | section | No | Calculados en el contenedor a partir de la posición de la Luna, sin cuenta ni internet: periodos mayores (Luna en el cenit o el nadir, 2 h) y menores (salida y puesta de la luna, 1 h). Un dispositivo por casa ubicada y por lugar de pesca: guarde y créelos en la pestaña Descubrir. |
| Idioma de los valores | select | No | Nombres de las funciones y textos enviados a Gladys. |
| Un dispositivo por casa ubicada | boolean | No | Usa las coordenadas de las casas definidas en Gladys (Ajustes → Casas). |
| Lugares de pesca | section | No | Hasta tres lugares más: un nombre y las coordenadas, «latitud, longitud» en grados decimales (cópielas de un mapa). Vacíe las coordenadas para quitar un lugar. |
| Lugar 1: nombre | string | No | |
| Lugar 1: latitud, longitud | string | No | |
| Lugar 2: nombre | string | No | |
| Lugar 2: latitud, longitud | string | No | |
| Lugar 3: nombre | string | No | |
| Lugar 3: latitud, longitud | string | No |
Cómo instalar Solunar en Gladys
- En Gladys, abre Integraciones: Solunar 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/guim31/gladys-solunar: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). - 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/guim31/gladys-solunar.
Solunar 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
Solunar 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