AI news and explainers at 7 AM weekdays, plus a Sunday weekly at 8Get it in your inbox

METAL LAB

bookorbit/bookorbit

3,211+869 this weekTypeScript

A self-hosted book server that syncs your reading progress across web, Kobo, and KOReader

BookOrbit is a self-hosted platform for organizing and reading ebooks, PDFs, audiobooks, and comics. It syncs reading progress and highlights bidirectionally between its web reader, Kobo e-readers, and KOReader devices, and pulls metadata from 14 providers. It also pushes reading data to Hardcover, Readwise, and StoryGraph, and runs entirely on infrastructure the user controls.

What it does

  1. Built-in web readers cover ebook formats (EPUB, KEPUB, MOBI, AZW3, AZW, FB2), PDFs, comics (CBZ, CBR, CB7), and audiobooks (M4B, MP3, M4A, OPUS, OGG, FLAC) without extra plugins.
  2. Three-way sync between Kobo devices, KOReader, and the BookOrbit web reader moves progress, highlights, and deletions bidirectionally so reading can continue seamlessly across devices.
  3. A KOReader plugin adds an on-device catalog browser for searching and downloading books plus full progress and annotation sync.
  4. Metadata is aggregated from 14 providers including Google Books, Open Library, Amazon, Goodreads, and Hardcover, with separate cover art sourcing and support for multi-user accounts with OIDC/SSO.
  5. Deployment is via Docker Compose with environment variables for database password, JWT secret, and a setup bootstrap token; it is licensed under AGPL v3.

Why it matters

For readers who want to own their reading data instead of relying on closed platforms, this offers a self-hosted alternative that still syncs across popular hardware and software readers. Developers get an open, TypeScript-based codebase with CI, test coverage tracking, and a documented contribution workflow.

Terms in this repo

  • OPDS · 전자책을 다른 리더 앱에서 목록으로 불러올 수 있게 해주는 개방형 배포 표준
  • OIDC/SSO · 하나의 계정으로 여러 서비스에 로그인할 수 있게 하는 인증 방식
  • KOReader · 전자책 리더 기기용 오픈소스 리딩 소프트웨어
  • Kobo · 캐나다 전자책 리더 제조사이자 그 전용 단말기
  • Docker Compose · 여러 컨테이너를 한 번에 실행·관리하는 설정 도구

Repository description (English)

BookOrbit: Your Reading Space

Open on GitHub

Trending repos

All repos →

Latest from METAL LAB