How solohomie/cloudsong works
CloudSong is a Qt/C++ desktop music player whose UI is currently mock-driven, with a working plugin-service/runtime path for MusicFree-compatible music operations. The principal flow is a QML request through PluginService, platform selection and dispatch into an isolated QuickJS worker, then a result signal back to the UI. The repository also includes recommendation, configuration, input-key utilities and taskbar controls. Plugin loading and QuickJS support are documented or indexed, but most implementation details were not excerpted; edges reflect only visible or documented relationships.
Main entry points: main.cpp App Bootstrap · pluginruntime.cpp Plugin Runtime · pluginservice.cpp Plugin Facade · pluginruntime_worker.h Runtime Worker
Components 18
App Services
- App Bootstrap
src/app/main.cpp - App Config
src/core/appconfig.cpp - Input Service
src/services/inputservice.cpp - Recommendations
src/services/recommendservice.cpp - Taskbar Controls
src/services/taskbarbarservice.cpp
Plugin Integration
- Plugin Facade
src/services/pluginservice.cpp - Plugin Runtime
src/services/pluginruntime.cpp - Runtime Worker
src/services/pluginruntime_worker.h - Music Plugins
plugins - Plugin Libraries
plugins/lib
QuickJS Engine
- QuickJS Engine
3rdparty/quickjs/quickjs.c - Regex Engine
3rdparty/quickjs/libregexp.c - Unicode Support
3rdparty/quickjs/libunicode.c - Number Conversion
3rdparty/quickjs/dtoa.c - C Utilities
3rdparty/quickjs/cutils.h
Other components
- QML UI
qml - Listener
- Web Services
Connections 15
- QML UI → Plugin Facade: requests methods
- Plugin Facade → Plugin Runtime: dispatches calls
src/services/pluginservice.cpp - Plugin Runtime → Runtime Worker: uses worker
src/services/pluginruntime.cpp - Runtime Worker → QuickJS Engine: executes with
src/services/pluginruntime_worker.h - Plugin Runtime → Music Plugins: loads plugins
- Plugin Runtime → Plugin Libraries: loads modules
- Plugin Facade → Web Services: downloads plugins
src/services/pluginservice.cpp - App Bootstrap → App Config: registers context
src/app/main.cpp - App Bootstrap → Input Service: registers context
src/app/main.cpp - App Bootstrap → Plugin Facade: registers context
src/app/main.cpp - App Bootstrap → Recommendations: registers context
src/app/main.cpp - App Bootstrap → Taskbar Controls: registers service
- Listener → QML UI: uses player
- Regex Engine → Unicode Support: uses Unicode
3rdparty/quickjs/libregexp.c - Number Conversion → C Utilities: uses utilities
3rdparty/quickjs/dtoa.c