How legadoteam/legado works
Legado is an Android ebook reader whose main journey is selecting a configured book source, discovering and fetching a book and chapters, then reading and optionally listening or exporting content. Its broader documented domain includes local books and multiple importable reading formats, RSS, reviews, source management, and a local web/API surface. The tree and excerpts show models, source scripting, content processing, persistence, and audio/export services; many UI and domain implementations are unsampled, so uncertain links are omitted rather than inferred.
Main entry points: ReadBook.kt Reading workflow · SearchActivity.kt Book search · BookHelp.kt Book operations · AppDatabase.kt Book database
Components 26
Sources and discovery
- Source definitions
app/src/main/java/io/legado/app/data/entities/BookSource.kt - Source navigation
app/src/main/java/io/legado/app/help/source/SourceNavigationBridge.kt - Book search
app/src/main/java/io/legado/app/ui/book/search/SearchActivity.kt - Reader API
app/src/main/java/io/legado/app/api/ReaderProvider.kt - Source scripting
app/src/main/java/io/legado/app/model/jsSource/JsSourceEngine.kt - RSS reading
app/src/main/java/io/legado/app/data/entities/RssSource.kt - Book reviews
app/src/main/java/io/legado/app/api/controller/ReviewController.kt
Books and reading
- Book model
app/src/main/java/io/legado/app/data/entities/Book.kt - Chapter model
app/src/main/java/io/legado/app/data/entities/BookChapter.kt - Book operations
app/src/main/java/io/legado/app/help/book/BookHelp.kt - Content processing
app/src/main/java/io/legado/app/help/book/ContentProcessor.kt - Reading workflow
app/src/main/java/io/legado/app/model/ReadBook.kt - Book database
app/src/main/java/io/legado/app/data/AppDatabase.kt - Local book formats
modules/book/src/main/java/me/ag2s/epublib/epub/BookProcessorPipeline.java
Media and export
- Read aloud
app/src/main/java/io/legado/app/service/BaseReadAloudService.kt - Audio playback
app/src/main/java/io/legado/app/service/AudioPlayService.kt - Audio cache
app/src/main/java/io/legado/app/help/audio/AudioCacheManager.kt - Book export
app/src/main/java/io/legado/app/service/ExportBookService.kt
App platform
- Android app
app/src/main/java/io/legado/app/App.kt - HTTP client
app/src/main/java/io/legado/app/help/http/HttpHelper.kt - Backup and restore
app/src/main/java/io/legado/app/help/storage/Backup.kt - WebDAV sync
app/src/main/java/io/legado/app/help/AppWebDav.kt - Reader settings
app/src/main/java/io/legado/app/help/config/AppConfig.kt
Other components
- Reader user
- Book source service
- Speech engine
Connections 25
- Reader user → Android app: uses
README.md - Android app → Book search: opens
- Book search → Source definitions: selects
- Book search → Source navigation: navigates
- Source navigation → Book source service: requests
- Reader API → Book source service: serves access
- Source definitions → Source scripting: provides rules
app/src/main/java/io/legado/app/model/jsSource/JsSourceEngine.kt - Source scripting → HTTP client: uses requests
app/src/main/java/io/legado/app/model/jsSource/JsSourceEngine.kt - Book search → Book model: produces books
- Book operations → Chapter model: loads chapters
- Book operations → Book database: reads and writes
- Reading workflow → Book operations: loads content
app/src/main/java/io/legado/app/model/ReadBook.kt - Reading workflow → Content processing: processes text
app/src/main/java/io/legado/app/model/ReadBook.kt - Reading workflow → Book model: uses book state
app/src/main/java/io/legado/app/data/entities/Book.kt - Reading workflow → Chapter model: uses chapters
app/src/main/java/io/legado/app/data/entities/BookChapter.kt - Local book formats → Reading workflow: provides content
- RSS reading → Book database: persists articles
- Book reviews → Book source service: fetches reviews
- Reading workflow → Read aloud: supplies speech text
app/src/main/java/io/legado/app/model/ReadBook.kt - Read aloud → Speech engine: requests speech
- Audio playback → Audio cache: uses cache
app/src/main/java/io/legado/app/help/audio/AudioCacheManager.kt - Reading workflow → Book export: exports book
app/src/main/java/io/legado/app/service/ExportBookService.kt - Backup and restore → Book database: backs up data
- Backup and restore → WebDAV sync: transfers backup
- Reading workflow → Reader settings: reads preferences
app/src/main/java/io/legado/app/model/ReadBook.kt