How minhhaideveloper/telecloud works
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: App.jsx Player interface · music.js Library scanning · service.js Backup and restore · player.js Audio playback
Components 26
Desktop experience
- Player interface
src/App.jsx - Browse and search
src/components/SearchView.jsx - Track lists
src/components/SongList.jsx - Settings views
src/components/SettingsView.jsx
Music library
- Library scanning
electron/music.js - Folder watcher
electron/watcher.js - Metadata parsing
electron/tags.js - Library database
electron/database.js - Path validation
electron/paths.js
Playback and sound
- Audio playback
electron/player.js - Signal processing
electron/soundChain.js - DSD output
electron/dsd.js - ASIO device bridge
native/asio/tc-asio.cpp - EQ controls
src/components/EqSettingsView.jsx
TeleCloud sync
- Sync settings
src/components/TeleCloudSyncSettings.jsx - Backup and restore
electron/telecloud/service.js - Cloud index and cache
electron/telecloud/store.js - Telegram worker
electron/telecloud/worker.js - File encryption
electron/telecloud/crypto.js
Remote and enrichment
- Remote interface
src/remote/RemoteApp.jsx - Remote host API
electron/remote.js - Lyrics
electron/lyrics.js - Artwork
electron/covers.js
Other components
- Listener
- Telegram
- Audio device
Connections 27
- Listener → Player interface: uses
- Player interface → Browse and search: presents
src/App.jsx - Browse and search → Track lists: renders
src/components/SearchView.jsx - Player interface → Library scanning: requests library
- Folder watcher → Library scanning: triggers refresh
electron/main.js - Library scanning → Metadata parsing: parses tags
electron/music.js - Library scanning → Library database: updates index
electron/music.js - Library scanning → Path validation: checks paths
electron/music.js - Player interface → Audio playback: controls playback
- Audio playback → Signal processing: processes audio
electron/player.js - Audio playback → DSD output: handles DSD
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
electron/telecloud/service.js - Backup and restore → Telegram worker: dispatches transfers
electron/telecloud/service.js - Telegram worker → File encryption: encrypts files
electron/telecloud/worker.js - Telegram worker → Telegram: transfers music
- Backup and restore → Library database: syncs library state
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