codexa
Lector auto-alojado de EPUB y cómics con motor propio CXReader, sincronización bidireccional con KOReader y BookOrbit, soporte multiusuario, OPDS y diccionarios StarDict en un contenedor Node.js ligero.
Ficha actualizada 21 sept 2026, 14:50 · upstream 21 sept 2026, 14:50 · release v2.6.4
Qué es codexa
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Codexa es una plataforma de lectura privada auto-alojada diseñada para EPUBs y cómics, ofreciendo renderizado fiel incluso en pantallas e-ink mediante su motor propio CXReader. Soporta formatos como KEPUB (Kobo), CBZ/CBR y PDF, integrando diccionarios StarDict y sincronización bidireccional con KOReader y BookOrbit sin depender de la nube.
El sistema incluye soporte multiusuario con autenticación JWT, gestión de estantes (shelves) y navegación OPDS para importar catálogos externos como Calibre-Web o Komga. Ofrece una experiencia PWA instalable en móviles y escritorio, con aplicaciones nativas para Android e iOS, permitiendo lectura offline y recuperación de progreso exacto.
La configuración se realiza mediante variables de entorno, incluyendo un secreto JWT obligatorio para seguridad. El despliegue es sencillo vía Docker en un único contenedor, aunque requiere generación manual del secreto inicial y asignación de directorios persistentes para datos, libros y bases de datos.
- Lectura offline de bibliotecas personales de EPUBs y cómics sin depender de servicios en la nube.
- Sincronización de progreso de lectura entre múltiples dispositivos (móvil, tablet, lector e-ink) mediante KOReader o BookOrbit.
- Navegación y descarga directa desde servidores OPDS externos como Calibre-Web o Komga.
- Gestión de diccionarios StarDict para traducción en tiempo real dentro del lector.
- Lectura colaborativa o compartida mediante cuentas multiusuario con autenticación JWT.
- Motor CXReader propio optimizado para e-ink y renderizado fiel de tipografía y cómics.
- Sincronización bidireccional nativa con KOReader (KOSync) y BookOrbit sin intermediarios.
- Soporte multiusuario con gestión de estantes, progreso y preferencias por usuario.
- Compatibilidad con formatos KEPUB, CBZ/CBR y PDF con caché offline.
- Integración PWA para escritorio y aplicaciones nativas en Android e iOS.
- Gestión de diccionarios StarDict local con detección automática de idioma.
- Requiere configuración manual del secreto JWT (JWT_SECRET) para habilitar la autenticación.
- No incluye archivo docker-compose por defecto, se debe copiar el archivo sample manualmente.
- Soporte PDF limitado a visualización de páginas como imágenes sin capa de texto o OCR.
- La sincronización de diccionarios no se incluye en los presets de configuración del lector.
- El soporte para autenticación OIDC requiere configuración adicional de proveedores externos.
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 vía Docker copiando docker-compose.sample.yaml a docker-compose.yaml. Generar un secreto JWT aleatorio (≥64 caracteres) y asignarlo a la variable JWT_SECRET. Asegurar que el directorio DATA_DIR exista para persistencia de libros, cubiertas, fuentes y base de datos. El servidor escucha en el puerto 3000 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.