概要
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フィットモードを使用しているとき、コミックページの上部までスクロールできないのはなぜですか？
これは BookOrbit 3.1.0 のバグで、横向きモードで「Page Width」フィットモードを使用している場合にモバイルコミックリーダーに影響するものでした。この問題は 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タブが再表示されます。
トラブル対応BookOrbit のオーディオブックの進捗が Web アプリや iOS アプリでリフレッシュ後に再開されない問題は、どうすれば修正できますか？
これは 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経由で2冊目の書籍をインポートした後、BookOrbitの書籍が消え、重複した不明なエントリとして表示される問題を修正する方法
この問題は、ライブラリで Folder as Book をフラットなファイル命名規則と組み合わせて使用している場合に、BookOrbit v3.1.0 で発生します。インポートされた複数の EPUB が同じディレクトリ（ライブラリルートなど）に配置されると、BookOrbit は 2 件目のインポートを 1 冊目の本のデータベースレコードに関連付けてしまいます。その後ライブラリスキャンを実行すると、物理ファイルは分離され、1 冊目の本は復元されますが、2 冊目の本には重複した「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 Web EPUBリーダーはv3.4.0でキーを押すたびに2ページスキップするのですか？
これは v3.4.0 (Docker latest) の既知のバグです: 'Pages' リーディングフローにおいて、ArrowRight キーの1回の keydown (またはクリックによるページ送り) が、ビューポート幅やカラムレイアウトに関係なく、書籍の約0.3%、つまり約2画面ページ分進んでしまいます。回避策: リーダーの 'Reading flow' 設定を 'Pages' から 'Scroll' に切り替えると、正しいナビゲーションが復元されます。このバグは Windows/Chrome 上で EPUB 全般に影響し (Standard Ebooks ビルドで再現確認済み)、キーリピートや2カラム見開きとは無関係です。