# junxiangzhan/pear-desktop architecture

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

- Interactive diagram: https://gitdiagram.com/junxiangzhan/pear-desktop
- Repository: https://github.com/junxiangzhan/pear-desktop

## Overview

Pear Tauri is a desktop and Android YouTube Music client: Tauri’s Rust shell hosts the music.youtube.com page, injects the page-side renderer and plugins, and routes native controls and configuration through IPC. Android can use GeckoView and a Rust bridge; its optional Pear mobile UI supplies its own navigation, library and playback experience. The graph includes documented plugin capabilities and sampled core modules. Some plugin and native relationships are documented only broadly or were not sampled, so those links are omitted or marked unverified.

Main entry points: [`src-tauri/src/lib.rs`](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/lib.rs) (Tauri application), [`src/renderer.ts`](https://github.com/junxiangzhan/pear-desktop/blob/master/src/renderer.ts) (Page renderer), [`src/plugins`](https://github.com/junxiangzhan/pear-desktop/tree/master/src/plugins) (Playback extensions), [`src/platform/tauri.ts`](https://github.com/junxiangzhan/pear-desktop/blob/master/src/platform/tauri.ts) (Tauri platform API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Native shell"]
  node_shell["Tauri application<br/>[lib.rs]"]
  node_config[("Configuration<br/>[config.rs]")]
  node_nativeipc["Native IPC<br/>[ipc.rs]"]
  node_controls["App controls<br/>[app_controls.rs]"]
  node_menu["Native menu<br/>[mod.rs]"]
  node_android["Android playback<br/>[PlaybackService.kt]"]
  node_gecko["Gecko bridge<br/>[gecko_bridge.rs]"]
end

subgraph group_page["Page runtime"]
  node_platform["Tauri platform API<br/>[tauri.ts]"]
  node_renderer["Page renderer<br/>[renderer.ts]"]
  node_loader["Renderer loader<br/>[renderer.ts]"]
  node_songinfo["Song information<br/>[song-info-front.ts]"]
  node_pluginrun["Plugin runtime<br/>[index.ts]"]
  node_configweb["Config mirror<br/>[store.ts]"]
end

subgraph group_mobile["Mobile experience"]
  node_mobileui["Mobile UI<br/>[App.tsx]"]
  node_router["Mobile navigation<br/>[router.ts]"]
  node_engine["Mobile playback engine<br/>[index.ts]"]
  node_queue["Playback queue<br/>[queue.ts]"]
end

subgraph group_plugins["Extensions and playback"]
  node_downloader["Downloads<br/>[index.ts]"]
  node_collab["Music Together<br/>[index.ts]"]
  node_lyrics["Synced lyrics<br/>[index.ts]"]
  node_extensions["Playback extensions"]
end

node_user(("Listener"))
node_ytm["YouTube Music"]

node_user -->|"launches"| node_shell
node_shell -->|"hosts page"| node_ytm
node_shell -->|"injects renderer"| node_loader
node_loader -->|"loads"| node_renderer
node_renderer -->|"reads player state"| node_songinfo
node_renderer -.->|"runs plugins"| node_pluginrun
node_renderer -.->|"uses platform API"| node_platform
node_platform -.->|"invokes commands"| node_nativeipc
node_platform -->|"bridges Android IPC"| node_gecko
node_shell -->|"loads config"| node_config
node_config -->|"broadcasts updates"| node_configweb
node_nativeipc -.->|"dispatches controls"| node_controls
node_controls -.->|"routes playback"| node_android
node_android -.->|"sends actions"| node_gecko
node_user -->|"uses mobile UI"| node_mobileui
node_mobileui -->|"navigates with"| node_router
node_mobileui -->|"uses playback engine"| node_engine
node_engine -->|"reads queue"| node_queue
node_user -.->|"enables features"| node_extensions
node_extensions -.->|"includes downloads"| node_downloader
node_extensions -.->|"includes shared listening"| node_collab
node_extensions -.->|"includes lyrics"| node_lyrics
node_pluginrun -.->|"plugin menus"| node_menu

click node_shell "https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/lib.rs"
click node_config "https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/config.rs"
click node_nativeipc "https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/ipc.rs"
click node_controls "https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/app_controls.rs"
click node_menu "https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/menu/mod.rs"
click node_android "https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/gen/android/app/src/main/java/io/github/junxiangzhan/peartauri/PlaybackService.kt"
click node_gecko "https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/gecko_bridge.rs"
click node_platform "https://github.com/junxiangzhan/pear-desktop/blob/master/src/platform/tauri.ts"
click node_renderer "https://github.com/junxiangzhan/pear-desktop/blob/master/src/renderer.ts"
click node_loader "https://github.com/junxiangzhan/pear-desktop/blob/master/src/loader/renderer.ts"
click node_songinfo "https://github.com/junxiangzhan/pear-desktop/blob/master/src/providers/song-info-front.ts"
click node_pluginrun "https://github.com/junxiangzhan/pear-desktop/blob/master/src/utils/index.ts"
click node_configweb "https://github.com/junxiangzhan/pear-desktop/blob/master/src/config/store.ts"
click node_mobileui "https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/ui/App.tsx"
click node_router "https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/ui/router.ts"
click node_engine "https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/engine/index.ts"
click node_queue "https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/engine/queue.ts"
click node_downloader "https://github.com/junxiangzhan/pear-desktop/blob/master/src/plugins/downloader/index.ts"
click node_collab "https://github.com/junxiangzhan/pear-desktop/blob/master/src/plugins/music-together/index.ts"
click node_lyrics "https://github.com/junxiangzhan/pear-desktop/blob/master/src/plugins/synced-lyrics/index.ts"
click node_extensions "https://github.com/junxiangzhan/pear-desktop/tree/master/src/plugins"

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_shell,node_config,node_nativeipc,node_controls,node_menu,node_android,node_gecko toneBlue
class node_platform,node_renderer,node_loader,node_songinfo,node_pluginrun,node_configweb toneAmber
class node_mobileui,node_router,node_engine,node_queue toneMint
class node_downloader,node_collab,node_lyrics,node_extensions toneRose
class node_user,node_ytm toneIndigo
```

## Components

### Native shell

- [Tauri application](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Configuration](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/config.rs): `src-tauri/src/config.rs`
- [Native IPC](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/ipc.rs): `src-tauri/src/ipc.rs`
- [App controls](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/app_controls.rs): `src-tauri/src/app_controls.rs`
- [Native menu](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/menu/mod.rs): `src-tauri/src/menu/mod.rs`
- [Android playback](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/gen/android/app/src/main/java/io/github/junxiangzhan/peartauri/PlaybackService.kt): `src-tauri/gen/android/app/src/main/java/io/github/junxiangzhan/peartauri/PlaybackService.kt`
- [Gecko bridge](https://github.com/junxiangzhan/pear-desktop/blob/master/src-tauri/src/gecko_bridge.rs): `src-tauri/src/gecko_bridge.rs`

### Page runtime

- [Tauri platform API](https://github.com/junxiangzhan/pear-desktop/blob/master/src/platform/tauri.ts): `src/platform/tauri.ts`
- [Page renderer](https://github.com/junxiangzhan/pear-desktop/blob/master/src/renderer.ts): `src/renderer.ts`
- [Renderer loader](https://github.com/junxiangzhan/pear-desktop/blob/master/src/loader/renderer.ts): `src/loader/renderer.ts`
- [Song information](https://github.com/junxiangzhan/pear-desktop/blob/master/src/providers/song-info-front.ts): `src/providers/song-info-front.ts`
- [Plugin runtime](https://github.com/junxiangzhan/pear-desktop/blob/master/src/utils/index.ts): `src/utils/index.ts`
- [Config mirror](https://github.com/junxiangzhan/pear-desktop/blob/master/src/config/store.ts): `src/config/store.ts`

### Mobile experience

- [Mobile UI](https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/ui/App.tsx): `src/mobile-ui/ui/App.tsx`
- [Mobile navigation](https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/ui/router.ts): `src/mobile-ui/ui/router.ts`
- [Mobile playback engine](https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/engine/index.ts): `src/mobile-ui/engine/index.ts`
- [Playback queue](https://github.com/junxiangzhan/pear-desktop/blob/master/src/mobile-ui/engine/queue.ts): `src/mobile-ui/engine/queue.ts`

### Extensions and playback

- [Downloads](https://github.com/junxiangzhan/pear-desktop/blob/master/src/plugins/downloader/index.ts): `src/plugins/downloader/index.ts`
- [Music Together](https://github.com/junxiangzhan/pear-desktop/blob/master/src/plugins/music-together/index.ts): `src/plugins/music-together/index.ts`
- [Synced lyrics](https://github.com/junxiangzhan/pear-desktop/blob/master/src/plugins/synced-lyrics/index.ts): `src/plugins/synced-lyrics/index.ts`
- [Playback extensions](https://github.com/junxiangzhan/pear-desktop/tree/master/src/plugins): `src/plugins`

### Other components

- **Listener**
- **YouTube Music**

## Connections

- Listener → Tauri application: launches
- Tauri application → YouTube Music: hosts page
- Tauri application → Renderer loader: injects renderer
- Renderer loader → Page renderer: loads (evidence: `src/loader/renderer.ts`)
- Page renderer → Song information: reads player state (evidence: `src/renderer.ts`)
- Page renderer → Plugin runtime: runs plugins
- Page renderer → Tauri platform API: uses platform API
- Tauri platform API → Native IPC: invokes commands
- Tauri platform API → Gecko bridge: bridges Android IPC (evidence: `src/platform/tauri.ts`)
- Tauri application → Configuration: loads config (evidence: `src-tauri/src/lib.rs`)
- Configuration → Config mirror: broadcasts updates (evidence: `src-tauri/src/config.rs`)
- Native IPC → App controls: dispatches controls (evidence: `src-tauri/src/app_controls.rs`)
- App controls → Android playback: routes playback
- Android playback → Gecko bridge: sends actions
- Listener → Mobile UI: uses mobile UI
- Mobile UI → Mobile navigation: navigates with (evidence: `src/mobile-ui/ui/App.tsx`)
- Mobile UI → Mobile playback engine: uses playback engine (evidence: `src/mobile-ui/ui/App.tsx`)
- Mobile playback engine → Playback queue: reads queue (evidence: `src/mobile-ui/engine/index.ts`)
- Listener → Playback extensions: enables features
- Playback extensions → Downloads: includes downloads
- Playback extensions → Music Together: includes shared listening
- Playback extensions → Synced lyrics: includes lyrics
- Plugin runtime → Native menu: plugin menus
