# mentalinc/my-episodes-watch-manager architecture

> Architecture diagram of the GitHub repository mentalinc/my-episodes-watch-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mentalinc/my-episodes-watch-manager
- Repository: https://github.com/mentalinc/my-episodes-watch-manager

## Overview

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: [`app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java`](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java) (Episode feeds), [`app/src/main/java/nz/mentalinc/watcher/service/ShowService.java`](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/ShowService.java) (Show service), [`app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java`](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java) (Home), [`app/src/main/java/nz/mentalinc/watcher/service/UserService.java`](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/UserService.java) (Account service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_screens["App screens"]
  node_home["Home<br/>[HomeActivity.java]"]
  node_episode_lists["Episode lists"]
  node_episode_details["Episode details"]
  node_show_summary["Show landing"]
  node_calendar["Episode calendar"]
  node_random_picker["Random picker"]
  node_show_management["Show management"]
end

subgraph group_episodes["Episode tracking"]
  node_episode_controller["Episode grouping"]
  node_episode_service["Episode feeds"]
  node_feed_parser["RSS parsing"]
  node_episode_model["Episode model<br/>[Episode.java]"]
end

subgraph group_services["Account and shows"]
  node_user_service["Account service<br/>[UserService.java]"]
  node_show_service["Show service<br/>[ShowService.java]"]
end

subgraph group_infra["Data and networking"]
  node_http_client["HTTP client"]
  node_database[("Local runtime store<br/>[AppDatabase.java]")]
end

node_viewer(("User"))
node_myepisodes{{"MyEpisodes.com"}}
node_tvmaze{{"TVMaze API"}}

node_viewer -->|"opens app"| node_home
node_home -->|"loads feeds"| node_episode_service
node_home -.->|"authenticates"| node_user_service
node_episode_service -->|"requests feeds"| node_http_client
node_episode_service -.->|"parses RSS"| node_feed_parser
node_episode_service -->|"reads cache"| node_database
node_episode_service -->|"builds episodes"| node_episode_model
node_episode_service -->|"fetches lists"| node_myepisodes
node_episode_lists -->|"groups episodes"| node_episode_controller
node_episode_controller -->|"groups by show"| node_episode_model
node_episode_details -.->|"loads metadata"| node_tvmaze
node_show_summary -.->|"shows metadata"| node_tvmaze
node_show_management -.->|"manages shows"| node_show_service
node_show_service -->|"sends requests"| node_http_client
node_show_service -->|"reads runtimes"| node_database
node_show_service -->|"updates account"| node_myepisodes
node_user_service -->|"posts credentials"| node_http_client
node_user_service -->|"logs in"| node_myepisodes
node_viewer -->|"views schedule"| node_calendar
node_viewer -->|"requests pick"| node_random_picker

click node_home "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java"
click node_episode_lists "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/EpisodeListingActivity.java"
click node_episode_details "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/EpisodeDetailsActivity.java"
click node_show_summary "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/ShowSummaryActivity.java"
click node_calendar "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/CalendarActivity.java"
click node_random_picker "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/RandomEpPickerActivity.java"
click node_show_management "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/ShowManagementActivity.java"
click node_episode_controller "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/controllers/EpisodesController.java"
click node_episode_service "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java"
click node_feed_parser "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/SaxRssFeedParser.java"
click node_episode_model "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/domain/Episode.java"
click node_user_service "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/UserService.java"
click node_show_service "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/ShowService.java"
click node_http_client "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/http/HttpClientProvider.java"
click node_database "https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/database/AppDatabase.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_episode_lists,node_episode_details,node_show_summary,node_calendar,node_random_picker,node_show_management,node_viewer toneBlue
class node_episode_controller,node_episode_service,node_feed_parser,node_episode_model toneAmber
class node_user_service,node_show_service,node_tvmaze toneMint
class node_http_client,node_database toneRose
class node_myepisodes toneIndigo
```

## Components

### App screens

- [Home](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java): `app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java`
- [Episode lists](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/EpisodeListingActivity.java): `app/src/main/java/nz/mentalinc/watcher/activities/EpisodeListingActivity.java`
- [Episode details](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/EpisodeDetailsActivity.java): `app/src/main/java/nz/mentalinc/watcher/activities/EpisodeDetailsActivity.java`
- [Show landing](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/ShowSummaryActivity.java): `app/src/main/java/nz/mentalinc/watcher/activities/ShowSummaryActivity.java`
- [Episode calendar](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/CalendarActivity.java): `app/src/main/java/nz/mentalinc/watcher/activities/CalendarActivity.java`
- [Random picker](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/RandomEpPickerActivity.java): `app/src/main/java/nz/mentalinc/watcher/activities/RandomEpPickerActivity.java`
- [Show management](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/activities/ShowManagementActivity.java): `app/src/main/java/nz/mentalinc/watcher/activities/ShowManagementActivity.java`

### Episode tracking

- [Episode grouping](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/controllers/EpisodesController.java): `app/src/main/java/nz/mentalinc/watcher/controllers/EpisodesController.java`
- [Episode feeds](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java): `app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java`
- [RSS parsing](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/SaxRssFeedParser.java): `app/src/main/java/nz/mentalinc/watcher/service/SaxRssFeedParser.java`
- [Episode model](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/domain/Episode.java): `app/src/main/java/nz/mentalinc/watcher/domain/Episode.java`

### Account and shows

- [Account service](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/UserService.java): `app/src/main/java/nz/mentalinc/watcher/service/UserService.java`
- [Show service](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/service/ShowService.java): `app/src/main/java/nz/mentalinc/watcher/service/ShowService.java`

### Data and networking

- [HTTP client](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/http/HttpClientProvider.java): `app/src/main/java/nz/mentalinc/watcher/http/HttpClientProvider.java`
- [Local runtime store](https://github.com/mentalinc/my-episodes-watch-manager/blob/main/app/src/main/java/nz/mentalinc/watcher/database/AppDatabase.java): `app/src/main/java/nz/mentalinc/watcher/database/AppDatabase.java`

### Other components

- **User**
- **MyEpisodes.com**
- **TVMaze API**

## Connections

- User → Home: opens app
- Home → Episode feeds: loads feeds (evidence: `app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java`)
- Home → Account service: authenticates (evidence: `app/src/main/java/nz/mentalinc/watcher/activities/HomeActivity.java`)
- Episode feeds → HTTP client: requests feeds (evidence: `app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java`)
- Episode feeds → RSS parsing: parses RSS (evidence: `app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java`)
- Episode feeds → Local runtime store: reads cache (evidence: `app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java`)
- Episode feeds → Episode model: builds episodes (evidence: `app/src/main/java/nz/mentalinc/watcher/service/EpisodesService.java`)
- Episode feeds → MyEpisodes.com: fetches lists
- Episode lists → Episode grouping: groups episodes (evidence: `app/src/main/java/nz/mentalinc/watcher/activities/EpisodeListingActivity.java`)
- Episode grouping → Episode model: groups by show (evidence: `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 (evidence: `app/src/main/java/nz/mentalinc/watcher/service/ShowService.java`)
- Show service → Local runtime store: reads runtimes (evidence: `app/src/main/java/nz/mentalinc/watcher/service/ShowService.java`)
- Show service → MyEpisodes.com: updates account
- Account service → HTTP client: posts credentials (evidence: `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
