How xokeza/yamusicmod works
LLMusic-mod extends the installed Yandex Music desktop client. The main workflow starts with the Electron process initializing settings and the app window, then connects renderer events to added playback and account features; users experience those features through the client and the separate mini-player. The graph also preserves README-documented capabilities whose implementation files were not sampled. Those links are documented behavior, not claims that unsampled call paths were inspected.
Main entry points: index.js Electron Startup · events.js Renderer IPC · store.js Settings Store · YandexStationService.js Yandex Station Service
Components 32
Desktop Runtime
- Electron Startup
src/main/index.js - Renderer IPC
src/main/events.js - Settings Store
src/main/lib/store.js - Background Tasks
src/main/lib/handlers/handleBackgroundTasks.js - App Configuration
src/main/config.js
Playback Extensions
- Yandex Station
src/main/lib/yandexStation/YandexStationService.js - Station Authentication
src/main/lib/yandexStation/YandexAuthClient.js - Remote Playback
src/main/events.js - WASAPI Exclusive
native/wasapiExclusive/js/stream-session.js - Native Audio Output
src/main/lib/nativeAudioOutput.js - Yandex Station Service
src/main/lib/yandexStation/YandexStationService.js
Account Integrations
- Last.fm Scrobbling
src/main/lib/scrobble/ScrobblerManager.js - Discord Status
src/main/events.js - LRCLib Lyrics
src/main/lib/handlers/handleHeadersReceived/corsHandler.js
Player Interface
- Mini-player Window
src/main/lib/miniplayer/miniplayer.js - Mini-player UI
miniplayer/src/App.jsx - Player State Bridge
miniplayer/src/contexts/PlayerContext.jsx - Taskbar Controls
src/main/lib/taskBarExtension/taskBarExtension.js - Global Shortcuts
src/main/events.js - Taskbar Thumbnail
native/setIconicThumbnail/js/index.js
Client Support
- Logging
src/main/packages/logger/Logger.js - Request CORS
src/main/lib/handlers/handleHeadersReceived/corsHandler.js - PulseSync Add-ons
src/main/lib/pulsesync/PulseSyncManager.js - Track Downloads
src/main/lib/trackDownloader/trackDownloader.js - Download Pipeline
src/main/lib/trackDownloader/pipelineStage.js - Custom Cache Path
src/main/index.js - Usage Metrics
src/main/lib/metrics.js
Other components
- Listener
- Last.fm
- Discord
- Yandex Station Device
- LRCLib
Connections 36
- Listener → Electron Startup: starts client
README.md - Electron Startup → Settings Store: initializes
src/main/index.js - Electron Startup → Mini-player Window: loads
src/main/index.js - Electron Startup → Background Tasks: starts tasks
src/main/index.js - Electron Startup → Renderer IPC: loads handlers
src/main/index.js - Electron Startup → App Configuration: reads config
src/main/index.js - Electron Startup → Usage Metrics: initializes metrics
src/main/index.js - Background Tasks → Renderer IPC: requests refresh
src/main/lib/handlers/handleBackgroundTasks.js - Renderer IPC → Settings Store: reads and writes
src/main/events.js - Settings Store → Renderer IPC: sends updates
src/main/lib/store.js - Mini-player Window → Mini-player UI: opens window
- Mini-player UI → Player State Bridge: uses context
miniplayer/src/App.jsx - Player State Bridge → Mini-player Window: requests state
- Electron Startup → PulseSync Add-ons: loads add-ons
- PulseSync Add-ons → Settings Store: reads settings
src/main/lib/pulsesync/PulseSyncManager.js - PulseSync Add-ons → Request CORS: uses CORS handler
src/main/lib/pulsesync/PulseSyncManager.js - Electron Startup → Yandex Station Service: starts service
- Yandex Station Service → Station Authentication: authenticates
- Yandex Station Service → Yandex Station Device: streams playback
README.md - Listener → Remote Playback: controls playback
README.md - Remote Playback → Renderer IPC: dispatches controls
src/main/events.js - Electron Startup → Native Audio Output: loads output
src/main/index.js - Native Audio Output → WASAPI Exclusive: uses backend
- Electron Startup → Last.fm Scrobbling: loads integration
- Last.fm Scrobbling → Last.fm: submits scrobbles
README.md - Renderer IPC → Discord Status: updates status
README.md - Discord Status → Discord: publishes status
README.md - Renderer IPC → Track Downloads: manages downloads
src/main/events.js - Track Downloads → Download Pipeline: uses pipeline
- Electron Startup → Taskbar Controls: loads controls
src/main/index.js - Electron Startup → Custom Cache Path: sets storage path
src/main/index.js - Renderer IPC → Global Shortcuts: registers shortcuts
README.md - Request CORS → LRCLib: allows requests
src/main/lib/handlers/handleHeadersReceived/corsHandler.js - Listener → LRCLib Lyrics: views lyrics
README.md - Electron Startup → Taskbar Thumbnail: loads thumbnail
- Renderer IPC → Taskbar Controls: updates controls
src/main/events.js