How nokkum/ranobe works
Ranobe is an extensible Android light-novel reader. Readers browse multilingual sources or search by keyword, open novel details and chapter lists, then read chapters with configurable presentation; library, offline downloads, and reading history support return visits. Source adapters and a repository mediate catalog and chapter requests, while Room stores library and reading state. The README documents capabilities beyond the sampled implementation. Some UI, persistence, and background-worker wiring is unsampled, so those connections are omitted rather than inferred.
Main entry points: ReaderActivity.java Reader view · RanobeDatabase.java Room database · Repository.java Source repository · Browse.java Browse
Components 24
Discovery
- Browse
app/src/main/java/org/ranobe/ranobe/ui/browse/Browse.java - Keyword search
app/src/main/java/org/ranobe/ranobe/ui/search/Search.java - Search filters
app/src/main/java/org/ranobe/ranobe/util/SearchFilters.java - Source selection
app/src/main/java/org/ranobe/ranobe/ui/explore/Explore.java
Sources and retrieval
- Source repository
app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java - Source registry
app/src/main/java/org/ranobe/ranobe/sources/SourceManager.java - Source contract
app/src/main/java/org/ranobe/ranobe/sources/Source.java - Source adapters
app/src/main/java/org/ranobe/ranobe/sources - WTR-LAB adapter
app/src/main/java/org/ranobe/ranobe/sources/en/WtrLab.java - HTTP client
app/src/main/java/org/ranobe/ranobe/network/HttpClient.java
Reading
- Novel details
app/src/main/java/org/ranobe/ranobe/ui/details/Details.java - Chapter list
app/src/main/java/org/ranobe/ranobe/ui/chapters/Chapters.java - Reader view
app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java - Reader pages
app/src/main/java/org/ranobe/ranobe/ui/reader/adapter/PageAdapter.java - Reader customization
app/src/main/java/org/ranobe/ranobe/ui/reader/sheet/CustomizeReader.java
Library and state
- Offline downloads
app/src/main/java/org/ranobe/ranobe/service/DownloadService.java - Library
app/src/main/java/org/ranobe/ranobe/ui/library/Library.java - Reading history
app/src/main/java/org/ranobe/ranobe/ui/history/History.java - Room database
app/src/main/java/org/ranobe/ranobe/database/RanobeDatabase.java
Settings and updates
- App startup
app/src/main/java/org/ranobe/ranobe/App.java - Preferences
app/src/main/java/org/ranobe/ranobe/config/Ranobe.java - Chapter updates
app/src/main/java/org/ranobe/ranobe/worker/ChapterUpdateWorker.java
Other components
- Reader
- Novel websites
Connections 23
- Reader → Browse: browses
README.md - Reader → Keyword search: searches
README.md - Reader → Source selection: selects sources
README.md - Browse → Novel details: opens novels
README.md - Keyword search → Search filters: uses filters
app/src/main/java/org/ranobe/ranobe/ui/search/Search.java - Novel details → Chapter list: views chapters
README.md - Chapter list → Reader view: opens chapter
README.md - Reader view → Reader pages: renders pages
app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java - Reader view → Reader customization: opens settings
app/src/main/java/org/ranobe/ranobe/ui/reader/ReaderActivity.java - Source registry → Source adapters: registers sources
app/src/main/java/org/ranobe/ranobe/sources/SourceManager.java - Source adapters → Source contract: implement contract
app/src/main/java/org/ranobe/ranobe/sources/Source.java - Source repository → Source registry: selects source
app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java - Source repository → Source contract: requests catalog
app/src/main/java/org/ranobe/ranobe/network/repository/Repository.java - WTR-LAB adapter → HTTP client: sends requests
app/src/main/java/org/ranobe/ranobe/sources/en/WtrLab.java - HTTP client → Novel websites: fetches content
- Reader → Library: saves novels
README.md - Reader → Offline downloads: downloads chapters
README.md - Reader → Reading history: tracks reading
README.md - Library → Room database: persists library
README.md - Reading history → Room database: persists history
README.md - Offline downloads → Room database: stores chapters
app/src/main/java/org/ranobe/ranobe/service/DownloadService.java - Reader → Preferences: customizes reading
README.md - App startup → Chapter updates: schedules checks
app/src/main/java/org/ranobe/ranobe/App.java