Frirss
Frontend web auto-alojado para FreshRSS que reemplaza la interfaz nativa mediante Google Reader API. Soporta Next.js, React, Node.js, Docker (amd64/arm64), caché Redis, PWA y personalización profunda de temas y layout.
Ficha actualizada 25 sept 2026, 10:26 · upstream 25 sept 2026, 8:39 · release v1.4.11
Qué es Frirss
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
FriRSS es una interfaz web moderna y auto-alojada para FreshRSS que reemplaza únicamente la capa de presentación, manteniendo el motor de gestión de feeds del backend. Se conecta a través de la API de Google Reader de FreshRSS, permitiendo una experiencia de usuario personalizada sin duplicar datos ni funcionalidades críticas.
El proyecto utiliza Next.js y React con Node.js como framework principal, ejecutándose sobre SQLite para persistencia local y opcionalmente Redis para caché de lectura. Incluye soporte nativo para PWA en móviles, navegación por gestos, extracción de texto completo (Readability), lectura offline y gestión de estados de lectura/favoritos.
Destaca por su alta personalización: seis temas predeterminados más capacidad de creación propia con control sobre 36 colores y 7 tamaños de fuente. Soporta multi-usuario con roles admin/user, autenticación SSO vía OIDC (probado con Authentik) y conexión a múltiples instancias de FreshRSS simultáneamente.
- Leer feeds RSS en un frontend moderno sin instalar el backend completo de FreshRSS
- Personalizar completamente la interfaz visual, temas y layout para adaptarse a preferencias de accesibilidad
- Gestionar múltiples instancias de FreshRSS desde una única interfaz web centralizada
- Acceder a contenido RSS offline mediante PWA con sincronización automática al recuperar conexión
- Frontend completamente personalizado sobre Google Reader API, no es un clon genérico
- Soporte nativo para PWA en móviles con navegación por gestos y pull-to-refresh
- Caché opcional con Redis y pre-búsqueda de artículos para carga instantánea
- Personalización granular: 36 colores, 7 tamaños de fuente, exportación/importación de temas
- Autenticación SSO vía OIDC probado con Authentik y soporte passkeys
- Lectura offline completa con imágenes y estados de lectura/favoritos persistentes
- Requiere una instancia FreshRSS existente con API habilitada (no es un lector independiente)
- Bloqueo por defecto a hosts privados (LAN/Docker) que debe configurarse manualmente
- Demo pública comparte estado de lectura/favoritos entre todos los usuarios visitantes
- Dependencia de SQLite para almacenamiento local sin soporte directo para bases de datos externas
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.
Despliegue recomendado con Docker en contenedor ghcr.io/fripix/frirss:latest. Asegurar FRIRSS_BASE_URL detrás de reverse proxy. Configurar PROXY_INTERNAL_HOSTS si FreshRSS está en red privada (ej. 192.168.x.x). Habilitar REDIS_URL para caché opcional. Backup del directorio frirss-data incluye JWT secret y claves de cifrado. Requiere PUID/PGID=1000 por defecto.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.