Integración domótica Prayer Times, gratuita y de código abierto
Los cinco horarios de oración de su casa, calculados localmente, con disparadores de adhan.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
Los horarios de las cinco oraciones del día (Fajr, Dhuhr, Asr, Maghrib, Isha),
además del imsak, la salida del sol y la medianoche, calculados para su casa —
como la integración de Home Assistant islamic_prayer_times. Gladys puede
mostrarlos en el panel e iniciar una escena a la hora de una oración, o unos
minutos antes.
Los horarios se calculan localmente, a partir de la posición del sol: sin cuenta, sin conexión a Internet, no se envía nada a ningún sitio. El cálculo es el de la API pública de Aladhan (el servicio al que llama Home Assistant) y da el mismo minuto.
Desarrollada sin una instancia real de Gladys: sus comentarios son bienvenidos. La integración se construyó contra el Gladys de prueba del SDK y se comprobó con respuestas reales de Aladhan y horarios oficiales, no en un Gladys en funcionamiento. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.
Qué necesita
- Gladys Assistant 5.2.0 o posterior.
- Las coordenadas de su vivienda en Gladys (Configuración → Viviendas), o coordenadas introducidas en la configuración de la integración.
- La zona horaria correcta en Gladys: los horarios se muestran en ella.
Al instalarla, Gladys pide permitir a la integración leer la ubicación de sus viviendas: acepte, así sabe dónde está el sol para usted. Las coordenadas nunca salen de su Gladys y nunca se escriben en los registros.
Configuración
Ubicación
- Vivienda: la vivienda para la que se calcula. Vacío: la primera vivienda con coordenadas.
- Latitud / Longitud (opcional): grados decimales, con coma o punto (por
ejemplo
48,8566y2,3522). Cuando ambas están rellenas, sustituyen a la vivienda.
Método de cálculo
Elija el método de su mezquita o de su país. Los ángulos indican cuánto está el sol bajo el horizonte en Fajr y en Isha: cuanto mayor es el ángulo, más temprano es Fajr y más tarde Isha.
| Método | Fajr | Isha | Notas |
|---|---|---|---|
| Liga Mundial Musulmana (por defecto) | 18° | 17° | Europa, Extremo Oriente, parte de EE. UU. |
| ISNA, Norteamérica | 15° | 15° | |
| Autoridad egipcia | 19,5° | 17,5° | África, Siria, Líbano |
| Umm al-Qura, La Meca | 18,5° | 90 min | 120 min durante el Ramadán |
| Universidad de Karachi | 18° | 18° | Pakistán, India, Bangladés |
| Francia, UOIF | 12° | 12° | Union des organisations islamiques de France |
| Francia, 15° | 15° | 15° | |
| Francia, 18° | 18° | 18° | usado por muchas mezquitas en Francia |
| Turquía, Diyanet | 18° | 17° | con las correcciones de la Diyanet |
| Dubái, Awqaf | 18,2° | 18,2° | con las correcciones de Awqaf |
| Región del Golfo | 19,5° | 90 min | |
| Kuwait | 18° | 17,5° | |
| Catar | 18° | 90 min | |
| Singapur, MUIS | 20° | 18° | |
| Malasia, JAKIM | 20° | 18° | |
| Indonesia, Kemenag | 20° | 18° | |
| Túnez | 18° | 18° | |
| Rusia | 16° | 15° | |
| Universidad de Teherán | 17,7° | 14° | Maghrib 4,5°, medianoche yafarí |
| Chiita duodecimano, Qom | 16° | 14° | Maghrib 4°, medianoche yafarí |
| Ángulos personalizados | los suyos | los suyos o minutos |
- Asr (escuela): Estándar (shafií, malikí, hanbalí: sombra igual al objeto) o Hanafí (sombra doble del objeto, una hora más tarde aproximadamente).
- Latitudes altas: en verano, al norte de unos 48° (París, Lille, Bruselas, Londres…), el cielo nunca se oscurece lo suficiente para un Fajr a 18°: la hora se limita entonces a una parte de la noche. Según el ángulo (por defecto, como en Aladhan), Mitad de la noche o Un séptimo de la noche.
- Medianoche: a medio camino entre el ocaso y la salida del sol, o hasta Fajr (yafarí). Por defecto, la convención del método.
- Método personalizado: los ángulos de Fajr e Isha (se admiten decimales), o Isha un número de minutos tras Maghrib (0 mantiene el ángulo).
Ajustes
Minutos añadidos a cada hora calculada, para seguir exactamente el horario de su mezquita (negativo: antes), de -60 a +60. El imsak es un número de minutos antes de Fajr (10 por defecto), contados desde el Fajr ajustado.
El idioma de los nombres fija los nombres de las funciones del dispositivo (fijados al añadirlo) y los nombres de las oraciones enviados a las escenas.
El dispositivo
Añádalo desde la pestaña Descubrimiento. Un dispositivo, Horarios de oración, con:
| Función | Valor |
|---|---|
| Imsak, Fajr, Salida del sol, Dhuhr, Asr, Maghrib, Isha, Medianoche | la hora de hoy, HH:MM |
| Próxima oración | el nombre de la próxima de las cinco oraciones |
| Hora de la próxima oración | su hora, HH:MM |
| Tiempo hasta la próxima oración | en minutos, actualizado cada minuto (sin historial) |
Después de Isha, la próxima oración es el Fajr de mañana. La salida del sol, el imsak y la medianoche se muestran pero no son oraciones. La integración actualiza el dispositivo cada minuto por sí misma.
Widget del panel
Horarios de oración (en Panel → Editar → Añadir un widget): la próxima oración y su hora, el tiempo restante, los ocho horarios del día (los pasados en gris, el próximo con una campana), la fecha de la Hégira (calendario Umm al-Qura) y el método usado. Sigue el idioma del panel.
Disparadores de escena
- Hora de la oración: se activa en el minuto de una oración. Filtro: los horarios afectados (vacío: los ocho, con imsak, salida del sol y medianoche).
- Oración próxima: se activa un número de minutos elegido antes (5, 10, 15, 20, 30, 45 o 60). Filtros: los horarios y el número de minutos (obligatorio).
Ambos transmiten a la escena: la clave del horario (fajr…), el nombre de
la oración en el idioma configurado, la hora (HH:MM) y, para el
segundo, los minutos antes.
Un reinicio de Gladys o de la integración nunca repite una oración pasada; una hora movida por una nueva configuración no se anuncia dos veces el mismo día.
Acción de escena
Obtener los horarios de oración: los ocho horarios de hoy o de mañana, la próxima oración, su hora y los minutos restantes, legibles por las acciones siguientes de la escena.
Acción de configuración
Mostrar los horarios de hoy, en la pantalla de configuración: el método usado y los ocho horarios de hoy, para compararlos con el horario de su mezquita antes de crear escenas.
Ejemplos de escenas
- Recordatorio del adhan: disparador Hora de la oración (Fajr, Dhuhr, Asr, Maghrib, Isha), acción Hablar en un altavoz con el texto «Es la hora de {{nombre de la oración}}».
- Prepararse: disparador Oración próxima, 15 minutos, Maghrib: encender el salón, enviar un mensaje «Maghrib a las {{hora}}».
- Ramadán: disparador Oración próxima, 30 minutos, Imsak: un mensaje a todos los teléfonos para la última comida antes del alba.
- Resumen de la mañana: a las 7:00, acción Obtener los horarios de oración y luego Enviar mensaje con los horarios del día.
Cómo se calculan los horarios
La declinación del sol y la ecuación del tiempo dan el mediodía solar (Dhuhr); el ángulo horario en el que el sol alcanza una depresión dada bajo el horizonte da Fajr e Isha, -0,833° (refracción y disco solar) da la salida y la puesta del sol, y la longitud de una sombra da Asr. Los resultados se redondean al minuto más cercano. Las pruebas de la integración los comparan con respuestas reales de Aladhan (mismo minuto), los horarios oficiales de Turquía, Catar, Dubái, Kuwait, La Meca, Singapur y Teherán, y la biblioteca adhan-js.
No se descarga nada: la integración no hace ninguna petición de red.
Solución de problemas
- El estado indica «Sin ubicación»: indique las coordenadas de su vivienda en Configuración → Viviendas, o escríbalas en la configuración, y guarde.
- Todos los horarios están desplazados una o dos horas: la zona horaria de Gladys es incorrecta (Configuración → Sistema).
- Unos minutos de diferencia con su mezquita: compruebe el método y la escuela del Asr con Mostrar los horarios de hoy y luego use los ajustes.
- La escena no se ha iniciado: compruebe los filtros del disparador (en
Oración próxima, el número de minutos es obligatorio) y que la integración
esté en marcha.
LOG_LEVEL=debugmuestra cada evento enviado en los registros. - Los nombres de las funciones están en otro idioma: se fijan al añadir el dispositivo: cambie el idioma, elimine el dispositivo y añádalo de nuevo.
Límites
- Todavía no hay método «Moonsighting Committee» (ángulos estacionales).
- Dentro de los círculos polares, los días sin salida ni puesta del sol, estos horarios quedan vacíos.
- Hablar en un altavoz lee un texto: reproducir un adhan grabado requiere una integración de altavoz capaz de reproducir un archivo de audio.
- La fecha de la Hégira es la del calendario Umm al-Qura, que puede diferir un día de la observación local de la luna; también decide cuándo se aplica el Isha del Ramadán de Umm al-Qura (120 min).
- Los horarios son los de la vivienda configurada: no hay ubicación por usuario.
Parámetros de configuración
Estos son los parámetros que Prayer Times te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Ubicación | section | No | Los horarios se calculan para la vivienda de Gladys (Configuración → Viviendas), en la zona horaria de Gladys. Las coordenadas introducidas tienen prioridad. |
| Vivienda | select | No | Vacío: la primera vivienda con coordenadas. |
| Latitud (opcional) | string | No | Grados decimales, norte positivo. Con la longitud, sustituye la vivienda. |
| Longitud (opcional) | string | No | Grados decimales, este positivo. |
| Cálculo | section | No | Elija el método de su mezquita o de su país. Los ángulos son la depresión del sol bajo el horizonte en Fajr e Isha. |
| Método de cálculo | select | No | |
| Asr (escuela) | select | No | |
| Latitudes altas | select | No | Cuando el crepúsculo dura toda la noche (en verano, al norte de unos 48°), Fajr e Isha se limitan a una parte de la noche. |
| Medianoche | select | No | |
| Método personalizado: ángulo de Fajr (°) | string | No | |
| Método personalizado: ángulo de Isha (°) | string | No | |
| Método personalizado: Isha, minutos tras Maghrib | number | No | 0: usar el ángulo de Isha. |
| Ajustes | section | No | Minutos añadidos a una hora calculada, para seguir el horario de su mezquita (negativo: antes). |
| Imsak: minutos antes de Fajr | number | No | |
| Fajr (min) | number | No | |
| Salida del sol (min) | number | No | |
| Dhuhr (min) | number | No | |
| Asr (min) | number | No | |
| Maghrib (min) | number | No | |
| Isha (min) | number | No | |
| Idioma de los nombres | select | No | Nombres de las funciones del dispositivo (fijados al añadirlo) y de las variables de escena. |
Cómo instalar Prayer Times en Gladys
- En Gladys, abre Integraciones: Prayer Times 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-prayer-times:1.0.1), 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-prayer-times.
Prayer Times 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
Prayer Times 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