How mentalinc/my-episodes-watch-manager works
MyEpisodes Manager is a native Android TV-watchlist client. Users log in, load Watch/Acquire/Coming episodes, browse and update episode or show status, and keep changes synchronized with MyEpisodes.com; cached data and TVMaze metadata support the experience. The graph separates app screens, episode handling, account/show services, and persistence/networking. Some branches (calendar, random picker, and management screens) are included from README capabilities, but their internal calls are not established by the sampled excerpts, so those links are omitted.
Main entry points: EpisodesService.java Episode feeds · ShowService.java Show service · HomeActivity.java Home · UserService.java Account service
Components 18
App screens
- Home
app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java - Episode lists
app/src/main/java/nz/mentalinc/watcher/activities/EpisodeListingActivity.java - Episode details
app/src/main/java/nz/mentalinc/watcher/activities/EpisodeDetailsActivity.java - Show landing
app/src/main/java/nz/mentalinc/watcher/activities/ShowSummaryActivity.java - Episode calendar
app/src/main/java/nz/mentalinc/watcher/activities/CalendarActivity.java - Random picker
app/src/main/java/nz/mentalinc/watcher/activities/RandomEpPickerActivity.java - Show management
app/src/main/java/nz/mentalinc/watcher/activities/ShowManagementActivity.java
Episode tracking
- Episode grouping
app/src/main/java/nz/mentalinc/watcher/controllers/EpisodesController.java - Episode feeds
app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java - RSS parsing
app/src/main/java/nz/mentalinc/watcher/service/SaxRssFeedParser.java - Episode model
app/src/main/java/nz/mentalinc/watcher/domain/Episode.java
Account and shows
- Account service
app/src/main/java/nz/mentalinc/watcher/service/UserService.java - Show service
app/src/main/java/nz/mentalinc/watcher/service/ShowService.java
Data and networking
- HTTP client
app/src/main/java/nz/mentalinc/watcher/http/HttpClientProvider.java - Local runtime store
app/src/main/java/nz/mentalinc/watcher/database/AppDatabase.java
Other components
- User
- MyEpisodes.com
- TVMaze API
Connections 20
- User → Home: opens app
- Home → Episode feeds: loads feeds
app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java - Home → Account service: authenticates
app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java - Episode feeds → HTTP client: requests feeds
app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java - Episode feeds → RSS parsing: parses RSS
app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java - Episode feeds → Local runtime store: reads cache
app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java - Episode feeds → Episode model: builds episodes
app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java - Episode feeds → MyEpisodes.com: fetches lists
- Episode lists → Episode grouping: groups episodes
app/src/main/java/nz/mentalinc/watcher/activities/EpisodeListingActivity.java - Episode grouping → Episode model: groups by show
app/src/main/java/nz/mentalinc/watcher/controllers/EpisodesController.java - Episode details → TVMaze API: loads metadata
- Show landing → TVMaze API: shows metadata
- Show management → Show service: manages shows
- Show service → HTTP client: sends requests
app/src/main/java/nz/mentalinc/watcher/service/ShowService.java - Show service → Local runtime store: reads runtimes
app/src/main/java/nz/mentalinc/watcher/service/ShowService.java - Show service → MyEpisodes.com: updates account
- Account service → HTTP client: posts credentials
app/src/main/java/nz/mentalinc/watcher/service/UserService.java - Account service → MyEpisodes.com: logs in
- User → Episode calendar: views schedule
- User → Random picker: requests pick