freshrss-extensions
Extensiones personalizadas para FreshRSS que solucionan problemas de UX como saltos de scroll, menús contextuales y actualizaciones silenciosas. Incluye gestor de extensiones para instalar sin SSH.
Ficha actualizada 27 sept 2026, 16:39 · upstream 27 sept 2026, 16:12 · release v0.7.0
Qué es freshrss-extensions
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona un conjunto de extensiones JavaScript diseñadas para mejorar la experiencia de usuario en FreshRSS, una aplicación de lectura RSS. Las soluciones abordan problemas comunes como los saltos bruscos al cambiar entre artículos, la falta de menús contextuales nativos y la necesidad de recargar manualmente la página. La extensión principal destaca es el gestor de extensiones, que permite instalar actualizaciones desde repositorios GitHub sin acceso SSH ni manipulación directa del sistema de archivos.
Las funcionalidades incluyen "Sticky Reader" para anclar el scroll y mantener la barra de navegación visible, "Right-Click Actions" para menús contextuales en artículos y categorías, y "Silent Refresh" para actualizar contadores no leídos vía API JSON sin recargar. También añade una sección "Recently Read" para filtrar artículos consumidos. Todas las extensiones son compatibles con FreshRSS 1.20+ y no requieren dependencias externas.
La instalación se realiza copiando los directorios `xExtension-*` en la carpeta `extensions/` de la instancia de FreshRSS. Se recomienda instalar primero el gestor de extensiones para facilitar la gestión posterior. La configuración es individual por extensión a través de la interfaz web, sin necesidad de archivos globales.
- Mejorar UX en lectura continua eliminando saltos de scroll al navegar entre feeds
- Gestionar suscripciones y leer artículos recientes filtrados automáticamente
- Actualizar contadores de no leídos en tiempo real sin recargar la página
- Instalar extensiones adicionales desde repositorios externos sin acceso SSH
- Gestor de extensiones integrado que elimina la necesidad de SSH para instalaciones
- Mejoras de UX específicas como anclaje de scroll y barra de navegación fija
- Menú contextual personalizado con acciones granulares por zona (artículo, sidebar)
- Actualizaciones atómicas con rollback automático en el gestor de extensiones
- Requiere FreshRSS versión 1.20 o superior para usar los hooks `js_vars` y `registerController`
- No incluye soporte Docker ni archivos de composición (solo instalación manual)
- Funcionalidad limitada a la interfaz web del cliente, sin backend adicional
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Copiar directorios `xExtension-*` en `<freshrss-root>/extensions/`. Para Docker, usar `/var/www/FreshRSS/extensions/`. Habilitar en configuración → Extensiones. No requiere variables de entorno adicionales ni puertos extra.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.