Integración domótica FreshRSS, gratuita y de código abierto
Su lector FreshRSS en Gladys: no leídos, nuevos artículos, marcar como leído.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Conecte Gladys con FreshRSS, el agregador de fuentes autoalojado: siga sus artículos no leídos por categoría y por fuente, reaccione cuando llega un nuevo artículo, marque artículos como leídos desde sus escenas y vea los últimos artículos no leídos en el panel. La integración sigue el estado de su lector (leído / no leído, el mismo en todas sus aplicaciones FreshRSS), no las fuentes en sí.
Probada con un FreshRSS 1.30.4 real (la imagen Docker oficial) y fuentes de prueba. Sus comentarios son bienvenidos en el foro de Gladys.
Requisitos previos
- Gladys Assistant 5.1 o posterior.
- FreshRSS, en casa o en un servidor público, accesible desde la máquina de Gladys.
- La API de FreshRSS permitida: como administrador, abra Administración → Autenticación y marque Permitir el acceso por API.
- Una contraseña de API para su usuario: abra Perfil → Gestión de la API, introduzca una contraseña de API y guarde. No es su contraseña de inicio de sesión; FreshRSS muestra la dirección de la API en la misma página.
Configuración
- Abra la pestaña Configuración de la integración.
- En Dirección de FreshRSS, introduzca la dirección donde abre FreshRSS,
por ejemplo
192.168.1.50:8080(http si no se indica nada) ohttps://rss.example.org. La dirección de API mostrada por FreshRSS (…/api/greader.php) también funciona. - Introduzca su Nombre de usuario y la Contraseña de API.
- Opcional: Leer FreshRSS cada (5 minutos por defecto), y Palabras clave a vigilar, separadas por comas, para el filtro de palabra clave del disparador «Nuevo artículo».
- Haga clic en Probar la conexión: muestra el usuario, los artículos no leídos, las fuentes y las categorías.
- Abra la pestaña Descubrimiento y añada los dispositivos que desee.
Dispositivos
- FreshRSS: Artículos no leídos (en total) y FreshRSS accesible (0 mientras FreshRSS no responde).
- Un dispositivo por categoría y un dispositivo por fuente (ofrecidos para cada una): sus Artículos no leídos.
Los valores se leen cada pocos minutos (el ajuste anterior) y justo después de cada cambio hecho desde Gladys. Se guardan en el historial, para un gráfico de su pila de no leídos. Para actuar por encima de un umbral, use el disparador de dispositivo de Gladys: Artículos no leídos superior a 50, por ejemplo.
Widget del panel
FreshRSS: el número de artículos no leídos, los seis últimos artículos no leídos (fuente, fecha, resumen, enlaces al artículo y a la fuente en FreshRSS cuando son https), un botón Actualizar que vuelve a leer FreshRSS ahora, y un botón Marcar leído, con confirmación, que marca como leídos los artículos mostrados (solo ellos). Ajustado a un dispositivo de categoría o de fuente, el widget muestra solo ese.
Disparadores de escena
- Nuevo artículo: ha llegado un artículo no leído a FreshRSS. Filtros: una categoría (un dispositivo de categoría), una fuente (un dispositivo de fuente), una palabra clave (una de las palabras clave de la configuración, encontrada en el título, sin distinguir mayúsculas ni acentos). Información transmitida: título, enlace, fuente, categoría, autor, palabra clave encontrada, fecha de publicación e id. del artículo.
Nada se dispara en la primera lectura tras instalar la integración, ni para los artículos ya presentes cuando se añade una fuente, ni para los artículos ya leídos en otra aplicación. Se anuncian como máximo 10 artículos por lectura.
Acciones de escena
- Marcar artículos de FreshRSS como leídos: todos los artículos no leídos de una categoría o fuente; elija el dispositivo FreshRSS para marcarlo todo. Resultados: artículos marcados, categoría o fuente.
- Marcar artículos como leídos por id.: uno o varios ids. de artículos, normalmente el id. del artículo del disparador «Nuevo artículo». Resultado: artículos marcados.
- Leer los títulos no leídos de FreshRSS: los artículos no leídos más recientes (1 a 10), de todo o de una categoría o fuente, marcados como leídos después si lo desea. Resultados: número leído, artículos no leídos en total, títulos uno por línea («Título — Fuente»), título, enlace y fuente del más reciente.
Ejemplos de escenas
- Resumen de la mañana: a las 7:30, Leer los títulos no leídos de FreshRSS (categoría Noticias, 5 artículos, después marcarlos como leídos), y luego enviar un mensaje de Telegram con su resultado Títulos (insértelo con el selector de variables).
- Vigilar un tema: con
Gladysen las palabras clave, Nuevo artículo con la palabra claveGladys→ enviar un mensaje con el Título y el Enlace del artículo, y luego Marcar artículos como leídos por id. con su Id. del artículo. - Demasiado por leer: disparador de dispositivo Artículos no leídos del dispositivo FreshRSS superior a 100 → Marcar artículos de FreshRSS como leídos en la categoría Sin categoría.
Solución de problemas
- «La API de FreshRSS está desactivada»: permita el acceso por API en Administración → Autenticación (debe hacerlo un administrador de FreshRSS).
- «FreshRSS rechazó el nombre de usuario o la contraseña de API»: la contraseña de API no es la de inicio de sesión; vuelva a definirla en Perfil → Gestión de la API.
- «FreshRSS no responde»: compruebe la dirección y el puerto desde la máquina de Gladys. Detrás de un proxy inverso, introduzca la dirección completa, ruta incluida.
- «FreshRSS redirige a otra dirección»: FreshRSS responde en otra
dirección, a menudo la misma en
https://: introduzca esa. - «Esta dirección no responde como FreshRSS»: la dirección lleva a otro
servicio, o a una página de inicio de sesión (un proxy de autenticación
delante de FreshRSS debe dejar pasar
/api/). - Ningún evento «Nuevo artículo»: los artículos llegan cuando FreshRSS
actualiza sus fuentes (su tarea cron,
CRON_MINen la imagen Docker oficial; cada fuente como máximo una vez por hora por defecto), y luego en la siguiente lectura de la integración. - Más detalles: ponga la variable
LOG_LEVELde la integración endebug.
Limitaciones
- FreshRSS solo conoce las categorías por su nombre: renombrar una categoría en FreshRSS ofrece un nuevo dispositivo, el antiguo queda sin valores.
- La API de FreshRSS no indica las fuentes con error y no permite pedir la actualización de las fuentes: FreshRSS mantiene su propio ritmo.
- Los filtros de los disparadores solo comparan valores exactos: el filtro de palabra clave es una de las palabras clave configuradas, escrita como en la configuración (la primera encontrada en el título).
- Los favoritos, las etiquetas y las fuentes en sí no se gestionan desde Gladys. Se ofrecen como máximo 100 categorías y 200 fuentes como dispositivos.
- Los enlaces del widget solo abren direcciones https: un artículo o un FreshRSS en http simple no tiene enlace.
- Sin relación con FreshRSS.
Parámetros de configuración
Estos son los parámetros que FreshRSS te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar FreshRSS | section | No | En FreshRSS, permita el acceso por API (Administración → Autenticación) y defina una contraseña de API para su usuario (Perfil → Gestión de la API). Introduzca la dirección de FreshRSS, su nombre de usuario y esa contraseña de API: la integración lee sus no leídos, anuncia los nuevos artículos y marca artículos como leídos desde sus escenas. |
| Dirección de FreshRSS | string | Sí | La dirección donde abre FreshRSS, o la dirección de API mostrada en Perfil → Gestión de la API. |
| Nombre de usuario | string | Sí | |
| Contraseña de API | secret | Sí | No la contraseña de inicio de sesión: FreshRSS → Perfil → Gestión de la API → Contraseña de API. |
| Leer FreshRSS cada | select | No | Los nuevos artículos se anuncian en la siguiente lectura, una vez que FreshRSS los ha obtenido (su propia actualización, por su tarea cron). |
| Palabras clave a vigilar (opcional) | string | No | Separadas por comas. Un nuevo artículo cuyo título contenga una la lleva, para el filtro de palabra clave del disparador. |
| Idioma de nombres y mensajes | select | No | Los nombres de las funciones se fijan al añadir un dispositivo a Gladys. |
Cómo instalar FreshRSS en Gladys
- En Gladys, abre Integraciones: FreshRSS 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-freshrss: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-freshrss.
FreshRSS 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
FreshRSS 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