Library Sources
Libraries are the data sources of Leelaa Reader. You can import audiobooks from local paths, WebDAV services, or netdisk bridges.
Storage Modes
1. Local Mode
- Use case: physical host or Docker volume-mounted directories.
- Pros: fastest scan, no network overhead, highest stability.
- Setup: name + absolute local path.
2. WebDAV Mode
- Use case: built-in or native WebDAV services such as NAS systems, Nextcloud, Jianguoyun, or self-hosted servers.
- Protocol: standard WebDAV.
- Setup flow:
- Fill URL, username, password.
- Browse remote directories and choose audiobook root path.
3. Netdisk Mode
- Use case: public cloud drives exposed through third-party WebDAV bridges.
- Optimization: avoids proactive duration scraping and reduces sensitive high-frequency file probes to lower risk-control triggers.
- Setup flow: same as WebDAV with visual path selection.
4. RSS / Atom Audio Feed
- Use case: podcasts, serialized audiobooks, and other remote audio subscriptions.
- Supported feeds: RSS 2.0, iTunes Podcast, Media RSS, common Podcast 2.0 metadata, and Atom enclosures.
- Setup: feed name + HTTP/HTTPS subscription URL. See RSS and Atom audio feeds for sync, token, and troubleshooting details.
Core Functions
1. Visual Add Flow
- Two-step flow: verify connection, then select directory in built-in browser.
- WebDAV URL auto-completes missing
http://prefix.
2. Scan and Sync
- Auto parse folders into books and files into chapters.
- Auto extract local cover images (for example
cover.jpg). - Incremental rescan imports only new books/chapters.
3. Maintenance
- Cleanup invalid records when remote files are removed.
- Safety rule: Leelaa Reader never deletes your NAS/WebDAV source files.
Recommendations
- Mount specific audiobook subdirectories instead of disk root.
- For netdisk-based sources, use Netdisk Mode.
- Prefer built-in NAS WebDAV or native WebDAV providers for better reliability. Third-party bridges are better treated as transitional options.