# predidit/kazumi architecture

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

- Interactive diagram: https://gitdiagram.com/predidit/kazumi
- Repository: https://github.com/predidit/kazumi

## Overview

Kazumi is a Flutter anime discovery and streaming app built around user-editable scraping rules. The main path is: choose a source, search or browse anime, resolve an episode to a stream, then watch it in the player, with optional danmaku and enhancement. Separate capabilities cover Bangumi metadata and schedules, collections and history, downloads, rule management, and cross-device sync. The README documents these product relationships; the supplied source excerpts chiefly show native host integration, so Dart-level call ownership cannot be confirmed here.

Main entry points: [`lib/pages/player/player_controller.dart`](https://github.com/predidit/kazumi/blob/main/lib/pages/player/player_controller.dart) (Video Player), [`lib/pages/plugin_editor/plugin_editor_page.dart`](https://github.com/predidit/kazumi/blob/main/lib/pages/plugin_editor/plugin_editor_page.dart) (Rule Editor), [`lib/request/apis/bangumi_api.dart`](https://github.com/predidit/kazumi/blob/main/lib/request/apis/bangumi_api.dart) (Bangumi API), [`lib/services/sync/webdav.dart`](https://github.com/predidit/kazumi/blob/main/lib/services/sync/webdav.dart) (Device Sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery"]
  node_catalog["Anime Catalog<br/>[popular_page.dart]"]
  node_search["Anime Search<br/>[search_page.dart]"]
  node_image_search["Image Search"]
  node_timeline["Broadcast Timeline<br/>[timeline_page.dart]"]
  node_info["Anime Details<br/>[info_page.dart]"]
  node_bangumi["Bangumi API<br/>[bangumi_api.dart]"]
end

subgraph group_streaming["Streaming"]
  node_video_source["Source Resolver"]
  node_player["Video Player"]
  node_danmaku["Danmaku"]
  node_super_resolution["Anime4K Upscaling"]
  node_downloads["Downloads"]
  node_external_player["External Playback"]
end

subgraph group_library["Personal Library"]
  node_collections["Collections<br/>[collect_page.dart]"]
  node_history["Watch History<br/>[history_page.dart]"]
  node_sync["Device Sync<br/>[webdav.dart]"]
  node_webdav["WebDAV Server"]
end

subgraph group_rules["Rules and Sources"]
  node_plugin_editor["Rule Editor"]
  node_plugin_engine["Rule Engine<br/>[rule_engine.dart]"]
  node_plugin_sources["Plugin Sources<br/>[plugins.dart]"]
end

subgraph group_platform["Platform Integration"]
  node_windows_host["Windows Host<br/>[flutter_window.cpp]"]
  node_linux_host["Linux Host<br/>[my_application.cc]"]
  node_linux_portal["External Player Portal"]
end

node_viewer(("Viewer"))
node_bangumi_service["Bangumi Service"]
node_danmaku_service["Danmaku Service"]
node_syncplay_service["SyncPlay Service"]
node_trace_service["trace.moe Service"]
node_media_kit["media-kit"]

node_viewer -->|"browses"| node_catalog
node_viewer -->|"searches"| node_search
node_viewer -->|"identifies from image"| node_image_search
node_viewer -->|"views schedule"| node_timeline
node_viewer -->|"edits rules"| node_plugin_editor
node_search -->|"searches via rules"| node_plugin_engine
node_catalog -.->|"opens details"| node_info
node_timeline -->|"gets metadata"| node_bangumi
node_info -->|"gets metadata"| node_bangumi
node_bangumi -->|"requests metadata"| node_bangumi_service
node_plugin_editor -->|"manages sources"| node_plugin_sources
node_plugin_editor -.->|"configures rules"| node_plugin_engine
node_plugin_engine -.->|"resolves streams"| node_video_source
node_video_source -.->|"provides stream"| node_player
node_viewer -->|"watches episodes"| node_player
node_player -->|"plays media"| node_media_kit
node_player -->|"shows subtitles"| node_danmaku
node_danmaku -->|"requests danmaku"| node_danmaku_service
node_player -->|"applies upscaling"| node_super_resolution
node_player -.->|"downloads episodes"| node_downloads
node_player -->|"launches external playback"| node_external_player
node_viewer -->|"manages watchlist"| node_collections
node_viewer -->|"reviews viewing history"| node_history
node_collections -->|"syncs collection"| node_sync
node_history -->|"syncs history"| node_sync
node_sync -->|"syncs remotely"| node_webdav
node_image_search -->|"recognizes anime"| node_trace_service
node_viewer -->|"watches together"| node_syncplay_service
node_windows_host -->|"registers plugin"| node_media_kit
node_linux_host -->|"uses portal"| node_linux_portal

click node_catalog "https://github.com/predidit/kazumi/blob/main/lib/pages/popular/popular_page.dart"
click node_search "https://github.com/predidit/kazumi/blob/main/lib/pages/search/search_page.dart"
click node_image_search "https://github.com/predidit/kazumi/blob/main/lib/pages/search/image_search_page.dart"
click node_timeline "https://github.com/predidit/kazumi/blob/main/lib/pages/timeline/timeline_page.dart"
click node_info "https://github.com/predidit/kazumi/blob/main/lib/pages/info/info_page.dart"
click node_bangumi "https://github.com/predidit/kazumi/blob/main/lib/request/apis/bangumi_api.dart"
click node_plugin_editor "https://github.com/predidit/kazumi/blob/main/lib/pages/plugin_editor/plugin_editor_page.dart"
click node_plugin_engine "https://github.com/predidit/kazumi/blob/main/lib/services/plugin/rule_engine.dart"
click node_plugin_sources "https://github.com/predidit/kazumi/blob/main/lib/plugins/plugins.dart"
click node_video_source "https://github.com/predidit/kazumi/blob/main/lib/services/video_source/video_source_service.dart"
click node_player "https://github.com/predidit/kazumi/blob/main/lib/pages/player/player_controller.dart"
click node_danmaku "https://github.com/predidit/kazumi/blob/main/lib/modules/danmaku/danmaku_module.dart"
click node_super_resolution "https://github.com/predidit/kazumi/blob/main/lib/services/shaders/shader_asset_service.dart"
click node_downloads "https://github.com/predidit/kazumi/blob/main/lib/services/download/download_manager.dart"
click node_external_player "https://github.com/predidit/kazumi/blob/main/lib/services/player/external_playback_launcher.dart"
click node_collections "https://github.com/predidit/kazumi/blob/main/lib/pages/collect/collect_page.dart"
click node_history "https://github.com/predidit/kazumi/blob/main/lib/pages/history/history_page.dart"
click node_sync "https://github.com/predidit/kazumi/blob/main/lib/services/sync/webdav.dart"
click node_windows_host "https://github.com/predidit/kazumi/blob/main/windows/runner/flutter_window.cpp"
click node_linux_host "https://github.com/predidit/kazumi/blob/main/linux/my_application.cc"
click node_linux_portal "https://github.com/predidit/kazumi/blob/main/linux/external_player_portal.cc"

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_catalog,node_search,node_image_search,node_timeline,node_info,node_bangumi,node_viewer toneBlue
class node_video_source,node_player,node_danmaku,node_super_resolution,node_downloads,node_external_player toneAmber
class node_collections,node_history,node_sync,node_webdav toneMint
class node_plugin_editor,node_plugin_engine,node_plugin_sources toneRose
class node_windows_host,node_linux_host,node_linux_portal,node_bangumi_service,node_danmaku_service,node_syncplay_service,node_trace_service,node_media_kit toneIndigo
```

## Components

### Discovery

- [Anime Catalog](https://github.com/predidit/kazumi/blob/main/lib/pages/popular/popular_page.dart): `lib/pages/popular/popular_page.dart`
- [Anime Search](https://github.com/predidit/kazumi/blob/main/lib/pages/search/search_page.dart): `lib/pages/search/search_page.dart`
- [Image Search](https://github.com/predidit/kazumi/blob/main/lib/pages/search/image_search_page.dart): `lib/pages/search/image_search_page.dart`
- [Broadcast Timeline](https://github.com/predidit/kazumi/blob/main/lib/pages/timeline/timeline_page.dart): `lib/pages/timeline/timeline_page.dart`
- [Anime Details](https://github.com/predidit/kazumi/blob/main/lib/pages/info/info_page.dart): `lib/pages/info/info_page.dart`
- [Bangumi API](https://github.com/predidit/kazumi/blob/main/lib/request/apis/bangumi_api.dart): `lib/request/apis/bangumi_api.dart`

### Streaming

- [Source Resolver](https://github.com/predidit/kazumi/blob/main/lib/services/video_source/video_source_service.dart): `lib/services/video_source/video_source_service.dart`
- [Video Player](https://github.com/predidit/kazumi/blob/main/lib/pages/player/player_controller.dart): `lib/pages/player/player_controller.dart`
- [Danmaku](https://github.com/predidit/kazumi/blob/main/lib/modules/danmaku/danmaku_module.dart): `lib/modules/danmaku/danmaku_module.dart`
- [Anime4K Upscaling](https://github.com/predidit/kazumi/blob/main/lib/services/shaders/shader_asset_service.dart): `lib/services/shaders/shader_asset_service.dart`
- [Downloads](https://github.com/predidit/kazumi/blob/main/lib/services/download/download_manager.dart): `lib/services/download/download_manager.dart`
- [External Playback](https://github.com/predidit/kazumi/blob/main/lib/services/player/external_playback_launcher.dart): `lib/services/player/external_playback_launcher.dart`

### Personal Library

- [Collections](https://github.com/predidit/kazumi/blob/main/lib/pages/collect/collect_page.dart): `lib/pages/collect/collect_page.dart`
- [Watch History](https://github.com/predidit/kazumi/blob/main/lib/pages/history/history_page.dart): `lib/pages/history/history_page.dart`
- [Device Sync](https://github.com/predidit/kazumi/blob/main/lib/services/sync/webdav.dart): `lib/services/sync/webdav.dart`
- **WebDAV Server**

### Rules and Sources

- [Rule Editor](https://github.com/predidit/kazumi/blob/main/lib/pages/plugin_editor/plugin_editor_page.dart): `lib/pages/plugin_editor/plugin_editor_page.dart`
- [Rule Engine](https://github.com/predidit/kazumi/blob/main/lib/services/plugin/rule_engine.dart): `lib/services/plugin/rule_engine.dart`
- [Plugin Sources](https://github.com/predidit/kazumi/blob/main/lib/plugins/plugins.dart): `lib/plugins/plugins.dart`

### Platform Integration

- [Windows Host](https://github.com/predidit/kazumi/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Linux Host](https://github.com/predidit/kazumi/blob/main/linux/my_application.cc): `linux/my_application.cc`
- [External Player Portal](https://github.com/predidit/kazumi/blob/main/linux/external_player_portal.cc): `linux/external_player_portal.cc`

### Other components

- **Viewer**
- **Bangumi Service**
- **Danmaku Service**
- **SyncPlay Service**
- **trace.moe Service**
- **media-kit**

## Connections

- Viewer → Anime Catalog: browses (evidence: `README.md`)
- Viewer → Anime Search: searches (evidence: `README.md`)
- Viewer → Image Search: identifies from image (evidence: `README.md`)
- Viewer → Broadcast Timeline: views schedule (evidence: `README.md`)
- Viewer → Rule Editor: edits rules (evidence: `README.md`)
- Anime Search → Rule Engine: searches via rules (evidence: `README.md`)
- Anime Catalog → Anime Details: opens details
- Broadcast Timeline → Bangumi API: gets metadata (evidence: `README.md`)
- Anime Details → Bangumi API: gets metadata (evidence: `README.md`)
- Bangumi API → Bangumi Service: requests metadata (evidence: `README.md`)
- Rule Editor → Plugin Sources: manages sources (evidence: `README.md`)
- Rule Editor → Rule Engine: configures rules
- Rule Engine → Source Resolver: resolves streams
- Source Resolver → Video Player: provides stream
- Viewer → Video Player: watches episodes (evidence: `README.md`)
- Video Player → media-kit: plays media (evidence: `README.md`)
- Video Player → Danmaku: shows subtitles (evidence: `README.md`)
- Danmaku → Danmaku Service: requests danmaku (evidence: `README.md`)
- Video Player → Anime4K Upscaling: applies upscaling (evidence: `README.md`)
- Video Player → Downloads: downloads episodes
- Video Player → External Playback: launches external playback (evidence: `README.md`)
- Viewer → Collections: manages watchlist (evidence: `README.md`)
- Viewer → Watch History: reviews viewing history (evidence: `README.md`)
- Collections → Device Sync: syncs collection (evidence: `README.md`)
- Watch History → Device Sync: syncs history (evidence: `README.md`)
- Device Sync → WebDAV Server: syncs remotely (evidence: `README.md`)
- Image Search → trace.moe Service: recognizes anime (evidence: `README.md`)
- Viewer → SyncPlay Service: watches together (evidence: `README.md`)
- Windows Host → media-kit: registers plugin (evidence: `windows/runner/flutter_window.cpp`)
- Linux Host → External Player Portal: uses portal (evidence: `linux/my_application.cc`)
