# minhhaideveloper/telecloud architecture

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

- Interactive diagram: https://gitdiagram.com/minhhaideveloper/telecloud
- Repository: https://github.com/minhhaideveloper/telecloud

## Overview

TeleCloud is a Windows hi-res music player with optional encrypted Telegram backup and streaming. The principal workflow is to add local music, scan and index its metadata, browse or search the library, play tracks through configurable audio processing to an output device, and optionally back up or stream tracks through Telegram. The graph preserves documented sound shaping, remote control, lyrics, and library presentation capabilities. Several modules are unsampled; their inclusion and documented links rely on the README and source index, not inspection of their implementations.

Main entry points: [`src/App.jsx`](https://github.com/minhhaideveloper/telecloud/blob/main/src/App.jsx) (Player interface), [`electron/music.js`](https://github.com/minhhaideveloper/telecloud/blob/main/electron/music.js) (Library scanning), [`electron/telecloud/service.js`](https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/service.js) (Backup and restore), [`electron/player.js`](https://github.com/minhhaideveloper/telecloud/blob/main/electron/player.js) (Audio playback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop experience"]
  node_appui["Player interface<br/>[App.jsx]"]
  node_browse["Browse and search<br/>[SearchView.jsx]"]
  node_songlist["Track lists<br/>[SongList.jsx]"]
  node_settings["Settings views<br/>[SettingsView.jsx]"]
end

subgraph group_library["Music library"]
  node_librarysvc["Library scanning<br/>[music.js]"]
  node_watcher["Folder watcher<br/>[watcher.js]"]
  node_tags["Metadata parsing<br/>[tags.js]"]
  node_db[("Library database<br/>[database.js]")]
  node_pathguard["Path validation<br/>[paths.js]"]
end

subgraph group_audio["Playback and sound"]
  node_player["Audio playback<br/>[player.js]"]
  node_soundchain["Signal processing<br/>[soundChain.js]"]
  node_dsd["DSD output<br/>[dsd.js]"]
  node_nativeasio["ASIO device bridge<br/>[tc-asio.cpp]"]
  node_eq["EQ controls<br/>[EqSettingsView.jsx]"]
end

subgraph group_cloud["TeleCloud sync"]
  node_teleui["Sync settings"]
  node_cloudsvc["Backup and restore<br/>[service.js]"]
  node_cloudstore[("Cloud index and cache<br/>[store.js]")]
  node_worker["Telegram worker<br/>[worker.js]"]
  node_crypto["File encryption<br/>[crypto.js]"]
end

subgraph group_extensions["Remote and enrichment"]
  node_remoteui["Remote interface<br/>[RemoteApp.jsx]"]
  node_remotehost["Remote host API<br/>[remote.js]"]
  node_lyrics["Lyrics<br/>[lyrics.js]"]
  node_covers["Artwork<br/>[covers.js]"]
end

node_listener(("Listener"))
node_telegram["Telegram"]
node_dac["Audio device"]

node_listener -->|"uses"| node_appui
node_appui -->|"presents"| node_browse
node_browse -->|"renders"| node_songlist
node_appui -->|"requests library"| node_librarysvc
node_watcher -->|"triggers refresh"| node_librarysvc
node_librarysvc -->|"parses tags"| node_tags
node_librarysvc -->|"updates index"| node_db
node_librarysvc -->|"checks paths"| node_pathguard
node_appui -->|"controls playback"| node_player
node_player -->|"processes audio"| node_soundchain
node_player -->|"handles DSD"| node_dsd
node_dsd -->|"uses driver bridge"| node_nativeasio
node_nativeasio -->|"outputs audio"| node_dac
node_settings -->|"opens sound controls"| node_eq
node_eq -.->|"configures effects"| node_soundchain
node_appui -->|"opens sync settings"| node_teleui
node_teleui -->|"configures backup"| node_cloudsvc
node_cloudsvc -->|"updates cloud state"| node_cloudstore
node_cloudsvc -->|"dispatches transfers"| node_worker
node_worker -->|"encrypts files"| node_crypto
node_worker -->|"transfers music"| node_telegram
node_cloudsvc -->|"syncs library state"| node_db
node_listener -->|"opens on Wi-Fi"| node_remoteui
node_remoteui -->|"sends controls"| node_remotehost
node_remotehost -.->|"controls playback"| node_player
node_appui -->|"shows lyrics"| node_lyrics
node_appui -->|"shows artwork"| node_covers

click node_appui "https://github.com/minhhaideveloper/telecloud/blob/main/src/App.jsx"
click node_browse "https://github.com/minhhaideveloper/telecloud/blob/main/src/components/SearchView.jsx"
click node_songlist "https://github.com/minhhaideveloper/telecloud/blob/main/src/components/SongList.jsx"
click node_settings "https://github.com/minhhaideveloper/telecloud/blob/main/src/components/SettingsView.jsx"
click node_librarysvc "https://github.com/minhhaideveloper/telecloud/blob/main/electron/music.js"
click node_watcher "https://github.com/minhhaideveloper/telecloud/blob/main/electron/watcher.js"
click node_tags "https://github.com/minhhaideveloper/telecloud/blob/main/electron/tags.js"
click node_db "https://github.com/minhhaideveloper/telecloud/blob/main/electron/database.js"
click node_pathguard "https://github.com/minhhaideveloper/telecloud/blob/main/electron/paths.js"
click node_player "https://github.com/minhhaideveloper/telecloud/blob/main/electron/player.js"
click node_soundchain "https://github.com/minhhaideveloper/telecloud/blob/main/electron/soundChain.js"
click node_dsd "https://github.com/minhhaideveloper/telecloud/blob/main/electron/dsd.js"
click node_nativeasio "https://github.com/minhhaideveloper/telecloud/blob/main/native/asio/tc-asio.cpp"
click node_eq "https://github.com/minhhaideveloper/telecloud/blob/main/src/components/EqSettingsView.jsx"
click node_teleui "https://github.com/minhhaideveloper/telecloud/blob/main/src/components/TeleCloudSyncSettings.jsx"
click node_cloudsvc "https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/service.js"
click node_cloudstore "https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/store.js"
click node_worker "https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/worker.js"
click node_crypto "https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/crypto.js"
click node_remoteui "https://github.com/minhhaideveloper/telecloud/blob/main/src/remote/RemoteApp.jsx"
click node_remotehost "https://github.com/minhhaideveloper/telecloud/blob/main/electron/remote.js"
click node_lyrics "https://github.com/minhhaideveloper/telecloud/blob/main/electron/lyrics.js"
click node_covers "https://github.com/minhhaideveloper/telecloud/blob/main/electron/covers.js"

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_appui,node_browse,node_songlist,node_settings toneBlue
class node_librarysvc,node_watcher,node_tags,node_db,node_pathguard toneAmber
class node_player,node_soundchain,node_dsd,node_nativeasio,node_eq toneMint
class node_teleui,node_cloudsvc,node_cloudstore,node_worker,node_crypto toneRose
class node_remoteui,node_remotehost,node_lyrics,node_covers,node_listener,node_telegram,node_dac toneIndigo
```

## Components

### Desktop experience

- [Player interface](https://github.com/minhhaideveloper/telecloud/blob/main/src/App.jsx): `src/App.jsx`
- [Browse and search](https://github.com/minhhaideveloper/telecloud/blob/main/src/components/SearchView.jsx): `src/components/SearchView.jsx`
- [Track lists](https://github.com/minhhaideveloper/telecloud/blob/main/src/components/SongList.jsx): `src/components/SongList.jsx`
- [Settings views](https://github.com/minhhaideveloper/telecloud/blob/main/src/components/SettingsView.jsx): `src/components/SettingsView.jsx`

### Music library

- [Library scanning](https://github.com/minhhaideveloper/telecloud/blob/main/electron/music.js): `electron/music.js`
- [Folder watcher](https://github.com/minhhaideveloper/telecloud/blob/main/electron/watcher.js): `electron/watcher.js`
- [Metadata parsing](https://github.com/minhhaideveloper/telecloud/blob/main/electron/tags.js): `electron/tags.js`
- [Library database](https://github.com/minhhaideveloper/telecloud/blob/main/electron/database.js): `electron/database.js`
- [Path validation](https://github.com/minhhaideveloper/telecloud/blob/main/electron/paths.js): `electron/paths.js`

### Playback and sound

- [Audio playback](https://github.com/minhhaideveloper/telecloud/blob/main/electron/player.js): `electron/player.js`
- [Signal processing](https://github.com/minhhaideveloper/telecloud/blob/main/electron/soundChain.js): `electron/soundChain.js`
- [DSD output](https://github.com/minhhaideveloper/telecloud/blob/main/electron/dsd.js): `electron/dsd.js`
- [ASIO device bridge](https://github.com/minhhaideveloper/telecloud/blob/main/native/asio/tc-asio.cpp): `native/asio/tc-asio.cpp`
- [EQ controls](https://github.com/minhhaideveloper/telecloud/blob/main/src/components/EqSettingsView.jsx): `src/components/EqSettingsView.jsx`

### TeleCloud sync

- [Sync settings](https://github.com/minhhaideveloper/telecloud/blob/main/src/components/TeleCloudSyncSettings.jsx): `src/components/TeleCloudSyncSettings.jsx`
- [Backup and restore](https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/service.js): `electron/telecloud/service.js`
- [Cloud index and cache](https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/store.js): `electron/telecloud/store.js`
- [Telegram worker](https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/worker.js): `electron/telecloud/worker.js`
- [File encryption](https://github.com/minhhaideveloper/telecloud/blob/main/electron/telecloud/crypto.js): `electron/telecloud/crypto.js`

### Remote and enrichment

- [Remote interface](https://github.com/minhhaideveloper/telecloud/blob/main/src/remote/RemoteApp.jsx): `src/remote/RemoteApp.jsx`
- [Remote host API](https://github.com/minhhaideveloper/telecloud/blob/main/electron/remote.js): `electron/remote.js`
- [Lyrics](https://github.com/minhhaideveloper/telecloud/blob/main/electron/lyrics.js): `electron/lyrics.js`
- [Artwork](https://github.com/minhhaideveloper/telecloud/blob/main/electron/covers.js): `electron/covers.js`

### Other components

- **Listener**
- **Telegram**
- **Audio device**

## Connections

- Listener → Player interface: uses
- Player interface → Browse and search: presents (evidence: `src/App.jsx`)
- Browse and search → Track lists: renders (evidence: `src/components/SearchView.jsx`)
- Player interface → Library scanning: requests library
- Folder watcher → Library scanning: triggers refresh (evidence: `electron/main.js`)
- Library scanning → Metadata parsing: parses tags (evidence: `electron/music.js`)
- Library scanning → Library database: updates index (evidence: `electron/music.js`)
- Library scanning → Path validation: checks paths (evidence: `electron/music.js`)
- Player interface → Audio playback: controls playback
- Audio playback → Signal processing: processes audio (evidence: `electron/player.js`)
- Audio playback → DSD output: handles DSD (evidence: `electron/player.js`)
- DSD output → ASIO device bridge: uses driver bridge
- ASIO device bridge → Audio device: outputs audio
- Settings views → EQ controls: opens sound controls
- EQ controls → Signal processing: configures effects
- Player interface → Sync settings: opens sync settings
- Sync settings → Backup and restore: configures backup
- Backup and restore → Cloud index and cache: updates cloud state (evidence: `electron/telecloud/service.js`)
- Backup and restore → Telegram worker: dispatches transfers (evidence: `electron/telecloud/service.js`)
- Telegram worker → File encryption: encrypts files (evidence: `electron/telecloud/worker.js`)
- Telegram worker → Telegram: transfers music
- Backup and restore → Library database: syncs library state (evidence: `electron/telecloud/service.js`)
- Listener → Remote interface: opens on Wi-Fi
- Remote interface → Remote host API: sends controls
- Remote host API → Audio playback: controls playback
- Player interface → Lyrics: shows lyrics
- Player interface → Artwork: shows artwork
