ArcSync — Sincroniza tu lectura en KOReader

Todo lo que necesitas para no perder ni una página Everything you need — never lose your place again

Un servidor, un plugin de KOReader y una app móvil — construidos juntos, pensados para lectores serios. One server, one KOReader plugin, one mobile app — built together, made for serious readers.

🔄

Sincronización totalFull sync

Progreso, highlights, notas y marcadores se mantienen al día en todos tus dispositivos, automáticamente al abrir y cerrar cada libro.Progress, highlights, notes and bookmarks stay current across every device, automatically as you open and close each book.

📶

Compatible con lectores tipo Xteink/CrossPointWorks with Xteink/CrossPoint-style readers

¿Tu lector no corre KOReader (como los Xteink, con firmware CrossPoint)? Vincula tu cuenta de ArcSync por el protocolo KOSync y sincroniza al menos tu avance de lectura.Is your reader not running KOReader (like Xteink devices, running the CrossPoint firmware)? Link your ArcSync account over the KOSync protocol to sync at least your reading progress.

📊

Estadísticas completasDeep reading stats

Tiempo leído por día, semana y mes, racha de lectura, mapa de calor anual, ritmo en páginas por hora y tiempo estimado para terminar cada libro.Time read per day/week/month, a reading streak, a yearly heatmap, your pace in pages/hour and an estimate of time left to finish each book.

🎯

Metas diarias y notificacionesDaily goals & push alerts

Ponte una meta de minutos al día y recibe un aviso si tu racha está en riesgo o si estás a punto de terminar un libro.Set a daily reading-minutes goal and get notified if your streak is at risk or you are about to finish a book.

📚

Lista o modo estanteList or shelf view

Explora tu biblioteca en lista o en un estante visual con portadas, al estilo de tus apps de lectura favoritas — con un estante aparte para libros terminados.Browse your library as a list or a visual shelf with covers, like your favorite reading apps — plus a separate shelf for books you have finished.

📝

Exporta y repasa tus highlightsExport & review highlights

Exporta las anotaciones de cualquier libro a Markdown, o repásalas una por una en un modo de revisión al estilo Readwise.Export any book's annotations to Markdown, or review them one at a time in a Readwise-style review mode.

📴

Funciona sin conexiónWorks offline

La app móvil guarda una copia local de tus libros y estadísticas, así que puedes seguir consultándolos sin señal.The mobile app keeps a local copy of your books and stats, so you can keep browsing them with no signal.

🖼️

Portadas reales de tus librosReal covers for your books

El plugin captura la portada directo desde KOReader y la sube, así que en la app ves exactamente la edición que estás leyendo, no una genérica.The plugin captures the cover straight from KOReader and uploads it, so the app shows exactly the edition you're reading, not a generic stand-in.

🌐

Español e inglésEnglish & Spanish

La app móvil, el plugin de KOReader y esta página funcionan completas en español e inglés.The mobile app, the KOReader plugin and this very page all work fully in both English and Spanish.

Cómo empezar How to get started

Cinco pasos, dos partes: el plugin en KOReader y la app en tu celular. Todo lo demás pasa solo. Five steps, two parts: the KOReader plugin and the phone app. Everything else happens automatically.

1

Crea tu cuentaCreate your account

Abre la app móvil de ArcSync (o el panel web) y regístrate con tu nombre, correo y contraseña — el registro está abierto, no necesitas invitación.Open the ArcSync mobile app (or the web dashboard) and register with your name, email and password — registration is open, no invite needed.
2

Descarga e instala el plugin en KOReaderDownload and install the plugin in KOReader

Descarga el .zip del plugin (botón abajo) y copia la carpeta ArcSync.koplugin que trae adentro a la carpeta de plugins de KOReader (en Android: la carpeta koreader/plugins/ de tu almacenamiento; en Kobo: .adds/koreader/plugins/). Reinicia KOReader. Instrucciones detalladas por plataforma en la guía técnica más abajo.Download the plugin's .zip (button below) and copy the ArcSync.koplugin folder inside it into KOReader's plugins folder (on Android: the koreader/plugins/ folder on shared storage; on Kobo: .adds/koreader/plugins/). Restart KOReader. Full per-platform instructions in the technical guide below.
3

Inicia sesión desde el pluginSign in from the plugin

Abre cualquier libro → menú (☰) → ArcSync. El campo "Server URL" ya viene con arcsync.codigoarcano.com listo — no lo toques. Toca "Login (email/password)", inicia sesión con tu cuenta y, cuando te lo pida, dale un nombre a este dispositivo.Open any book → menu (☰) → ArcSync. The "Server URL" field already has arcsync.codigoarcano.com set — leave it as is. Tap "Login (email/password)", sign in with your account, and when asked, give this device a name.
4

Inicia sesión en la app móvilSign in on the mobile app

Abre la app en tu celular e inicia sesión con la misma cuenta. Verás tu biblioteca, highlights y estadísticas de inmediato.Open the app on your phone and sign in with the same account. Your library, highlights and stats show up right away.
5

Lee normalmenteJust keep reading

A partir de aquí todo se sincroniza solo: al abrir y cerrar cada libro, cada pocos minutos en segundo plano y unos segundos después de cada highlight o nota nueva.From here on everything syncs by itself: when you open and close each book, every few minutes in the background, and a few seconds after each new highlight or note.

⬇️ Descargar plugin (.zip)Download plugin (.zip) Crear mi cuentaCreate my account

¿Tu lector no puede correr KOReader? (Xteink, CrossPoint…) Is your reader unable to run KOReader? (Xteink, CrossPoint…)

Si tu dispositivo no puede instalar el plugin de KOReader — por ejemplo, un Xteink, que usa el firmware CrossPoint en vez de KOReader — en Ajustes → "KOReader nativo / CrossPoint" de la app activa un usuario y contraseña aparte, y úsalos en la pantalla de sincronización de tu lector (suele llamarse "KOReader Sync"). Sincronizarás el avance de lectura (no highlights ni notas), ligado a tu misma cuenta de ArcSync. Instrucciones exactas, campo por campo, en la guía técnica. If your device can't install the KOReader plugin — for example, an Xteink, which runs the CrossPoint firmware instead of KOReader — in the app's Settings → "Native KOReader / CrossPoint", turn on a separate username and password, then use them in your reader's own sync screen (usually called "KOReader Sync"). That syncs your reading progress (not highlights or notes), tied to the same ArcSync account. Exact field-by-field steps are in the technical guide.

Guía técnica Technical guide

Cada botón, cada campo y para qué sirve. Toca cualquier pregunta para expandirla. Every button, every field, and what it's for. Tap any question to expand it.

1. Instalar el plugin en KOReader 1. Installing the plugin in KOReader

¿Dónde descargo el plugin?Where do I download the plugin? ⌄

Toca el botón "Descargar plugin (.zip)" más arriba. Descarga un archivo llamado ArcSync.koplugin.zip que, al descomprimirlo, te da una carpeta llamada ArcSync.koplugin. Esa carpeta completa es la que copias a KOReader — no copies solo los archivos sueltos. Tap the "Download plugin (.zip)" button above. It downloads a file called ArcSync.koplugin.zip which, once unzipped, gives you a folder called ArcSync.koplugin. That whole folder is what you copy into KOReader — not just the loose files inside it.

¿Cómo encuentro la carpeta correcta en cualquier dispositivo?How do I find the right folder on any device? ⌄

KOReader funciona igual en Android, Kobo, Kindle, PocketBook, o instalado en una PC/Mac/Linux — y en todos los casos guarda sus plugins dentro de una carpeta llamada koreader/, que aparece directamente en el almacenamiento de tu dispositivo (junto a otras como Download/ o Pictures/). Para encontrarla: abre KOReader sin entrar a ningún libro — la pantalla que ves es su explorador de archivos, con la lista de carpetas de tu almacenamiento. Busca ahí koreader/, ábrela, y dentro crea (o usa, si ya existe) plugins/ArcSync.koplugin/. KOReader works the same way on Android, Kobo, Kindle, PocketBook, or installed on a PC/Mac/Linux — and in every case it keeps its plugins inside a folder called koreader/, which shows up directly in your device's storage (alongside others like Download/ or Pictures/). To find it: open KOReader without entering any book — the screen you see is its file browser, listing your storage's folders. Look for koreader/ there, open it, and inside create (or use, if it already exists) plugins/ArcSync.koplugin/.

Los dos casos más comunes (Android y Kobo) están detallados abajo. En Kindle, PocketBook o una instalación de escritorio la idea es idéntica, aunque no hemos verificado la ruta exacta en esos dispositivos — usa el método del explorador de archivos de arriba si no la encuentras a la primera. The two most common cases (Android and Kobo) are detailed below. On Kindle, PocketBook or a desktop install the idea is identical, though we haven't verified the exact path on those devices — use the file-browser method above if you don't find it on the first try.

Tengo Android, ¿dónde pongo la carpeta?I have Android, where does the folder go? ⌄

Usando el explorador de archivos de tu teléfono, ve al almacenamiento compartido, a la carpeta que KOReader ya usa (normalmente koreader/, la misma donde están sus carpetas settings/ y screenshots/), y dentro de ella crea: Using your phone's file manager, go to shared storage, to the folder KOReader already uses (usually koreader/, the same one holding its settings/ and screenshots/ folders), and inside it create:

koreader/plugins/ArcSync.koplugin/

Copia ahí el contenido de la carpeta descomprimida. Si no encuentras esa ruta, abre KOReader sin entrar a ningún libro — esa pantalla es su explorador de archivos, y ahí verás la carpeta koreader/ real que está usando en tu teléfono. Reinicia KOReader después de copiar. Copy the unzipped folder's contents there. If you can't find that path, open KOReader without entering any book — that screen is its file browser, and you'll see the real koreader/ folder it's using on your phone there. Restart KOReader after copying.

Tengo un Kobo, ¿dónde pongo la carpeta?I have a Kobo, where does the folder go? ⌄

Conecta el Kobo por USB a tu computadora. En el almacenamiento del Kobo, crea (si no existe) la ruta: Connect the Kobo to your computer over USB. On the Kobo's storage, create (if it doesn't exist) the path:

.adds/koreader/plugins/ArcSync.koplugin/

Copia ahí dentro el contenido de la carpeta ArcSync.koplugin que descomprimiste. Expulsa/desmonta el Kobo de forma segura y reinicia KOReader (o el Kobo) para que el plugin aparezca. Copy the contents of the ArcSync.koplugin folder you unzipped in there. Safely eject/unmount the Kobo and restart KOReader (or the Kobo itself) for the plugin to show up.

2. El menú ArcSync, opción por opción 2. The ArcSync menu, option by option

Después de reiniciar KOReader, abre cualquier libro → toca el centro de la pantalla para el menú (☰) → "Más herramientas" → ArcSync. After restarting KOReader, open any book → tap the center of the screen for the menu (☰) → "More tools" → ArcSync.

"Sync now" ⌄

Sincroniza ahora mismo, sin esperar al ciclo automático. Útil justo después de leer si quieres ver el cambio reflejado de inmediato en la app o en otro dispositivo.Syncs right now, without waiting for the automatic cycle. Useful right after reading if you want the change reflected immediately in the app or on another device.

"Last sync" ⌄

Muestra cuándo fue la última sincronización exitosa y un resumen (cuántos cambios se enviaron/recibieron). Tócalo para ver el detalle completo.Shows when the last successful sync happened and a summary (how many changes were sent/received). Tap it to see the full detail.

"Server URL" ⌄

La dirección del servidor ArcSync. Ya viene puesta en arcsync.codigoarcano.com — no necesitas tocarla salvo que tú mismo administres otro servidor ArcSync.The ArcSync server's address. Already set to arcsync.codigoarcano.com — you don't need to touch it unless you personally run a different ArcSync server.

"Login (email/password)" ⌄

Inicia sesión con tu cuenta de ArcSync (correo y contraseña). La primera vez te pedirá también un nombre para este dispositivo (por ejemplo "Mi lector"). Una vez dentro, este renglón cambia a "Logged in (tu-correo)".Signs in with your ArcSync account (email and password). The first time it will also ask for a name for this device (e.g. "My reader"). Once logged in, this row changes to "Logged in (your-email)".

"Device name" ⌄

El nombre con el que este dispositivo aparece en la app y en Ajustes → Dispositivos. Puedes cambiarlo cuando quieras.The name this device shows up as in the app and under Settings → Devices. You can change it any time.

"Language/Idioma" ⌄

Cambia el idioma del menú del plugin entre English y Español — no afecta tus datos, solo cómo se ven estos textos.Switches the plugin menu's language between English and Español — doesn't affect your data, just how these texts look.

"Check for updates" ⌄

Compara la versión instalada contra la versión más reciente en el servidor. Si hay una nueva, te pregunta antes de descargarla y reemplazar los archivos del plugin — después pide reiniciar KOReader.Compares your installed version against the latest one on the server. If there's a newer one, it asks for confirmation before downloading it and replacing the plugin's files — then asks you to restart KOReader.

"Diagnostics" ⌄

Un registro de las últimas ~200 líneas de actividad (sincronizaciones, errores, dispositivo/libro). Útil para ver qué está pasando o para compartir una captura si algo falla.A log of the last ~200 lines of activity (syncs, errors, device/book). Useful to see what's going on, or to screenshot if something breaks.

"Clear diagnostics log" ⌄

Borra ese registro. No afecta tu progreso ni tus anotaciones, solo el historial de depuración.Clears that log. Doesn't affect your progress or annotations, just the debug history.

"Reset sync cursor (advanced)" ⌄

Solo para casos raros (el servidor se restauró desde una copia de seguridad y este dispositivo quedó "atorado"). Fuerza a este dispositivo a volver a descargar todo desde cero. No lo uses a menos que Diagnostics muestre que algo quedó estancado.Only for rare cases (the server was restored from a backup and this device got "stuck"). Forces this device to re-download everything from scratch. Don't use it unless Diagnostics shows something is stuck.

"Automatic sync" ⌄

El interruptor maestro: si lo apagas, nada se sincroniza solo — tendrás que usar "Sync now" manualmente cada vez.The master switch: turn it off and nothing syncs by itself — you'll have to use "Sync now" manually every time.

"Sync progress / highlights / notes / bookmarks" ⌄

Cuatro interruptores independientes: apaga cualquiera si NO quieres que esa categoría en particular se sincronice (por ejemplo, si quieres llevar tus notas solo en un dispositivo). Todos vienen activados por defecto.Four independent switches: turn any one off if you do NOT want that particular category to sync (for example, if you want to keep your notes on just one device). All are on by default.

"Sync reading statistics" ⌄

Envía los datos del plugin Statistics de KOReader (tiempo por página, sesiones) para que la app pueda mostrarte racha, ritmo y tiempo restante estimado.Sends data from KOReader's own Statistics plugin (time per page, sessions) so the app can show you your streak, pace and estimated time left.

"Sync on opening a book / Sync on closing a book" ⌄

Dispara una sincronización automática justo al abrir o cerrar un libro, además del ciclo en segundo plano cada pocos minutos.Fires an automatic sync right when you open or close a book, on top of the every-few-minutes background cycle.

"About ArcSync" ⌄

Muestra la versión instalada y los créditos del proyecto.Shows the installed version and the project's credits.

3. La app móvil 3. The mobile app

¿Cómo me registro en la app?How do I register in the app? ⌄

Abre la app, toca "Regístrate" en la pantalla de inicio, y llena nombre, correo y contraseña (mínimo 8 caracteres). No necesitas escribir ninguna URL de servidor — ya está integrada. Al confirmar, entras directo a tu biblioteca (todavía vacía hasta que sincronices desde KOReader). Open the app, tap "Register" on the start screen, and fill in name, email and password (minimum 8 characters). No server URL to type — it's already built in. Once confirmed, you land straight in your library (still empty until you sync from KOReader).

Ya tengo cuenta, ¿cómo inicio sesión?I already have an account, how do I sign in? ⌄

En la pantalla de inicio, deja el modo en "Iniciar sesión", escribe el mismo correo y contraseña con los que creaste tu cuenta (los mismos que usas en el plugin de KOReader) y toca el botón verde. Usa exactamente el mismo correo en la app y en el plugin para que ambos vean los mismos libros y estadísticas. On the start screen, leave it in "Sign in" mode, type the same email and password you created your account with (the same ones you use in the KOReader plugin) and tap the green button. Use the exact same email in the app and in the plugin so both see the same books and stats.

¿Qué hace cada sección de Ajustes?What does each section in Settings do? ⌄

Cuenta:Account: cambia tu correo o contraseña.change your email or password.

Meta diaria de lectura:Daily reading goal: los minutos que quieres leer cada día; la pantalla de Estadísticas mostrará tu avance contra esta meta y podrás recibir un aviso si tu racha está en riesgo de romperse.the minutes you want to read each day; the Stats screen shows your progress against this goal, and you can get notified if your streak is at risk of breaking.

KOReader nativo / CrossPoint: activa un usuario y contraseña independientes para que un lector que no puede instalar el plugin (por ejemplo, un Xteink con firmware CrossPoint) pueda sincronizar tu avance de lectura. Ver la siguiente sección para los pasos exactos.turns on a separate username/password so a reader that can't install the plugin (for example, an Xteink running the CrossPoint firmware) can sync your reading progress. See the next section for the exact steps.

Idioma:Language: cambia toda la app entre Español e Inglés.switches the whole app between Spanish and English.

Dispositivos:Devices: la lista de todo lo que ha iniciado sesión en tu cuenta y cuándo se vio por última vez.the list of everything that has ever signed in to your account and when it was last seen.

4. Vincular un lector sin plugin (Xteink/CrossPoint, vía KOSync) 4. Linking a reader with no plugin (Xteink/CrossPoint, via KOSync)

Esto es para lectores que no pueden correr KOReader (por lo tanto tampoco el plugin ArcSync) pero sí traen su propia sincronización de progreso — el caso más común es Xteink, que usa el firmware CrossPoint. Si tu dispositivo sí corre KOReader de verdad, mejor instala el plugin (pasos 1-2): obtienes highlights, notas y estadísticas, no solo el avance. This is for readers that can't run KOReader (so they can't run the ArcSync plugin either) but do ship their own progress sync — the most common case is Xteink, which runs the CrossPoint firmware. If your device does run real KOReader, install the plugin instead (steps 1-2): you get highlights, notes and stats, not just progress.

En la app, ve a Ajustes → "KOReader nativo / CrossPoint" y tócalo para abrirlo.In the app, go to Settings → "Native KOReader / CrossPoint" and tap it to open it.
Escribe un usuario (puede ser lo que quieras, no tiene que ser tu correo) y una contraseña nueva — esta contraseña es solo para este uso, distinta a la de tu cuenta ArcSync.Type a username (anything you like, it doesn't have to be your email) and a new password — this password is only for this purpose, separate from your ArcSync account's password.
Toca "Guardar". El estado cambiará de "Inactivo" a "Activo".Tap "Save". The status changes from "Inactive" to "Active".
En tu lector (por ejemplo, un Xteink con CrossPoint), busca su pantalla de sincronización propia — normalmente menú → "KOReader Sync" o "Progress sync".On your reader (for example, an Xteink running CrossPoint), find its own sync screen — usually menu → "KOReader Sync" or "Progress sync".
Llena esos tres campos exactamente así:Fill in those three fields exactly like this:
- Servidor / Custom server:Server / Custom server: https://arcsync.codigoarcano.com/api/v1/kosync
- Usuario: el que escribiste en el paso 2.Username: the one you typed in step 2.
- Contraseña: la que escribiste en el paso 2.Password: the one you typed in step 2.
Listo — este lector ahora sincroniza tu avance de lectura (página/porcentaje) con la misma cuenta ArcSync. Highlights, notas y estadísticas siguen necesitando el plugin completo (pasos 1-2 más arriba).Done — this reader now syncs your reading progress (page/percentage) with the same ArcSync account. Highlights, notes and stats still need the full plugin (steps 1-2 above).

Tu progreso de lectura, siempre contigo — en todos tus lectores. Your reading progress, always with you — on every device.