# aniyomiorg/aniyomi architecture

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

- Interactive diagram: https://gitdiagram.com/aniyomiorg/aniyomi
- Repository: https://github.com/aniyomiorg/aniyomi

## Overview

Aniyomi is an Android anime and manga discovery, library, reading, and playback app. Users browse sources or local content, organize entries, and read or watch them; the README also documents tracking, categories, scheduled updates, and backups. The tree shows presentation, domain, data, source, and storage responsibilities, but most runtime modules were not excerpted. Accordingly, documented product capabilities are included, while unverified connections between those capabilities are omitted or marked dashed.

Main entry points: [`app/src/main/java/eu/kanade/tachiyomi/ui/storage/CommonStorageScreenModel.kt`](https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/tachiyomi/ui/storage/CommonStorageScreenModel.kt) (Storage screen model), [`app/src/main/java/eu/kanade/presentation/browse`](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/browse) (Browse and search), [`app/src/main/java/eu/kanade/domain/source`](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/source) (Sources and extensions), [`app/src/main/java/eu/kanade/domain/track`](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/track) (External tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and Sources"]
  node_browse["Browse and search"]
  node_source_catalog["Sources and extensions"]
  node_extension_store["Extension stores"]
end

subgraph group_library["Library and Entries"]
  node_library_ui["Library"]
  node_entry_management["Entry management"]
  node_categories["Categories"]
end

subgraph group_consumption["Reading and Playback"]
  node_local_content["Local content"]
  node_reader["Reader"]
  node_player["Player"]
end

subgraph group_services["Supporting Services"]
  node_tracking["External tracking"]
  node_updates["Scheduled updates"]
  node_backup["Backups<br/>[StorageManager.kt]"]
end

subgraph group_storage["Storage Management"]
  node_storage_setup["Storage setup<br/>[StorageStep.kt]"]
  node_storage_service["Storage manager<br/>[StorageManager.kt]"]
  node_storage_preferences["Storage preferences"]
  node_storage_model["Storage screen model"]
  node_storage_screen["Storage screen"]
  node_storage_item["Storage items<br/>[StorageItem.kt]"]
end

node_user(("Aniyomi user"))
node_external_trackers["Tracking services"]
node_external_sources["Content sources"]

node_user -->|"browses content"| node_browse
node_browse -.->|"uses sources"| node_source_catalog
node_source_catalog -.->|"fetches content"| node_external_sources
node_user -->|"organizes entries"| node_library_ui
node_user -->|"reads locally"| node_reader
node_user -->|"watches content"| node_player
node_user -->|"tracks progress"| node_tracking
node_tracking -->|"syncs progress"| node_external_trackers
node_user -->|"organizes library"| node_categories
node_user -->|"schedules updates"| node_updates
node_user -->|"backs up data"| node_backup
node_user -.->|"sets storage"| node_storage_setup
node_storage_setup -->|"updates preference"| node_storage_preferences
node_storage_preferences -->|"supplies directory"| node_storage_service
node_storage_model -->|"creates items"| node_storage_item
node_storage_screen -->|"renders items"| node_storage_item
node_storage_model -->|"provides state"| node_storage_screen
node_extension_store -->|"fetches listings"| node_external_sources

click node_browse "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/browse"
click node_source_catalog "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/source"
click node_extension_store "https://github.com/aniyomiorg/aniyomi/blob/main/data/src/main/java/mihon/data/extension/anime/service/AnimeExtensionStoreService.kt"
click node_library_ui "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/library"
click node_entry_management "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/entries"
click node_categories "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/category"
click node_local_content "https://github.com/aniyomiorg/aniyomi/tree/main/source-local/src/commonMain/kotlin/tachiyomi/source/local"
click node_reader "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/entries/manga"
click node_player "https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/tachiyomi/data/player/service/HttpServerService.kt"
click node_tracking "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/track"
click node_updates "https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/items"
click node_backup "https://github.com/aniyomiorg/aniyomi/blob/main/domain/src/main/java/tachiyomi/domain/storage/service/StorageManager.kt"
click node_storage_setup "https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/presentation/more/onboarding/StorageStep.kt"
click node_storage_service "https://github.com/aniyomiorg/aniyomi/blob/main/domain/src/main/java/tachiyomi/domain/storage/service/StorageManager.kt"
click node_storage_preferences "https://github.com/aniyomiorg/aniyomi/blob/main/domain/src/main/java/tachiyomi/domain/storage/service/StoragePreferences.kt"
click node_storage_model "https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/tachiyomi/ui/storage/CommonStorageScreenModel.kt"
click node_storage_screen "https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/presentation/more/storage/StorageScreenContent.kt"
click node_storage_item "https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/presentation/more/storage/StorageItem.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_browse,node_source_catalog,node_extension_store,node_user toneBlue
class node_library_ui,node_entry_management,node_categories toneAmber
class node_local_content,node_reader,node_player toneMint
class node_tracking,node_updates,node_backup toneRose
class node_storage_setup,node_storage_service,node_storage_preferences,node_storage_model,node_storage_screen,node_storage_item,node_external_trackers,node_external_sources toneIndigo
```

## Components

### Discovery and Sources

- [Browse and search](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/browse): `app/src/main/java/eu/kanade/presentation/browse`
- [Sources and extensions](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/source): `app/src/main/java/eu/kanade/domain/source`
- [Extension stores](https://github.com/aniyomiorg/aniyomi/blob/main/data/src/main/java/mihon/data/extension/anime/service/AnimeExtensionStoreService.kt): `data/src/main/java/mihon/data/extension/anime/service/AnimeExtensionStoreService.kt`

### Library and Entries

- [Library](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/library): `app/src/main/java/eu/kanade/presentation/library`
- [Entry management](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/entries): `app/src/main/java/eu/kanade/domain/entries`
- [Categories](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/category): `app/src/main/java/eu/kanade/presentation/category`

### Reading and Playback

- [Local content](https://github.com/aniyomiorg/aniyomi/tree/main/source-local/src/commonMain/kotlin/tachiyomi/source/local): `source-local/src/commonMain/kotlin/tachiyomi/source/local`
- [Reader](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/presentation/entries/manga): `app/src/main/java/eu/kanade/presentation/entries/manga`
- [Player](https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/tachiyomi/data/player/service/HttpServerService.kt): `app/src/main/java/eu/kanade/tachiyomi/data/player/service/HttpServerService.kt`

### Supporting Services

- [External tracking](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/track): `app/src/main/java/eu/kanade/domain/track`
- [Scheduled updates](https://github.com/aniyomiorg/aniyomi/tree/main/app/src/main/java/eu/kanade/domain/items): `app/src/main/java/eu/kanade/domain/items`
- [Backups](https://github.com/aniyomiorg/aniyomi/blob/main/domain/src/main/java/tachiyomi/domain/storage/service/StorageManager.kt): `domain/src/main/java/tachiyomi/domain/storage/service/StorageManager.kt`

### Storage Management

- [Storage setup](https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/presentation/more/onboarding/StorageStep.kt): `app/src/main/java/eu/kanade/presentation/more/onboarding/StorageStep.kt`
- [Storage manager](https://github.com/aniyomiorg/aniyomi/blob/main/domain/src/main/java/tachiyomi/domain/storage/service/StorageManager.kt): `domain/src/main/java/tachiyomi/domain/storage/service/StorageManager.kt`
- [Storage preferences](https://github.com/aniyomiorg/aniyomi/blob/main/domain/src/main/java/tachiyomi/domain/storage/service/StoragePreferences.kt): `domain/src/main/java/tachiyomi/domain/storage/service/StoragePreferences.kt`
- [Storage screen model](https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/tachiyomi/ui/storage/CommonStorageScreenModel.kt): `app/src/main/java/eu/kanade/tachiyomi/ui/storage/CommonStorageScreenModel.kt`
- [Storage screen](https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/presentation/more/storage/StorageScreenContent.kt): `app/src/main/java/eu/kanade/presentation/more/storage/StorageScreenContent.kt`
- [Storage items](https://github.com/aniyomiorg/aniyomi/blob/main/app/src/main/java/eu/kanade/presentation/more/storage/StorageItem.kt): `app/src/main/java/eu/kanade/presentation/more/storage/StorageItem.kt`

### Other components

- **Aniyomi user**
- **Tracking services**
- **Content sources**

## Connections

- Aniyomi user → Browse and search: browses content (evidence: `README.md`)
- Browse and search → Sources and extensions: uses sources
- Sources and extensions → Content sources: fetches content
- Aniyomi user → Library: organizes entries (evidence: `README.md`)
- Aniyomi user → Reader: reads locally (evidence: `README.md`)
- Aniyomi user → Player: watches content (evidence: `README.md`)
- Aniyomi user → External tracking: tracks progress (evidence: `README.md`)
- External tracking → Tracking services: syncs progress (evidence: `README.md`)
- Aniyomi user → Categories: organizes library (evidence: `README.md`)
- Aniyomi user → Scheduled updates: schedules updates (evidence: `README.md`)
- Aniyomi user → Backups: backs up data (evidence: `README.md`)
- Aniyomi user → Storage setup: sets storage
- Storage setup → Storage preferences: updates preference (evidence: `app/src/main/java/eu/kanade/presentation/more/onboarding/StorageStep.kt`)
- Storage preferences → Storage manager: supplies directory (evidence: `domain/src/main/java/tachiyomi/domain/storage/service/StorageManager.kt`)
- Storage screen model → Storage items: creates items (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/storage/CommonStorageScreenModel.kt`)
- Storage screen → Storage items: renders items (evidence: `app/src/main/java/eu/kanade/presentation/more/storage/StorageScreenContent.kt`)
- Storage screen model → Storage screen: provides state (evidence: `app/src/main/java/eu/kanade/tachiyomi/ui/storage/CommonStorageScreenModel.kt`)
- Extension stores → Content sources: fetches listings (evidence: `data/src/main/java/mihon/data/extension/anime/service/AnimeExtensionStoreService.kt`)
