bookorbit-android
Cliente Android nativo en Kotlin/Jetpack Compose para BookOrbit self-hosted. Soporta autenticación OIDC, lectura EPUB con Foliate, audiolibros con Media3 y descargas offline. Arquitectura MVVM con Hilt, Room y Retrofit.
Ficha actualizada 27 sept 2026, 19:40 · upstream 27 sept 2026, 19:28 · release v0.4.0
Qué es bookorbit-android
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio contiene el cliente móvil nativo para Android del servidor autoalojado BookOrbit. Desarrollado en Kotlin con Jetpack Compose, ofrece una experiencia completa de lectura incluyendo exploración de biblioteca, búsqueda avanzada, colecciones y gestión de autores/series. La aplicación integra el lector Foliate.js para EPUBs y el reproductor Media3 para audiolibros con funciones como temporizador de sueño y Chromecast.
La arquitectura sigue patrones MVVM con Hilt para la inyección de dependencias, Coroutines y Flow para la concurrencia, Retrofit para las llamadas a la API y Room para la persistencia local. Soporta autenticación directa y OIDC, permitiendo integración segura con servidores BookOrbit que implementan este protocolo. El proyecto es independiente del servidor pero requiere sincronización manual de modelos de datos y activos del lector.
El cliente está disponible vía F-Droid para distribución en repositorios libres, facilitando la instalación sin necesidad de tiendas comerciales. Incluye soporte para lectura offline y gestión de descargas mediante WorkManager.
- Lectura de libros EPUB en dispositivos Android mediante el motor Foliate.js
- Reproducción de audiolibros con soporte para Chromecast y temporizador de sueño
- Gestión de colecciones, autores y series dentro de la biblioteca personal
- Búsqueda avanzada y exploración del catálogo del servidor BookOrbit
- Descarga de contenido para lectura offline sin conexión a internet
- Autenticación segura con soporte para OIDC en servidores autoalojados
- Cliente nativo optimizado para Android con Jetpack Compose y Material 3
- Soporte completo para EPUB (Foliate) y audiolibros (Media3/ExoPlayer)
- Arquitectura modular con Hilt, Room y Retrofit para mantenimiento escalable
- Sincronización de progreso de lectura entre dispositivos mediante el servidor BookOrbit
- Integración con F-Droid para distribución en repositorios libres
- Soporte para autenticación OIDC y manejo seguro de tokens
- Requiere compilación local o instalación manual, no es un contenedor Docker
- Los modelos de datos de la API deben actualizarse manualmente si cambian en el servidor
- Los activos del lector Foliate requieren sincronización manual con el cliente web
- No soporta versiones antiguas de Android (mínimo SDK 26)
- Depende de que el servidor BookOrbit esté disponible y accesible desde la red local
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.
Requiere Android Studio Ladybug (2024.2) o superior, JDK 17+ y SDK API 36. Para desarrollo, configurar local.properties con la ruta del SDK. Instalar en dispositivo físico o emulador con minSDK 26. Conectar a servidor BookOrbit usando URL LAN o IP local. Preferir HTTPS si el servidor está expuesto públicamente.
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.