# arnoldhao/xiadown architecture

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

- Interactive diagram: https://gitdiagram.com/arnoldhao/xiadown
- Repository: https://github.com/arnoldhao/xiadown

## Overview

XiaDown is a local-first desktop media library and download application, also offering sniff-based downloads, YouTube and YouTube Music clients, and RSS subscriptions. The principal user journey is entering the desktop workspace, choosing a media capability, and browsing or managing media; library management additionally covers downloads, transcoding, and storage roots. The tree shows distinct UI and service areas, but sampled source does not establish most frontend-to-backend wiring, so the graph keeps those relationships out rather than inferring calls.

Main entry points: [`frontend/src/App.tsx`](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/App.tsx) (Application entry), [`frontend/src/app/library/LibraryWorkspacePage.tsx`](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/library/LibraryWorkspacePage.tsx) (Resource library), [`frontend/src/app/main/listen/PageView.tsx`](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/main/listen/PageView.tsx) (Music workspace), [`frontend/src/app/youtube/YouTubeWorkspacePage.tsx`](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/youtube/YouTubeWorkspacePage.tsx) (YouTube workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Desktop workspace"]
  node_app["Application entry<br/>[App.tsx]"]
  node_workspace["Workspace shell<br/>[AppShell.tsx]"]
  node_settings["Settings<br/>[SettingsApp.tsx]"]
end

subgraph group_library["Library management"]
  node_library_ui["Resource library"]
  node_storage_roots["Storage roots"]
  node_storage_emoji["Root emoji picker"]
  node_library_service["Catalog service<br/>[catalog_service.go]"]
end

subgraph group_media["Media clients"]
  node_music["Music workspace<br/>[PageView.tsx]"]
  node_music_client["Music client<br/>[client.go]"]
  node_playback["Local playback<br/>[service_queue.go]"]
  node_youtube["YouTube workspace"]
  node_youtube_client["YouTube workspace client"]
end

subgraph group_discovery["Discovery and feeds"]
  node_sniff["Media sniffing<br/>[SniffDeskPage.tsx]"]
  node_rss["RSS workspace"]
  node_rss_organization["Feed organization"]
end

subgraph group_services["Application services"]
  node_rss_service["RSS service<br/>[service.go]"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_app
node_app -->|"offers library"| node_library_ui
node_app -->|"offers sniffing"| node_sniff
node_app -->|"offers music"| node_music
node_app -->|"offers YouTube"| node_youtube
node_app -->|"offers RSS"| node_rss

click node_app "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/App.tsx"
click node_workspace "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/workspace/AppShell.tsx"
click node_library_ui "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/library/LibraryWorkspacePage.tsx"
click node_storage_roots "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/library/CatalogStorageSurfaces.tsx"
click node_storage_emoji "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/library/CatalogStorageRootEmojiPicker.tsx"
click node_library_service "https://github.com/arnoldhao/xiadown/blob/main/internal/application/library/service/catalog_service.go"
click node_sniff "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/sniff-desk/SniffDeskPage.tsx"
click node_music "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/main/listen/PageView.tsx"
click node_music_client "https://github.com/arnoldhao/xiadown/blob/main/internal/application/youtubemusic/client.go"
click node_playback "https://github.com/arnoldhao/xiadown/blob/main/internal/application/listenplayback/service_queue.go"
click node_youtube "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/youtube/YouTubeWorkspacePage.tsx"
click node_youtube_client "https://github.com/arnoldhao/xiadown/blob/main/internal/application/youtubeworkspace/innertube_client.go"
click node_rss "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/rss/RSSWorkspacePage.tsx"
click node_rss_organization "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/rss/RSSOrganizationManager.tsx"
click node_rss_service "https://github.com/arnoldhao/xiadown/blob/main/internal/application/rss/service.go"
click node_settings "https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/settings/SettingsApp.tsx"

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_workspace,node_settings,node_user toneBlue
class node_library_ui,node_storage_roots,node_storage_emoji,node_library_service toneAmber
class node_music,node_music_client,node_playback,node_youtube,node_youtube_client toneMint
class node_sniff,node_rss,node_rss_organization toneRose
class node_rss_service toneIndigo
```

## Components

### Desktop workspace

- [Application entry](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Workspace shell](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/workspace/AppShell.tsx): `frontend/src/app/workspace/AppShell.tsx`
- [Settings](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/settings/SettingsApp.tsx): `frontend/src/app/settings/SettingsApp.tsx`

### Library management

- [Resource library](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/library/LibraryWorkspacePage.tsx): `frontend/src/app/library/LibraryWorkspacePage.tsx`
- [Storage roots](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/library/CatalogStorageSurfaces.tsx): `frontend/src/app/library/CatalogStorageSurfaces.tsx`
- [Root emoji picker](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/library/CatalogStorageRootEmojiPicker.tsx): `frontend/src/app/library/CatalogStorageRootEmojiPicker.tsx`
- [Catalog service](https://github.com/arnoldhao/xiadown/blob/main/internal/application/library/service/catalog_service.go): `internal/application/library/service/catalog_service.go`

### Media clients

- [Music workspace](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/main/listen/PageView.tsx): `frontend/src/app/main/listen/PageView.tsx`
- [Music client](https://github.com/arnoldhao/xiadown/blob/main/internal/application/youtubemusic/client.go): `internal/application/youtubemusic/client.go`
- [Local playback](https://github.com/arnoldhao/xiadown/blob/main/internal/application/listenplayback/service_queue.go): `internal/application/listenplayback/service_queue.go`
- [YouTube workspace](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/youtube/YouTubeWorkspacePage.tsx): `frontend/src/app/youtube/YouTubeWorkspacePage.tsx`
- [YouTube workspace client](https://github.com/arnoldhao/xiadown/blob/main/internal/application/youtubeworkspace/innertube_client.go): `internal/application/youtubeworkspace/innertube_client.go`

### Discovery and feeds

- [Media sniffing](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/sniff-desk/SniffDeskPage.tsx): `frontend/src/app/sniff-desk/SniffDeskPage.tsx`
- [RSS workspace](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/rss/RSSWorkspacePage.tsx): `frontend/src/app/rss/RSSWorkspacePage.tsx`
- [Feed organization](https://github.com/arnoldhao/xiadown/blob/main/frontend/src/app/rss/RSSOrganizationManager.tsx): `frontend/src/app/rss/RSSOrganizationManager.tsx`

### Application services

- [RSS service](https://github.com/arnoldhao/xiadown/blob/main/internal/application/rss/service.go): `internal/application/rss/service.go`

### Other components

- **Desktop user**

## Connections

- Desktop user → Application entry: uses (evidence: `README.md`)
- Application entry → Resource library: offers library (evidence: `README.md`)
- Application entry → Media sniffing: offers sniffing (evidence: `README.md`)
- Application entry → Music workspace: offers music (evidence: `README.md`)
- Application entry → YouTube workspace: offers YouTube (evidence: `README.md`)
- Application entry → RSS workspace: offers RSS (evidence: `README.md`)
