# bgmi/bgmi-android architecture

> Architecture diagram of the GitHub repository bgmi/bgmi-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bgmi/bgmi-android
- Repository: https://github.com/bgmi/bgmi-android

## Overview

BGmi Android is a client for browsing and following anime (“bangumi”) served by a configured BGmi backend. Users configure the backend, load current or older series, open episode links, and browse a calendar to subscribe or unsubscribe. Lists and settings are cached in Android preferences; calendar data is fetched on demand. The graph includes the documented navigation and the sampled network, rendering, and image-loading layers. Some adapters and settings behavior are unsampled; their links are included only where the source index or excerpts show them.

Main entry points: [`app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/MainActivity.java) (Main activity), [`app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java`](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java) (Backend client), [`app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java`](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java) (Current series), [`app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java`](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java) (Series cards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_main["Main activity<br/>[MainActivity.java]"]
  node_settings["Settings"]
  node_about["About screen<br/>[AboutFragment.java]"]
end

subgraph group_bangumi["Series browsing"]
  node_current["Current series"]
  node_older["Older series"]
  node_bangumi_adapter["Series adapter"]
  node_bangumi_holder["Series cards"]
  node_bangumi_model["Series model<br/>[Bangumi.java]"]
end

subgraph group_calendar["Calendar and subscriptions"]
  node_calendar["Calendar screen"]
  node_calendar_adapter["Calendar adapter"]
  node_calendar_holder["Calendar holders"]
  node_calendar_item_adapter["Calendar item adapter"]
  node_calendar_item_holder["Subscription control"]
end

subgraph group_services["Client services"]
  node_manager["Backend client<br/>[BGmiManager.java]"]
  node_properties["Client properties"]
  node_callback["Callback contract<br/>[CallBack.java]"]
  node_image_worker["Image cache<br/>[ImageWorker.java]"]
  node_remote_image["Remote image fetch<br/>[RemoteImage.java]"]
end

node_user(("User"))
node_episode_browser(("Episode browser"))
node_backend["BGmi backend"]
node_preferences[("Android preferences")]

node_user -->|"opens"| node_main
node_main -->|"shows"| node_settings
node_main -->|"shows"| node_current
node_main -->|"shows"| node_older
node_main -->|"shows"| node_calendar
node_main -->|"shows"| node_about
node_main -->|"reads"| node_preferences
node_main -->|"sets"| node_properties
node_settings -->|"configures"| node_properties
node_current -->|"reads/writes"| node_preferences
node_current -->|"loads"| node_manager
node_current -->|"renders with"| node_bangumi_adapter
node_older -->|"loads"| node_manager
node_older -->|"renders with"| node_bangumi_adapter
node_bangumi_adapter -->|"binds"| node_bangumi_holder
node_bangumi_holder -->|"displays"| node_bangumi_model
node_bangumi_holder -->|"loads cover"| node_image_worker
node_bangumi_holder -->|"opens link"| node_episode_browser
node_calendar -->|"loads calendar"| node_manager
node_calendar -->|"renders with"| node_calendar_adapter
node_calendar_adapter -->|"binds"| node_calendar_holder
node_calendar_holder -->|"renders with"| node_calendar_item_adapter
node_calendar_item_adapter -->|"binds"| node_calendar_item_holder
node_calendar_item_holder -->|"subscribes via"| node_manager
node_manager -->|"requests data"| node_backend
node_manager -->|"reports results"| node_callback
node_manager -->|"reads endpoints"| node_properties
node_image_worker -->|"dispatches fetch"| node_remote_image

click node_main "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/MainActivity.java"
click node_settings "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/SettingsFragment.java"
click node_about "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/AboutFragment.java"
click node_current "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java"
click node_older "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/OldBangumiListFragment.java"
click node_bangumi_adapter "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/adapters/BangumiAdapter.java"
click node_bangumi_holder "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java"
click node_bangumi_model "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/models/Bangumi.java"
click node_calendar "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/CalendarFragment.java"
click node_calendar_adapter "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarAdapter.java"
click node_calendar_holder "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/holders/CalendarViewHolder.java"
click node_calendar_item_adapter "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarItemAdapter.java"
click node_calendar_item_holder "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/holders/CalendarItemViewHolder.java"
click node_manager "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java"
click node_properties "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/BGmiProperties.java"
click node_callback "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/CallBack.java"
click node_image_worker "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/ImageWorker.java"
click node_remote_image "https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/RemoteImage.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_main,node_settings,node_about,node_user,node_episode_browser toneBlue
class node_current,node_older,node_bangumi_adapter,node_bangumi_holder,node_bangumi_model,node_preferences toneAmber
class node_calendar,node_calendar_adapter,node_calendar_holder,node_calendar_item_adapter,node_calendar_item_holder toneMint
class node_manager,node_properties,node_callback,node_image_worker,node_remote_image toneRose
class node_backend toneIndigo
```

## Components

### App navigation

- [Main activity](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/MainActivity.java): `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`
- [Settings](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/SettingsFragment.java): `app/src/main/java/bgmi/app/bgmi_android/SettingsFragment.java`
- [About screen](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/AboutFragment.java): `app/src/main/java/bgmi/app/bgmi_android/AboutFragment.java`

### Series browsing

- [Current series](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java): `app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java`
- [Older series](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/OldBangumiListFragment.java): `app/src/main/java/bgmi/app/bgmi_android/OldBangumiListFragment.java`
- [Series adapter](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/adapters/BangumiAdapter.java): `app/src/main/java/bgmi/app/bgmi_android/adapters/BangumiAdapter.java`
- [Series cards](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java): `app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java`
- [Series model](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/models/Bangumi.java): `app/src/main/java/bgmi/app/bgmi_android/models/Bangumi.java`

### Calendar and subscriptions

- [Calendar screen](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/CalendarFragment.java): `app/src/main/java/bgmi/app/bgmi_android/CalendarFragment.java`
- [Calendar adapter](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarAdapter.java): `app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarAdapter.java`
- [Calendar holders](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/holders/CalendarViewHolder.java): `app/src/main/java/bgmi/app/bgmi_android/holders/CalendarViewHolder.java`
- [Calendar item adapter](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarItemAdapter.java): `app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarItemAdapter.java`
- [Subscription control](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/holders/CalendarItemViewHolder.java): `app/src/main/java/bgmi/app/bgmi_android/holders/CalendarItemViewHolder.java`

### Client services

- [Backend client](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java): `app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java`
- [Client properties](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/BGmiProperties.java): `app/src/main/java/bgmi/app/bgmi_android/utils/BGmiProperties.java`
- [Callback contract](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/CallBack.java): `app/src/main/java/bgmi/app/bgmi_android/utils/CallBack.java`
- [Image cache](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/ImageWorker.java): `app/src/main/java/bgmi/app/bgmi_android/utils/ImageWorker.java`
- [Remote image fetch](https://github.com/bgmi/bgmi-android/blob/master/app/src/main/java/bgmi/app/bgmi_android/utils/RemoteImage.java): `app/src/main/java/bgmi/app/bgmi_android/utils/RemoteImage.java`

### Other components

- **User**
- **Episode browser**
- **BGmi backend**
- **Android preferences**

## Connections

- User → Main activity: opens (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Main activity → Settings: shows (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Main activity → Current series: shows (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Main activity → Older series: shows (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Main activity → Calendar screen: shows (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Main activity → About screen: shows (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Main activity → Android preferences: reads (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Main activity → Client properties: sets (evidence: `app/src/main/java/bgmi/app/bgmi_android/MainActivity.java`)
- Settings → Client properties: configures (evidence: `app/src/main/java/bgmi/app/bgmi_android/SettingsFragment.java`)
- Current series → Android preferences: reads/writes (evidence: `app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java`)
- Current series → Backend client: loads (evidence: `app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java`)
- Current series → Series adapter: renders with (evidence: `app/src/main/java/bgmi/app/bgmi_android/BangumiListFragment.java`)
- Older series → Backend client: loads (evidence: `app/src/main/java/bgmi/app/bgmi_android/OldBangumiListFragment.java`)
- Older series → Series adapter: renders with (evidence: `app/src/main/java/bgmi/app/bgmi_android/OldBangumiListFragment.java`)
- Series adapter → Series cards: binds (evidence: `app/src/main/java/bgmi/app/bgmi_android/adapters/BangumiAdapter.java`)
- Series cards → Series model: displays (evidence: `app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java`)
- Series cards → Image cache: loads cover (evidence: `app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java`)
- Series cards → Episode browser: opens link (evidence: `app/src/main/java/bgmi/app/bgmi_android/holders/BangumiViewHolder.java`)
- Calendar screen → Backend client: loads calendar (evidence: `app/src/main/java/bgmi/app/bgmi_android/CalendarFragment.java`)
- Calendar screen → Calendar adapter: renders with (evidence: `app/src/main/java/bgmi/app/bgmi_android/CalendarFragment.java`)
- Calendar adapter → Calendar holders: binds (evidence: `app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarAdapter.java`)
- Calendar holders → Calendar item adapter: renders with (evidence: `app/src/main/java/bgmi/app/bgmi_android/holders/CalendarViewHolder.java`)
- Calendar item adapter → Subscription control: binds (evidence: `app/src/main/java/bgmi/app/bgmi_android/adapters/CalendarItemAdapter.java`)
- Subscription control → Backend client: subscribes via (evidence: `app/src/main/java/bgmi/app/bgmi_android/holders/CalendarItemViewHolder.java`)
- Backend client → BGmi backend: requests data (evidence: `app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java`)
- Backend client → Callback contract: reports results (evidence: `app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java`)
- Backend client → Client properties: reads endpoints (evidence: `app/src/main/java/bgmi/app/bgmi_android/utils/BGmiManager.java`)
- Image cache → Remote image fetch: dispatches fetch (evidence: `app/src/main/java/bgmi/app/bgmi_android/utils/ImageWorker.java`)
