API Nextcloud News v1.3
Implementa la API completa: carpetas, feeds, articulos, estados leido/no leido y destacados. No inventa un protocolo nuevo.
Un lector RSS/Atom compatible con la API de Noticias de Nextcloud. Un unico binario en Go, SQLite, sin PHP ni cron por separado.
ocnews sigue los principios del Club Cloudless: software libre, sin nube de terceros, pensado para quien quiere tener el control de sus datos sin montar un centro de datos en casa.
Sin promesas. Cada funcion esta en el codigo, probada en produccion propia.
Implementa la API completa: carpetas, feeds, articulos, estados leido/no leido y destacados. No inventa un protocolo nuevo.
La app Nextcloud News de Android funciona contra ocnews con un token de aplicacion de OpenCloud. Sincronizacion, lectura y podcasts probados.
Un daemon en segundo plano ajusta el intervalo de cada feed: los silenciosos esperan mas, los activos se refrescan antes. Con backoff exponencial y jitter.
Imagenes y audio o video de los feeds se sirven con firma HMAC, incluso bajo CSP estrictas. Streaming con Range para poder hacer seek.
Los feeds que solo envian resumen pueden extraer el articulo completo del origen, sanitizarlo y cachearlo. Los que ya traen texto completo se respetan.
Migra tus suscripciones desde cualquier lector compatible. Tambien disponible en la interfaz web para arrastrar y restaurar.
Define reglas por feed sobre titulo, cuerpo o URL. Los articulos que coinciden se marcan como filtrados y puedes mostrarlos u ocultarlos.
Busca en titulo, cuerpo o URL dentro de tus feeds. Excluye los articulos filtrados por defecto.
Detecta feeds con audio o video y los agrupa en una seccion propia, con reproductor in-app a traves del proxy firmado.
Los usuarios se validan contra la Graph API de OpenCloud. No hay otra base de usuarios que mantener ni contrasenas duplicadas.
Cada articulo se limpia con una politica blanca al entrar, tanto en la suscripcion como en el refresco. Ningun body llega tal cual.
La interfaz y los mensajes de error negocian el idioma por usuario. No depende del idioma del sistema.
Capturas reales de la extension web. Tema claro y oscuro. Idioma ingles en las imagenes; la interfaz tambien habla espanol.
Contrastado contra las fuentes publicas de cada proyecto en agosto de 2026. Sin humo: marcamos lo que ocnews aun no hace.
| Funcion | ocnews | Nextcloud News | FreshRSS | Miniflux |
|---|---|---|---|---|
| Stack | Go + SQLite | PHP + MariaDB/PostgreSQL + cron | PHP + SQLite/MySQL/PostgreSQL | Go + PostgreSQL |
| Integracion OpenCloud | ✓ | No aplica | No aplica | No aplica |
| API Nextcloud News v1.3 | ✓ | ✓ | ◐ API Google Reader | ◐ API Fever / Google Reader |
| App Android oficial | ✓ | ✓ | ◐ apps de terceros | ◐ apps de terceros |
| Extraccion de texto completo | ✓ | ✓ | ✓ | ✓ |
| Filtros por palabras clave | ✓ | ✓ | ✓ | ✓ |
| Busqueda de articulos | ✓ | ✓ | ✓ | ✓ |
| OPML import/export | ✓ | ✓ | ✓ | ✓ |
| Soporte de podcasts | ✓ | ✓ | ✓ | ✓ |
| Extension web integrada | ✓ | ✓ | ✗ interfaz web propia | ✗ interfaz web propia |
| Multiusuario | ✓ | ✓ | ✓ | ✓ |
| Licencia | AGPL-3.0 | AGPL-3.0 | AGPL-3.0 | Apache-2.0 |
ocnews no sustituye a un ecosistema maduro como FreshRSS ni a la comunidad de Nextcloud. Es un lector enfocado: sirve si ya usas OpenCloud y quieres la menor superficie de ataque posible. No tiene estadisticas de lectura avanzadas, ni themes de comunidad, ni un catalogo de plugins. Si necesitas eso, FreshRSS o Nextcloud News son mejores opciones hoy.
No hay instalador magico. Compila el binario, configura unas variables y anade una location a nginx.
1. Clona y compila el backend
git clone https://github.com/gnacho/ocnews
cd ocnews/backend
go test ./...
CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o ocnews ./cmd/ocnews
2. Configura el entorno
OCNEWS_ADDR=:8094
OCNEWS_DATA_DIR=/var/lib/ocnews
OCNEWS_AUTH_MODE=opencloud
OCNEWS_OPENCOLOUD_URL=https://cloud.example.com
3. Anade la location a nginx
location /index.php/apps/news/ {
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://127.0.0.1:8094;
}
Para la extension web, compila extension/ y copia dist/ a la carpeta de apps de OpenCloud. Los detalles completos estan en el README del repositorio.
Llevo anos usando Nextcloud y me gusta su ecosistema, pero la pila de debajo se fue haciendo demasiado para mi gusto: PHP, servidor web, base de datos, cron y actualizaciones que arrastran medio Composer. Cada maquina en la que lo ponia acababa pareciendo un pequeno centro de datos.
OpenCloud apuesta por lo contrario: todo, incluido lo que Nextcloud hace en PHP, dentro de un unico binario en Go. Es mas joven, con menos apps y menos madurez, pero la base es prometedora. ocnews es mi primera aportacion: mover la experiencia de lector RSS que me importa a OpenCloud sin romper los clientes que ya uso.
Es software libre bajo AGPL-3.0, gratuito y sin nube de terceros. Cada version se prueba primero en mi propia instancia. Con ayuda o apoyo podria crecer mas rapido, pero no puedo prometer nada.
Si te resulta util, puedes invitarme a un cafe. No compra caracteristicas: solo tiempo para seguir puliendo.
Invitar en Ko-fi