How minlor/lumisync works
LumiSync is a desktop smart-device controller and ambient-light synchronization app. Users discover or link devices, inspect capabilities, control supported features, and optionally run screen- or music-driven lighting; local and cloud transports provide distinct device paths. The graph also includes account authorization and plug-energy reporting, plus the synchronization processing layer. Relationships are limited to README statements and source-index references; several UI and integration details are unsampled, so their internal links are not inferred.
Main entry points: device_controller.py Device management · registry.py Driver selection · main_window.py Main window · sync_controller.py Sync controls
Components 28
Desktop app
- Main window
lumisync/gui/main_window.py - Device management
lumisync/gui/controllers/device_controller.py - Sync controls
lumisync/gui/controllers/sync_controller.py - Account dialog
lumisync/gui/dialogs/accounts_dialog.py - Logging
lumisync/utils/logging.py
Devices and accounts
- Account sessions
lumisync/accounts/manager.py - Govee accounts
lumisync/accounts/govee.py - Tuya accounts
lumisync/accounts/tuya.py - Energy history
lumisync/accounts/tuya_energy.py - LAN discovery
lumisync/connection.py - Device inventory
lumisync/devices.py - Runtime settings
lumisync/config/options.py
Light synchronization
- LED mapping
lumisync/led_mapping.py - Monitor sync
lumisync/sync/monitor.py - Music sync
lumisync/sync/music.py - Audio analysis
lumisync/sync/audio.py - Color processing
lumisync/sync/processing.py - Color utilities
lumisync/utils/colors.py
Device transports
- Driver pool
lumisync/drivers/pool.py - Driver selection
lumisync/drivers/registry.py - Transport interface
lumisync/drivers/base.py - LAN drivers
lumisync/drivers/govee_lan.py - Bluetooth driver
lumisync/drivers/idotmatrix_ble.py - Cloud driver
lumisync/drivers/cloud.py - Tuya LAN driver
lumisync/drivers/tuya_lan.py
Other components
- User
- Smart devices
- Audio input
Connections 32
- User → Main window: uses
README.md - Main window → Device management: connects
lumisync/gui/main_window.py - Main window → Sync controls: connects
lumisync/gui/main_window.py - Main window → Account dialog: opens
README.md - Device management → LAN discovery: discovers
lumisync/gui/controllers/device_controller.py - Device management → Device inventory: merges devices
lumisync/gui/controllers/device_controller.py - Device management → Driver pool: controls through
lumisync/gui/controllers/device_controller.py - Account dialog → Account sessions: manages sessions
lumisync/gui/dialogs/accounts_dialog.py - Account sessions → Govee accounts: creates clients
lumisync/accounts/manager.py - Account sessions → Tuya accounts: creates clients
lumisync/accounts/manager.py - Tuya accounts → Energy history: loads readings
lumisync/accounts/tuya.py - Device management → Account sessions: refreshes accounts
lumisync/gui/controllers/device_controller.py - Sync controls → Monitor sync: runs
lumisync/gui/controllers/sync_controller.py - Sync controls → Music sync: runs
lumisync/gui/controllers/sync_controller.py - Sync controls → Driver pool: sends output via
lumisync/gui/controllers/sync_controller.py - Monitor sync → LED mapping: maps display regions
lumisync/sync/monitor.py - Monitor sync → Color processing: processes frames
lumisync/sync/monitor.py - Music sync → Audio analysis: analyzes audio
lumisync/sync/music.py - Music sync → Color processing: processes frames
lumisync/sync/music.py - Music sync → LED mapping: uses layouts
- Audio input → Audio analysis: provides samples
- Driver pool → Driver selection: selects drivers
lumisync/drivers/pool.py - Driver selection → Transport interface: implements interface
lumisync/drivers/registry.py - Driver selection → LAN drivers: selects
lumisync/drivers/registry.py - Driver selection → Bluetooth driver: selects
lumisync/drivers/registry.py - Driver selection → Cloud driver: selects
lumisync/drivers/registry.py - Driver selection → Tuya LAN driver: selects
lumisync/drivers/registry.py - Driver pool → Smart devices: commands
- Device management → Runtime settings: uses configuration
lumisync/gui/controllers/device_controller.py - Sync controls → Runtime settings: reads tunables
lumisync/gui/controllers/sync_controller.py - Color processing → Color utilities: uses color helpers
- Main window → Logging: logs activity
lumisync/gui/main_window.py