Overview

Leelaa Reader is a cross-platform streaming service focused on private audiobooks. Its core goal is to connect your existing audiobook library (e.g., a local directory on your NAS or WebDAV) and allow you to browse, play, collect, and sync progress across all devices.

Advantages

• Data stays yours: audio files remain in your own storage.
• Lightweight self-hosting: SQLite-based deployment and migration.
• Fast onboarding: activate -> login -> add source -> scan -> play.
• Full player experience: speed control, sleep timer, intro/outro skip, chapter switching.
• Automatic organization: online scraping + local metadata extraction.

---

Usage Guide

1. Activation and Login

• First visit redirects to /activate.
• After activation, login at /login.
• Initial admin credentials are printed by server on first startup.

2. Add Storage Source

In /library:

• Support Local, WebDAV, and Netdisk modes.
• Visual flow: verify and choose path from built-in file browser.
• WebDAV URL auto-prefix correction (http://).
• Save and click scan to start indexing.

3. Scan and Auto Organization

• Folders become books; files become chapters.
• Scan can trigger metadata processing automatically.
• Check logs for scan/scrape progress and failures.

4. Book Management

• Edit title, author, narrator, cover, description.
• Delete unnecessary records to keep library clean.

5. User Management

• Admin can create/edit/delete regular users.
• The system does not support multiple administrators; User Management cannot create administrators or promote existing users.
• Regular users need explicit category access before they can see protected content.
• Progress, favorites, and history are isolated per user.

6. AI Categorization

• In Category Management, admins can select a storage source and click Generate Preset Categories.
• The task runs asynchronously; monitor running/completed/failed status in Task Management.
• After refresh, progress/state should be restored from server task status.

---

System Rules

1. Book Recognition

• Recursive directory traversal.
• Audio Support: Officially supports .mp3, .m4a, .m4b, .flac, .wav, and .wma; .wma is played through server-side FFmpeg transcoding. Explicitly does not support .aac (raw streams), .ogg, and .opus.
• Source-path identity is used for uniqueness.

2. Activation and License

• Default 14-day trial.
• Permanent license available for 1.x line.
• License binds to server client_id.
• License Transfer (backup and restore): an administrator can export an encrypted .lltf license backup from the current server and restore it on a new server to request rebinding. This moves license state only; it does not include libraries, audio files, or user data. The backup does not expire automatically based on its export date. The same license can only be restored or rebound once every 7 days, and the activation platform makes the final decision.
• Import & Export: the entry in Profile is currently disabled and cannot be used for library import, export, server migration, or database backup.
• Purchase/support contact:
  WeChat:Yay_ls

3. Data Storage

• SQLite stores metadata, progress, and task state.
• Async task queue handles long-running operations.

4. Category Rules

• Explicit access model for non-admin users.
• Cross-platform ordering uses sort_order first.
• Category changes should propagate to all clients.
• AI categorization status is authoritative on backend tasks; frontend only reflects state.

---

Who It Is For

• NAS/WebDAV audiobook users who want full control.
• Users requiring cross-device progress continuity.
• Teams wanting predictable, portable self-hosted setup.