How itznan/karasu works
Karasu is a cross-platform anime and manga tracker centered on AniList. The principal workflow detects playback, identifies the title and progress, then scrobbles it to the user’s list; the app also supports local lists, discovery, social features, statistics, notifications, and integrations. The graph combines README-documented capabilities with relationships visible in sampled files and the source index; some unsampled subsystem links are therefore omitted.
Main entry points: useListMutations.ts List mutations · list.rs Native commands · detection Playback detection · recognition Title recognition
Components 22
App shell
- App shell and routes
src/app/App.tsx
Playback tracking
- Playback detection
src-tauri/src/playback/detection - Title recognition
src-tauri/src/playback/recognition - Progress scrobbler
src-tauri/src/playback/scrobbler.rs
Lists and sync
- AniList API client
src/api/anilist.ts - Tauri API bridge
src/api/tauri.ts - Anime and manga lists
src/pages/MediaList.tsx - List mutations
src/hooks/useListMutations.ts - Offline sync
src-tauri/src/sync.rs
Discovery and community
- Search and discovery
src/pages/Search.tsx - Season and calendar
src/pages/Seasonal.tsx - Franchise graph
src/pages/Franchise.tsx - Activities and forum
src/pages/Social.tsx - Statistics and review
src/pages/Statistics.tsx
Native services
- Native commands
src-tauri/src/commands/list.rs - Local database
src-tauri/src/db.rs - Local library
src-tauri/src/library.rs - Episode alerts
src-tauri/src/alerts/mod.rs - Discord presence
src-tauri/src/discord.rs
Other components
- User
- Player or browser
- AniList
Connections 22
- User → App shell and routes: uses
README.md - Player or browser → Playback detection: provides playback
README.md - Playback detection → Title recognition: identifies titles
README.md - Title recognition → Progress scrobbler: supplies matches
README.md - Progress scrobbler → AniList: updates progress
README.md - User → Anime and manga lists: edits lists
README.md - Anime and manga lists → List mutations: uses
- List mutations → AniList API client: calls
src/hooks/useListMutations.ts - AniList API client → Tauri API bridge: invokes commands
src/api/anilist.ts - Tauri API bridge → Native commands: dispatches IPC
src/api/tauri.ts - Native commands → Local database: reads and writes
- Native commands → AniList: fetches and updates
- List mutations → Offline sync: queues offline edits
- Offline sync → Local database: persists queue
- User → Local library: scans files
README.md - User → Search and discovery: searches titles
README.md - User → Season and calendar: browses schedules
README.md - User → Franchise graph: explores relations
README.md - User → Activities and forum: reads and writes
README.md - User → Statistics and review: views insights
README.md - Episode alerts → User: notifies
README.md - Discord presence → User: shows presence
README.md