bookorbit

BookOrbit: Your Reading Space

66 articles 3.4k View on GitHub ↗
66 articles
How BookOrbit Prioritizes Metadata Providers per Library

Discover how BookOrbit prioritizes metadata providers using a three-tier system merging global defaults with library-specific overrides for efficient metadata fetching.

internals
Aug 30, 2026
KOReader Plugin Source Code Location in BookOrbit: Complete Server-Side Module Guide

Find the KOReader plugin source code in the bookorbit/bookorbit repository at server/src/modules/koreader. This NestJS module guides you through its server-side implementation.

api-reference
Aug 30, 2026
BookOrbit Sync Module Structure: Complete Guide to the Kobo Implementation

Explore the BookOrbit sync module structure for Kobo. Discover controllers, services, DTOs, and guards within the Kobo implementation. Understand the full Kobo sync protocol.

internals
Aug 30, 2026
BookOrbit WebSocket Adapter Setup: Location and Configuration in NestJS

Discover the WebSocket adapter setup in BookOrbit's NestJS application. Learn where to locate and configure Socket.IO for real-time communication within the server/src/main.ts file.

how-to-guide
Aug 30, 2026
How SmartScopeService Handles Ownership Checks in BookOrbit

Discover how SmartScopeService handles ownership checks in BookOrbit using assertReadAccess and assertWriteAccess guard methods for secure data operations. Learn more!

deep-dive
Aug 30, 2026
How Rule-Based Filters for Smart Scopes Work in BookOrbit

Discover how BookOrbit Smart Scopes leverage rule-based filters with JSONB and GroupRule objects to dynamically filter book collections using logical AND/OR joins. Learn more!

deep-dive
Aug 30, 2026
How Manual Collections Work in BookOrbit: A Complete Technical Guide

Explore how BookOrbit manages manual collections with a technical guide detailing ownership-based permissions, CRUD, reordering, and bulk management in this NestJS module.

how-to-guide
Aug 30, 2026
How BookOrbit Implements Smart Scopes for Dynamic Collections

Discover how BookOrbit uses Smart Scopes and JSON GroupRule objects in PostgreSQL to create dynamic, self-updating collections, avoiding static book ID lists.

deep-dive
Aug 30, 2026
BOOKS_PATH Environment Variable in BookOrbit: Complete Configuration Guide

Understand the BOOKS_PATH environment variable in BookOrbit. Learn how it defines your e-book library's root directory for seamless file management and synchronization. Get the complete guide.

how-to-guide
Aug 30, 2026
How to Configure Library Settings in BookOrbit: REST API and Validation Guide

Configure BookOrbit library settings using the REST API. Send a PATCH request to update library details, validated by UpdateLibraryDto and persisted with Drizzle ORM.

how-to-guide
Aug 30, 2026
How BookOrbit Implements Library Isolation with Per-Library Folders

Discover how BookOrbit achieves robust library isolation using per-library folders and multi-layer ownership checks. Learn about its secure design for your data.

architecture
Aug 30, 2026
How Are Permissions Enforced in the BookOrbit Backend?

Discover how BookOrbit enforces API permissions using a custom decorator, a global PermissionGuard, and user-scoped ownership checks for secure access to REST endpoints.

internals
Aug 30, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →