IndigolibraКнижный интернет-магазин

Как установить KOReader и подключить синхронизацию

Инструкция для ридеров на Linux (Kobo, PocketBook, Cervantes, tolino) и Android-устройств. Синхронизация работает только с прогрессом и метаданными — файлы книг не загружаются.

1. Включите синхронизацию в личном кабинете

  1. Войдите в аккаунт и откройте «Синхронизация».
  2. Нажмите «Подключить ридер» — появятся логин, пароль и адрес сервера.
  3. Сохраните эти данные: пароль показывается один раз.

2. Скачайте KOReader

Официальные сборки: github.com/koreader/koreader/releases. Выберите файл под ваше устройство (см. ниже).

3. Установка по устройствам

Kobo (Touch, Glo, Clara, Libra, Sage, Elipsa и др.)

  1. Подключите Kobo по USB, откройте диск устройства.
  2. Скачайте пакет KFMon + KOReader (первый пост на странице релиза) и распакуйте в корень диска (не в подпапку).
  3. Скачайте koreader-kobo-*.zip и распакуйте папку koreader в .adds на устройстве.
  4. В файле .kobo/Kobo/Kobo eReader.conf добавьте (если нет) в [FeatureSettings]:
    ExcludeSyncFolders=(\.(?!kobo|adobe).+|([^.][^/]*/)+\..+)
  5. Безопасно извлеките устройство. Kobo перезагрузится и появится иконка KOReader.

Подробнее: wiki Kobo.

PocketBook (Era, Touch, Lux, Verse и др.)

  1. Скачайте пакет koreader-pocketbook-*.zip с релиза.
  2. Распакуйте на компьютере — появятся папки applications и system.
  3. Подключите ридер по USB и скопируйте/объедините обе папки в корень диска устройства.
  4. Безопасно извлеките. На главном экране: Apps → USER'S → @koreader.

Подробнее: wiki PocketBook.

Android (смартфоны и e-ink: Onyx Boox, Likebook, Bigme)

  1. В настройках Android включите «Установка из неизвестных источников».
  2. Скачайте APK koreader-android-arm-*.apk (для большинства — ARM; x86 для эмуляторов).
  3. Откройте APK на устройстве или установите через adb install koreader-*.apk.
  4. KOReader появится в списке приложений.

Подробнее: wiki Android.

Kindle (только с джейлбрейком)

Требуется джейлбрейк устройства. После этого установите KOReader по инструкции для Kindle. Синхронизация настраивается так же.

Подробнее: wiki Kindle.

reMarkable / Cervantes / tolino / Linux-десктоп

Используйте соответствующую сборку (koreader-remarkable-*, koreader-cervantes-*, koreader-linux-*). Инструкции — на wiki KOReader для каждой платформы.

4. Настройте синхронизацию прогресса в KOReader

  1. Откройте любую книгу в KOReader и нажмите иконку гаечного ключа (настройки) в верхнем меню.
  2. Выберите «Progress sync» (Синхронизация прогресса).
  3. Нажмите «Свой сервер синхронизации» (Custom sync server) и введите адрес из личного кабинета: https://indigolibra.ru/koreader. Это единственный адрес, который нужно указывать.
  4. Поле «Имя хоста устройства» (Device Hostname) — не адрес, а необязательная подпись устройства. Его можно оставить пустым: KOReader подставит модель устройства.
  5. Нажмите «Зарегистрироваться / Войти» (Register / Log in) и введите логин и пароль из личного кабинета. Это не создание нового аккаунта, а привязка к уже выданным данным — придуманный логин/пароль не подойдут.
  6. Включите «Автоматическая синхронизация документов».
  7. Включите «Отправить метаданные документа» — обязательно, иначе синх не пройдёт: без названия и автора трекер не сможет сопоставить книгу (сервер вернёт ошибку, см. «Последние синхронизации»).
  8. При желании включите автосинх при открытии/закрытии книги.

5. Метод сопоставления документов

Чтобы прогресс попал в правильную книгу, KOReader должен понять, что на устройствах открыта одна и та же книга. В «Progress sync» есть пункт «Метод сопоставления документов» (Document matching method):

  • По содержимому файла (Binary) — рекомендуется. Книги сверяются по хэш-сумме. Файлы на ридере и телефоне должны быть идентичными копиями из одного источника. Если та же книга скачана с другого сайта, хэш будет другим и прогресс не свяжется.
  • По метаданным (Metadata) — гибче: сопоставление по названию и автору, подходит, если файлы немного отличаются. Может дать сбой при кривых метаданных.

Наш сервер работает в обоих случаях: сначала ищет книгу по хэшу файла, а если хэша нет — по названию и автору. Для второго варианта обязательно включайте «Отправить метаданные документа».

6. Проверьте

Откройте книгу на ридере, прочитайте несколько страниц и закройте. В личном кабинете в разделе «Книжный трекер» книга появится автоматически со статусом «Читаю» и прогрессом.

KOReader распространяется под лицензией AGPL-3.0. Мы не распространяем его и не храним ваши файлы книг — синхронизируется только прогресс и метаданные (название, автор).