# fluxluffy/anilili architecture

> Architecture diagram of the GitHub repository fluxluffy/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/fluxluffy/anilili
- Repository: https://github.com/fluxluffy/anilili

## Overview

Anilili is a native Android anime client for mobile and TV. Users discover a title, open its details, find an episode across streaming sources, then watch or download it; playback can update viewing progress and optionally sync a list account. Separate capabilities include manga reading, recommendations, airing alerts, backup/restore, Discord presence, and support diagnostics. The README documents the product workflow and capabilities; sampled source confirms selected runtime services and stores, but many feature implementations were not excerpted, so uncertain module-level links are omitted or dashed.

Main entry points: [`app/src/main/java/com/anilili/playback/PlaybackService.kt`](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/playback/PlaybackService.kt) (Media3 playback), [`app/src/main/java/com/anilili/data/library/LibraryStore.kt`](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/library/LibraryStore.kt) (Saved titles and progress), [`app/src/main/java/com/anilili/data/auth/AuthManager.kt`](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/auth/AuthManager.kt) (Account authentication), [`app/src/main/java/com/anilili/MainActivity.kt`](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/MainActivity.kt) (Android app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["Android app<br/>[MainActivity.kt]"]
  node_routes["Navigation routes<br/>[Routes.kt]"]
  node_details["Anime details<br/>[DetailScreen.kt]"]
end

subgraph group_catalog["Discovery and sources"]
  node_catalog["Anime catalog"]
  node_providers["Streaming providers"]
  node_manga["Manga discovery and reading"]
  node_recommendations["Recommendations<br/>[Recommendations.kt]"]
end

subgraph group_watch["Playback and downloads"]
  node_player["Media3 playback<br/>[PlaybackService.kt]"]
  node_downloads["Episode downloads"]
  node_downloadservice["Download service"]
  node_cast["Casting<br/>[CastRoute.kt]"]
end

subgraph group_library["Library and accounts"]
  node_library[("Saved titles and progress<br/>[LibraryStore.kt]")]
  node_accounts["Account authentication<br/>[AuthManager.kt]"]
  node_settings[("Settings<br/>[SettingsStore.kt]")]
  node_backup["Backup and restore<br/>[BackupManager.kt]"]
end

subgraph group_services["Supporting features"]
  node_reminders["Airing alerts"]
  node_discord["Discord presence<br/>[DiscordPresence.kt]"]
  node_diagnostics["Support diagnostics<br/>[DiagnosticsLog.kt]"]
end

node_viewer(("Viewer"))
node_anilist["AniList"]
node_mal["MyAnimeList"]
node_subtitle["OpenSubtitles"]
node_discord_service["Discord service"]
node_source_sites["Streaming sources"]

node_viewer -->|"uses"| node_app
node_app -.->|"navigates"| node_routes
node_routes -.->|"opens"| node_details
node_details -.->|"loads title"| node_catalog
node_catalog -.->|"finds streams"| node_providers
node_providers -.->|"resolves media"| node_source_sites
node_player -->|"offers offline"| node_downloads
node_downloads -.->|"runs downloads"| node_downloadservice
node_viewer -->|"watches episodes"| node_player
node_player -.->|"routes playback"| node_cast
node_player -->|"records progress"| node_library
node_library -->|"syncs lists"| node_anilist
node_library -->|"syncs lists"| node_mal
node_accounts -.->|"authenticates"| node_anilist
node_accounts -.->|"authenticates"| node_mal
node_viewer -->|"reads manga"| node_manga
node_viewer -.->|"explores suggestions"| node_recommendations
node_library -.->|"tracks airing"| node_reminders
node_viewer -->|"backs up data"| node_backup
node_backup -.->|"restores preferences"| node_settings
node_viewer -->|"connects presence"| node_discord
node_discord -->|"sets activity"| node_discord_service
node_viewer -->|"shares report"| node_diagnostics
node_player -->|"searches captions"| node_subtitle

click node_app "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/MainActivity.kt"
click node_routes "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/ui/nav/Routes.kt"
click node_details "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/ui/detail/DetailScreen.kt"
click node_catalog "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/MiruroRepository.kt"
click node_providers "https://github.com/fluxluffy/anilili/tree/main/app/src/main/java/com/anilili/data/remote"
click node_manga "https://github.com/fluxluffy/anilili/tree/main/app/src/main/java/com/anilili/data/manga"
click node_player "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/playback/PlaybackService.kt"
click node_downloads "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/playback/EpisodeDownloads.kt"
click node_downloadservice "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/playback/EpisodeDownloadService.kt"
click node_cast "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/playback/CastRoute.kt"
click node_library "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/library/LibraryStore.kt"
click node_accounts "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/auth/AuthManager.kt"
click node_settings "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/settings/SettingsStore.kt"
click node_backup "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/backup/BackupManager.kt"
click node_recommendations "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/recs/Recommendations.kt"
click node_reminders "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt"
click node_discord "https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/discord/DiscordPresence.kt"
click node_diagnostics "https://github.com/fluxluffy/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_details,node_viewer toneBlue
class node_catalog,node_providers,node_manga,node_recommendations toneAmber
class node_player,node_downloads,node_downloadservice,node_cast toneMint
class node_library,node_accounts,node_settings,node_backup toneRose
class node_reminders,node_discord,node_diagnostics,node_anilist,node_mal,node_subtitle,node_discord_service,node_source_sites toneIndigo
```

## Components

### App experience

- [Android app](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/MainActivity.kt): `app/src/main/java/com/anilili/MainActivity.kt`
- [Navigation routes](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/ui/nav/Routes.kt): `app/src/main/java/com/anilili/ui/nav/Routes.kt`
- [Anime details](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/ui/detail/DetailScreen.kt): `app/src/main/java/com/anilili/ui/detail/DetailScreen.kt`

### Discovery and sources

- [Anime catalog](https://github.com/fluxluffy/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/fluxluffy/anilili/tree/main/app/src/main/java/com/anilili/data/remote): `app/src/main/java/com/anilili/data/remote`
- [Manga discovery and reading](https://github.com/fluxluffy/anilili/tree/main/app/src/main/java/com/anilili/data/manga): `app/src/main/java/com/anilili/data/manga`
- [Recommendations](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/recs/Recommendations.kt): `app/src/main/java/com/anilili/data/recs/Recommendations.kt`

### Playback and downloads

- [Media3 playback](https://github.com/fluxluffy/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/fluxluffy/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/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/playback/EpisodeDownloadService.kt): `app/src/main/java/com/anilili/playback/EpisodeDownloadService.kt`
- [Casting](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/playback/CastRoute.kt): `app/src/main/java/com/anilili/playback/CastRoute.kt`

### Library and accounts

- [Saved titles and progress](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/library/LibraryStore.kt): `app/src/main/java/com/anilili/data/library/LibraryStore.kt`
- [Account authentication](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/auth/AuthManager.kt): `app/src/main/java/com/anilili/data/auth/AuthManager.kt`
- [Settings](https://github.com/fluxluffy/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/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/backup/BackupManager.kt): `app/src/main/java/com/anilili/data/backup/BackupManager.kt`

### Supporting features

- [Airing alerts](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt): `app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt`
- [Discord presence](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/data/discord/DiscordPresence.kt): `app/src/main/java/com/anilili/data/discord/DiscordPresence.kt`
- [Support diagnostics](https://github.com/fluxluffy/anilili/blob/main/app/src/main/java/com/anilili/diagnostics/DiagnosticsLog.kt): `app/src/main/java/com/anilili/diagnostics/DiagnosticsLog.kt`

### Other components

- **Viewer**
- **AniList**
- **MyAnimeList**
- **OpenSubtitles**
- **Discord service**
- **Streaming sources**

## Connections

- Viewer → Android app: uses (evidence: `README.md`)
- Android app → Navigation routes: navigates
- Navigation routes → Anime details: opens
- Anime details → Anime catalog: loads title
- Anime catalog → Streaming providers: finds streams (evidence: `app/src/main/java/com/anilili/data/MiruroRepository.kt`)
- Streaming providers → Streaming sources: resolves media
- Media3 playback → Episode downloads: offers offline (evidence: `README.md`)
- Episode downloads → Download service: runs downloads (evidence: `app/src/main/java/com/anilili/playback/EpisodeDownloads.kt`)
- Viewer → Media3 playback: watches episodes (evidence: `README.md`)
- Media3 playback → Casting: routes playback (evidence: `app/src/main/java/com/anilili/playback/PlaybackService.kt`)
- Media3 playback → Saved titles and progress: records progress (evidence: `README.md`)
- Saved titles and progress → AniList: syncs lists (evidence: `README.md`)
- Saved titles and progress → MyAnimeList: syncs lists (evidence: `README.md`)
- Account authentication → AniList: authenticates
- Account authentication → MyAnimeList: authenticates
- Viewer → Manga discovery and reading: reads manga (evidence: `README.md`)
- Viewer → Recommendations: explores suggestions
- Saved titles and progress → Airing alerts: tracks airing (evidence: `app/src/main/java/com/anilili/data/reminder/AutomaticReleaseManager.kt`)
- Viewer → Backup and restore: backs up data (evidence: `README.md`)
- Backup and restore → Settings: restores preferences (evidence: `app/src/main/java/com/anilili/data/backup/BackupManager.kt`)
- Viewer → Discord presence: connects presence (evidence: `README.md`)
- Discord presence → Discord service: sets activity (evidence: `README.md`)
- Viewer → Support diagnostics: shares report (evidence: `README.md`)
- Media3 playback → OpenSubtitles: searches captions (evidence: `README.md`)
