개요
BookOrbit는 개인 서재를 정리할 수 있으며, 웹 리더를 통해 전자책, PDF, 만화, 오디오북을 지원하고, 읽기 진행 상황은 Kobo와 KOReader 간에 동기화할 수 있습니다. 메타데이터 향상, OPDS 푸시, 다중 사용자 및 OIDC 로그인을 내장하고 있으며, Docker 배포를 지원합니다.
README 미리보기
\n\n# BookOrbit\n\nA self-hosted library and reading platform for ebooks, PDFs, audiobooks, and comics.\n\n[](https://github.com/bookorbit/bookorbit/releases)\n[](https://github.com/bookorbit/bookorbit/stargazers)\n[](https://github.com/bookorbit/bookorbit/actions/workflows/ci.yml)\n[](https://github.com/bookorbit/bookorbit/actions/workflows/release.yml)\n[](https://codecov.io/gh/bookorbit/bookorbit)\n[](https://crowdin.com/project/bookorbit)\n\n[](https://bookorbit.app)\n[](https://demo.bookorbit.app/magic?token=2d92cb900e184cf0eb8b11f72cffc6011673d1016e1b300d750eb3d76abc1572)\n[](https://github.com/bookorbit/bookorbit/pkgs/container/bookorbit)\n[](https://github.com/bookorbit/bookorbit/blob/main/docs/CONTRIBUTING.md)\n[](LICENSE)\n\n\n\n\n\n---\n\n## What is BookOrbit?\n\n**[BookOrbit](https://bookorbit.app)** organizes your books and reads them back to you anywhere: the web reader, a Kobo, or KOReader. Progress, highlights, and reading status move between all three, so you can start a chapter in one place and finish it in another.\n\nAround that core sit 14 metadata providers, reading statistics and achievements, OPDS and Send-to-Kindle delivery, multi-user accounts with OIDC/SSO, and automatic sync out to Hardcover, Readwise, and StoryGraph. All of it runs on infrastructure you control.\n\n[](https://bookorbit.app)\n\n## Live Demo\n\nTry the live instance before you install. No account required.\n\n[](https://demo.bookorbit.app/magic?token=2d92cb900e184cf0eb8b11f72cffc6011673d1016e1b300d750eb3d76abc1572)\n\n> **Note:** The demo includes a sample library of public domain books. Some administrative features are limited in the public demo. Self-hosting BookOrbit provides the full experience.\n\n## Features\n\n### Reading Experience & Sync\n\n- **Built-in Web Readers**: Ebooks (EPUB, KEPUB, MOBI, AZW3, AZW, FB2), PDFs, comics (CBZ, CBR, CB7), and audiobooks (M4B, MP3, M4A, OPUS, OGG, FLAC), with no extra plugins required.\n- **Three-Way Sync (Kobo + KOReader + BookO
FAQ (5)
문제 해결BookOrbit 모바일 가로 모드에서 Page Width 맞춤 모드를 사용할 때 만화 페이지 맨 위로 스크롤할 수 없는 이유는 무엇인가요?
이것은 가로 모드에서 "Page Width" 맞춤 모드를 사용할 때 모바일 만화 리더에 영향을 주는 BookOrbit 3.1.0의 버그였습니다. 이 문제는 BookOrbit 3.3.0에서 수정되었습니다. Docker 배포를 3.3.0 이상으로 업그레이드한 후 컨테이너를 다시 생성하세요. 임시 해결 방법으로는 세로 방향을 사용하거나 다른 페이지 맞춤 모드를 선택하세요.
문제 해결BookOrbit 플러그인을 설치한 후 KOReader 파일 브라우저 메뉴 표시줄에서 Bookshelf 탭이 사라지는 이유는 무엇인가요?
BookOrbit의 bookorbit_menu_pin.lua는 시작할 때마다 settings/reader_menu_order.lua와 settings/filemanager_menu_order.lua를 KOReader의 내장 메뉴 순서 전체 복사본으로 덮어씁니다. KOReader의 MenuSorter:mergeAndSort는 병합하는 대신 각 목록 전체를 교체하므로, 다른 플러그인이 나중에 추가한 탭(예: bookshelf_tab)이 삭제됩니다. BookOrbit의 메뉴 아이콘을 비활성화하거나 파일을 삭제해도 매번 실행 시 재생성되므로 소용이 없습니다. 해결 방법: 1) 텍스트 편집기에서 koreader/settings/filemanager_menu_order.lua를 엽니다. 2) 첫 번째 줄(-- bookorbit-menu-pin v3 (generated; ...))을 삭제하여 BookOrbit이 파일을 재생성하지 못하게 합니다. 3) ["KOMenu:menu_buttons"] 목록에서 "filemanager_settings" 바로 뒤에 "bookshelf_tab",을 추가합니다. 4) KOReader를 재시작하면 Bookshelf 탭이 다시 나타납니다.
문제 해결새로 고침 후 웹 앱 또는 iOS 앱에서 BookOrbit 오디오북 진행 위치가 이어지지 않는 문제를 어떻게 해결하나요?
이것은 BookOrbit 3.1.0의 버그로, 오디오북 진행 상태는 기록되었지만 플레이어를 다시 열거나 iOS 앱과 동기화할 때 사용되지 않았습니다. 이 문제는 BookOrbit 3.3.0에서 수정되었습니다. Docker 배포를 3.3.0으로 업그레이드하세요. 예: docker compose pull bookorbit && docker compose up -d. 일반 Docker 컨테이너를 사용하는 경우 3.3.0 이미지를 받아오고 컨테이너를 다시 생성하세요. 업그레이드 후 재생을 시작하고 플레이어를 나간 뒤 오디오북을 다시 열어 저장된 위치에서 재생이 이어지는지 확인하세요.
문제 해결Book Dock을 통해 두 번째 책을 가져온 후 BookOrbit 책이 사라지고 중복 누락 항목으로 표시되는 문제를 해결하는 방법은?
이 문제는 BookOrbit v3.1.0에서 라이브러리가 **플랫 파일 명명 규칙**과 함께 **Folder as Book**를 사용할 때 발생합니다. 가져온 여러 EPUB 파일이 라이브러리 루트와 같은 동일한 디렉터리에 저장되면, BookOrbit는 두 번째로 가져온 파일을 첫 번째 책의 데이터베이스 레코드와 연결합니다. 이후 라이브러리 스캔이 수행되면 물리적 파일이 분리되고 첫 번째 책은 복원되지만, 두 번째 책에 대해 중복된 "missing" 항목이 남습니다. 스캔이 원본 파일로부터 메타데이터를 새로 고치기 때문에 메타데이터 편집 내용도 손실될 수 있습니다.
해결 방법:
1. **Settings > Library**로 이동하여 각 책이 고유한 하위 디렉터리를 갖도록 Folder-as-Book 명명 규칙을 편집합니다. 다음과 같이 경로 구분자를 추가하세요:
{title}/<{title}|{originalFilename}> - <{authors:first}> - <{year}>
2. 이미 라이브러리 루트로 가져온 책의 경우, 각 책 파일을 자체 폴더로 이동합니다.
3. **Settings > Library > Scan**을 실행합니다.
4. 유령 "missing" 중복 항목을 삭제하고 손실된 메타데이터 변경 사항을 다시 적용합니다.
또는 책을 플랫 디렉터리에 그대로 두려면 라이브러리를 Folder as Book 대신 **File as Book**로 구성하세요.
문제 해결BookOrbit 웹 EPUB 리더가 v3.4.0에서 키를 한 번 누를 때마다 두 페이지씩 건너뛰는 이유는 무엇인가요?
이것은 v3.4.0 (Docker latest)의 알려진 버그입니다: 'Pages' 읽기 흐름에서 ArrowRight 키 입력(또는 클릭하여 페이지 넘기기) 한 번에 뷰포트 너비나 컬럼 레이아웃에 관계없이 책의 약 0.3%, 즉 화면 기준 약 두 페이지가 넘어갑니다. 우회 방법: 리더의 'Reading flow' 설정을 'Pages'에서 'Scroll'로 변경하면 정상적인 이동이 복원됩니다. 이 버그는 Windows/Chrome에서 EPUB 전반에 영향을 미치며(Standard Ebooks 빌드로 재현 확인됨), 키 반복이나 2단 펼침과는 무관합니다.