readsync
ReadSync es un servicio auto-alojado para Windows que sincroniza el progreso de lectura entre KOReader, Moon+, Calibre y Goodreads sin depender de la nube ni claves API.
Ficha actualizada 25 sept 2026, 16:01 · upstream 25 sept 2026, 15:33 · release v0.2.1
Qué es readsync
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ReadSync actúa como un puente local que centraliza el estado de lectura en dispositivos móviles y lectores electrónicos. Está construido en Go 1.25+ y utiliza SQLite para persistencia de datos, garantizando una operación ligera y segura sin dependencias de bases de datos externas complejas.
El servicio implementa adaptadores específicos para cada plataforma: KOSync HTTP API para KOReader, WebDAV para Moon+ Reader Pro y gestión de columnas personalizadas en Calibre. La arquitectura incluye un pipeline de eventos interno, resolución de conflictos y una interfaz administrativa local protegida contra CSRF.
La seguridad es prioritaria, almacenando credenciales mediante Windows DPAPI o Credential Manager y evitando la exposición de datos a servicios externos. El despliegue requiere instalación manual del ejecutable en Windows 10/11, sin contenedores Docker.
- Sincronización bidireccional del progreso de lectura entre un PC Windows y lectores electrónicos KOReader o Moon+.
- Centralización de estadísticas de lectura en Calibre para generar informes sin intervención manual.
- Migración de datos de progreso desde Goodreads a una base de datos local privada mediante plugin.
- Auditoría del estado de lectura en múltiples dispositivos desde un panel administrativo local.
- Operación completamente auto-alojada sin necesidad de claves API ni servicios en la nube.
- Arquitectura modular con adaptadores intercambiables para diferentes lectores (KOReader, Moon+, Calibre).
- Persistencia de datos local mediante SQLite con modo WAL para rendimiento y concurrencia.
- Gestión segura de credenciales utilizando almacenamiento nativo de Windows (DPAPI/Credential Manager).
- Interfaz administrativa web protegida contra ataques CSRF y limitada a localhost por defecto.
- Restringido exclusivamente al sistema operativo Windows 10/11, sin soporte para Linux o macOS.
- Requiere compilación con CGO y GCC (TDM-GCC) para construir desde fuente debido a la dependencia de SQLite C bindings.
- Dependencia externa de plugins en Calibre y Goodreads para habilitar la sincronización de progreso.
- Necesita permisos de administrador del sistema para instalar el servicio como Windows Service.
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.
Descargar la versión binaria desde GitHub Releases. Ejecutar el instalador con privilegios de administrador. Configurar reglas de firewall para los puertos 7200 (KOReader), 8765 (Moon+) y 7201 (Admin UI). Asegurar que Go 1.25+ esté instalado en PATH si se compila desde fuente. Verificar la configuración del plugin Goodreads dentro de Calibre antes de iniciar la sincronización.
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.