shelfarr
Sistema auto-alojado para gestión de peticiones y descarga de libros electrónicos y audiolibros, integrado con el ecosistema *arr y entregando a bibliotecas como Audiobookshelf.
Ficha actualizada 23 sept 2026, 22:50 · upstream 23 sept 2026, 22:20 · release v2026.09.18.1
Qué es shelfarr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Shelfarr es una herramienta de autogestión diseñada para automatizar la adquisición de libros digitales y audiolibros dentro del ecosistema *arr. Funciona analizando peticiones de usuarios, buscando en indexadores (Prowlarr, Jackett) o fuentes directas (Anna's Archive, Z-Library), y seleccionando automáticamente la mejor versión según preferencias de formato y calidad. Una vez descargado, el sistema renombra los archivos, organiza las carpetas y sincroniza la biblioteca con clientes como Audiobookshelf, BookOrbit o Grimmory sin intervención manual.
El proyecto está construido sobre Ruby on Rails y se despliega principalmente mediante Docker Compose. Soporta autenticación robusta mediante TOTP y OIDC/SSO (Authentik, Authelia), además de notificaciones vía Discord, Telegram o webhooks. Incluye una API REST para integraciones externas y permite configuraciones avanzadas de enrutamiento de descargas y gestión de usuarios con roles.
Destaca por su capacidad de manejar descargas directas sin necesidad de clientes torrent para ciertas fuentes, y ofrece integraciones beta como el respaldo de Audible mediante Libation o la compra directa desde tiendas DRM-free, manteniendo siempre la privacidad del usuario al no procesar datos de pago.
- Automatizar la adquisición de audiolibros para bibliotecas personales conectadas a Audiobookshelf.
- Gestionar peticiones de usuarios múltiples con roles y permisos diferenciados en un servidor auto-alojado.
- Descargar libros directamente desde repositorios públicos como Anna's Archive o LibriVox sin usar torrents.
- Integrar el sistema con proveedores SSO (Authentik, Authelia) para gestión centralizada de identidad.
- Automatizar la sincronización de bibliotecas entre múltiples clientes de lectura (BookOrbit, Grimmory).
- Arquitectura basada en Rails y Puma con soporte nativo para Docker Compose y contenedores OCI.
- Soporte multi-cliente para descarga vía torrent/usenet (qBittorrent, NZBGet) y descargas directas HTTP.
- Integración beta funcional con Libation para respaldo de compras Audible sin gestionar pagos.
- Autenticación híbrida con TOTP y OIDC/SSO compatible con proveedores estándar del sector.
- API REST segura con tokens por usuario bajo el endpoint /api/v1.
- Las integraciones beta (Audible Backup, tiendas de terceros) están deshabilitadas por defecto y requieren configuración manual.
- El sistema asume que todos los procesos ejecutados con la misma PUID son confiables para seguridad de archivos.
- La integración Audible Backup requiere soporte de locks, hard links y permisos Unix específicos en el sistema de archivos.
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.
Desplegar mediante Docker Compose es la ruta recomendada. Se debe configurar correctamente las variables PUID/PGID para compatibilidad con volúmenes montados. Si se usa NFS, activar TRUST_NFS_UID_SQUASH solo si el export está configurado como single-tenant. Para sub-paths detrás de proxies inversos, usar RAILS_RELATIVE_URL_ROOT. La primera instalación genera una clave de cifrado automática.
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.