How bit-wmike/fm1-companion works
FM-1 Companion is a desktop suite for managing and working with M-VAVE FM-1 devices. The main user journey runs from the desktop shell into device, backup, firmware, music, and Studio workflows; the Studio can also act as a virtual device for other work. The graph preserves those documented capabilities and central runtime modules. Some UI-to-domain links come from README descriptions; unsampled implementation details and uncertain wiring are omitted.
Main entry points: main_window.py Main window · backup.py Backups · studio.py Digital twin · app.py Desktop entry
Components 26
Desktop shell
- Desktop entry
fm1companion/app.py - Main window
fm1companion/ui/main_window.py - UI components
fm1companion/ui/common.py - Responsive layout
fm1companion/ui/responsive.py - Theme
fm1companion/ui/theme.py - Translations
fm1companion/i18n.py
Device and data
- Settings and paths
fm1companion/config.py - Device profiles
fm1companion/devices.py - Device protocol
fm1companion/protocol.py - Backups
fm1companion/backup.py - Backup browser
fm1companion/backup_inspect.py - SLOOP backup format
fm1companion/sloopbk.py
Firmware and recovery
- Firmware catalog
fm1companion/catalog.py - Firmware versions
fm1companion/firmware.py - Firmware families
fm1companion/fwfamily.py - Firmware installer
fm1companion/flash/engine.py - Recovery interface
fm1companion/ui/pages/recovery.py
Music and MIDI
- Projects
fm1companion/projects.py - MIDI tools
fm1companion/miditools.py
Studio and support
- Studio service
fm1companion/ui/studio_service.py - Digital twin
fm1companion/studio.py - Embedded editor
fm1companion/editor_host.py - Storage cleanup
fm1companion/storage.py - Storage settings
fm1companion/ui/storage_tab.py - System diagnostics
fm1companion/syscheck.py
Other components
- FM-1 user
Connections 33
- FM-1 user → Desktop entry: starts
- Desktop entry → Main window: opens
fm1companion/app.py - Desktop entry → Settings and paths: loads settings
fm1companion/app.py - Desktop entry → System diagnostics: runs checks
fm1companion/app.py - Main window → Backups: manages backups
- Main window → Firmware catalog: browses firmware
- Main window → Projects: opens projects
- Main window → Studio service: opens Studio
- Main window → Recovery interface: opens recovery
- Main window → Storage settings: opens settings
- Main window → MIDI tools: opens MIDI
- Device profiles → Settings and paths: reads profiles
fm1companion/devices.py - Backups → Device protocol: uses protocol
fm1companion/backup.py - Backups → SLOOP backup format: uses format
fm1companion/backup.py - Backups → Backup browser: uses inspection
fm1companion/backup.py - Firmware catalog → Firmware versions: resolves firmware
fm1companion/catalog.py - Firmware versions → Firmware families: classifies family
fm1companion/firmware.py - Firmware versions → Firmware installer: starts installation
fm1companion/firmware.py - Firmware versions → Digital twin: checks simulator
fm1companion/firmware.py - Recovery interface → Firmware installer: guides recovery
- Studio service → Digital twin: manages twin
fm1companion/ui/studio_service.py - Studio service → Backups: loads backup
fm1companion/ui/studio_service.py - Digital twin → Device protocol: uses protocol
fm1companion/studio.py - Digital twin → Device profiles: uses profiles
fm1companion/studio.py - Digital twin → Embedded editor: uses editor host
fm1companion/studio.py - Storage settings → Storage cleanup: scans and cleans
fm1companion/ui/storage_tab.py - Storage cleanup → Settings and paths: uses data paths
fm1companion/storage.py - System diagnostics → Device profiles: checks devices
fm1companion/syscheck.py - System diagnostics → Storage cleanup: checks storage
fm1companion/syscheck.py - UI components → Theme: uses theme
fm1companion/ui/common.py - Responsive layout → UI components: uses components
fm1companion/ui/responsive.py - Theme → Settings and paths: reads preferences
fm1companion/ui/theme.py - UI components → Translations: translates labels
fm1companion/ui/common.py