# sanilili/anilili architecture

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

- Interactive diagram: https://gitdiagram.com/sanilili/anilili
- Repository: https://github.com/sanilili/anilili

## Overview

Anilili is a native Android anime discovery and watching app for phones and TVs. The main journey is discovery and title selection, episode/source resolution, native playback, then optional library progress sync or offline download. Separate branches cover accounts, backup, recommendations, release alerts, and diagnostics. The README documents the broad capabilities; sampled excerpts and the source index support selected internal wiring. Many provider and UI implementations were not sampled, so uncertain call relationships are omitted.

Main entry points: [`app/src/main/java/com/anilili/data/MiruroRepository.kt`](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/MiruroRepository.kt) (Anime repository), [`app/src/main/java/com/anilili/MainActivity.kt`](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/MainActivity.kt) (App shell), [`app/src/main/java/com/anilili/ui/nav/Routes.kt`](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/nav/Routes.kt) (Navigation routes), [`app/src/main/java/com/anilili/ui/detail/DetailScreen.kt`](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/detail/DetailScreen.kt) (Title details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App shell<br/>[MainActivity.kt]"]
  node_routes["Navigation routes<br/>[Routes.kt]"]
  node_home["Home and discovery<br/>[HomeScreen.kt]"]
  node_detail["Title details<br/>[DetailScreen.kt]"]
  node_tv["Adaptive TV UI<br/>[TvHomeScreen.kt]"]
end

subgraph group_catalog["Catalog and accounts"]
  node_graph["App dependencies<br/>[AppGraph.kt]"]
  node_repository["Anime repository"]
  node_providers["Streaming providers"]
  node_metadata["Anime metadata<br/>[AniListClient.kt]"]
  node_library[("Library and progress<br/>[LibraryStore.kt]")]
  node_auth["Account sign-in<br/>[AuthManager.kt]"]
  node_tokens[("Secure tokens")]
end

subgraph group_watch["Watching and offline"]
  node_player["Media3 playback<br/>[PlaybackService.kt]"]
  node_downloads["Episode downloads"]
  node_download_service["Download service"]
  node_player_extras["Subtitles and cast"]
end

subgraph group_services["Supporting services"]
  node_settings[("Preferences<br/>[SettingsStore.kt]")]
  node_backup["Backup and restore<br/>[BackupManager.kt]"]
  node_recommendations["Recommendations<br/>[Recommendations.kt]"]
  node_release_alerts["Release alerts"]
  node_diagnostics["Diagnostics reports<br/>[DiagnosticsLog.kt]"]
end

node_viewer(("Viewer"))

node_viewer -->|"uses"| node_app
node_app -->|"navigates"| node_routes
node_routes -->|"opens"| node_home
node_routes -->|"opens"| node_detail
node_app -->|"adapts for TV"| node_tv
node_home -.->|"discovers titles"| node_repository
node_detail -.->|"loads title"| node_repository
node_graph -->|"provides"| node_repository
node_repository -.->|"resolves sources"| node_providers
node_repository -.->|"loads metadata"| node_metadata
node_detail -->|"starts episode"| node_player
node_player -->|"records progress"| node_library
node_player -->|"supports captions and cast"| node_player_extras
node_downloads -->|"runs downloads"| node_download_service
node_viewer -->|"signs in"| node_auth
node_auth -->|"stores credentials"| node_tokens
node_auth -->|"enables list sync"| node_library
node_viewer -->|"configures"| node_settings
node_viewer -->|"backs up or restores"| node_backup
node_viewer -.->|"gets recommendations"| node_recommendations
node_library -->|"tracks saved titles"| node_release_alerts
node_viewer -->|"shares report"| node_diagnostics

click node_app "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/MainActivity.kt"
click node_routes "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/nav/Routes.kt"
click node_home "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/home/HomeScreen.kt"
click node_detail "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/detail/DetailScreen.kt"
click node_tv "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/home/TvHomeScreen.kt"
click node_graph "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/AppGraph.kt"
click node_repository "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/MiruroRepository.kt"
click node_providers "https://github.com/sanilili/anilili/tree/main/app/src/main/java/com/anilili/data/remote"
click node_metadata "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/remote/AniListClient.kt"
click node_library "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/library/LibraryStore.kt"
click node_auth "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/auth/AuthManager.kt"
click node_tokens "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/auth/SecureTokenStore.kt"
click node_player "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/playback/PlaybackService.kt"
click node_downloads "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/playback/EpisodeDownloads.kt"
click node_download_service "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/playback/EpisodeDownloadService.kt"
click node_player_extras "https://github.com/sanilili/anilili/tree/main/app/src/main/java/com/anilili/playback"
click node_settings "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/settings/SettingsStore.kt"
click node_backup "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/backup/BackupManager.kt"
click node_recommendations "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/recs/Recommendations.kt"
click node_release_alerts "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt"
click node_diagnostics "https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/diagnostics/DiagnosticsLog.kt"

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_app,node_routes,node_home,node_detail,node_tv,node_viewer toneBlue
class node_graph,node_repository,node_providers,node_metadata,node_library,node_auth,node_tokens toneAmber
class node_player,node_downloads,node_download_service,node_player_extras toneMint
class node_settings,node_backup,node_recommendations,node_release_alerts,node_diagnostics toneRose
```

## Components

### App experience

- [App shell](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/MainActivity.kt): `app/src/main/java/com/anilili/MainActivity.kt`
- [Navigation routes](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/nav/Routes.kt): `app/src/main/java/com/anilili/ui/nav/Routes.kt`
- [Home and discovery](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/home/HomeScreen.kt): `app/src/main/java/com/anilili/ui/home/HomeScreen.kt`
- [Title details](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/detail/DetailScreen.kt): `app/src/main/java/com/anilili/ui/detail/DetailScreen.kt`
- [Adaptive TV UI](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/ui/home/TvHomeScreen.kt): `app/src/main/java/com/anilili/ui/home/TvHomeScreen.kt`

### Catalog and accounts

- [App dependencies](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/AppGraph.kt): `app/src/main/java/com/anilili/data/AppGraph.kt`
- [Anime repository](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/MiruroRepository.kt): `app/src/main/java/com/anilili/data/MiruroRepository.kt`
- [Streaming providers](https://github.com/sanilili/anilili/tree/main/app/src/main/java/com/anilili/data/remote): `app/src/main/java/com/anilili/data/remote`
- [Anime metadata](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/remote/AniListClient.kt): `app/src/main/java/com/anilili/data/remote/AniListClient.kt`
- [Library and progress](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/library/LibraryStore.kt): `app/src/main/java/com/anilili/data/library/LibraryStore.kt`
- [Account sign-in](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/auth/AuthManager.kt): `app/src/main/java/com/anilili/data/auth/AuthManager.kt`
- [Secure tokens](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/auth/SecureTokenStore.kt): `app/src/main/java/com/anilili/data/auth/SecureTokenStore.kt`

### Watching and offline

- [Media3 playback](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/playback/PlaybackService.kt): `app/src/main/java/com/anilili/playback/PlaybackService.kt`
- [Episode downloads](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/playback/EpisodeDownloads.kt): `app/src/main/java/com/anilili/playback/EpisodeDownloads.kt`
- [Download service](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/playback/EpisodeDownloadService.kt): `app/src/main/java/com/anilili/playback/EpisodeDownloadService.kt`
- [Subtitles and cast](https://github.com/sanilili/anilili/tree/main/app/src/main/java/com/anilili/playback): `app/src/main/java/com/anilili/playback`

### Supporting services

- [Preferences](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/settings/SettingsStore.kt): `app/src/main/java/com/anilili/data/settings/SettingsStore.kt`
- [Backup and restore](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/backup/BackupManager.kt): `app/src/main/java/com/anilili/data/backup/BackupManager.kt`
- [Recommendations](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/recs/Recommendations.kt): `app/src/main/java/com/anilili/data/recs/Recommendations.kt`
- [Release alerts](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt): `app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt`
- [Diagnostics reports](https://github.com/sanilili/anilili/blob/main/app/src/main/java/com/anilili/diagnostics/DiagnosticsLog.kt): `app/src/main/java/com/anilili/diagnostics/DiagnosticsLog.kt`

### Other components

- **Viewer**

## Connections

- Viewer → App shell: uses (evidence: `README.md`)
- App shell → Navigation routes: navigates (evidence: `app/src/main/java/com/anilili/ui/nav/Routes.kt`)
- Navigation routes → Home and discovery: opens (evidence: `README.md`)
- Navigation routes → Title details: opens (evidence: `app/src/main/java/com/anilili/ui/nav/Routes.kt`)
- App shell → Adaptive TV UI: adapts for TV (evidence: `README.md`)
- Home and discovery → Anime repository: discovers titles
- Title details → Anime repository: loads title
- App dependencies → Anime repository: provides (evidence: `app/src/main/java/com/anilili/data/AppGraph.kt`)
- Anime repository → Streaming providers: resolves sources (evidence: `app/src/main/java/com/anilili/data/MiruroRepository.kt`)
- Anime repository → Anime metadata: loads metadata (evidence: `app/src/main/java/com/anilili/data/MiruroRepository.kt`)
- Title details → Media3 playback: starts episode (evidence: `README.md`)
- Media3 playback → Library and progress: records progress (evidence: `README.md`)
- Media3 playback → Subtitles and cast: supports captions and cast (evidence: `README.md`)
- Episode downloads → Download service: runs downloads (evidence: `app/src/main/java/com/anilili/playback/EpisodeDownloadService.kt`)
- Viewer → Account sign-in: signs in (evidence: `README.md`)
- Account sign-in → Secure tokens: stores credentials (evidence: `app/src/main/java/com/anilili/data/auth/AuthManager.kt`)
- Account sign-in → Library and progress: enables list sync (evidence: `README.md`)
- Viewer → Preferences: configures (evidence: `README.md`)
- Viewer → Backup and restore: backs up or restores (evidence: `README.md`)
- Viewer → Recommendations: gets recommendations
- Library and progress → Release alerts: tracks saved titles (evidence: `app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt`)
- Viewer → Diagnostics reports: shares report (evidence: `README.md`)
