How larson-logan/medal-sync works
Medal Sync is a Windows companion that gives Medal an SSD-backed recording drive while maintaining a persistent shared clip library and optional verified cloud copies. The main workflow is configure or join a library, launch Medal through Medal Sync, record while media is replicated, then verify the library and release ownership so another PC can take over. The README documents the storage modes and handoff; sampled source and the SOURCE INDEX support the session, configuration, library, and replication components. Some subsystem links are therefore documented rather than independently verified in source.
Main entry points: SessionCoordinator.cs Session coordinator · StorageReplication.cs Media replication · MedalSyncConfig.cs Configuration · LibraryDatabase.cs Medal library adapter
Components 18
Setup and commands
- CLI commands
tools/medal-sync/MedalSync/Cli/CommandRunner.cs - Configuration
tools/medal-sync/MedalSync/Config/MedalSyncConfig.cs
Recording session
- Session coordinator
tools/medal-sync/MedalSync/Session/SessionCoordinator.cs
Library and handoff
- Medal library adapter
tools/medal-sync/MedalSync/Library/LibraryDatabase.cs - Library snapshots
tools/medal-sync/MedalSync/Library/LibrarySnapshot.cs - Coordination store
tools/medal-sync/MedalSync/Coordination/CoordinationStore.cs - Ownership journal
tools/medal-sync/MedalSync/Coordination/Ownership.cs
Media storage
- Storage volumes
tools/medal-sync/MedalSync/Storage/StorageVolume.cs - Media replication
tools/medal-sync/MedalSync/Platform/StorageReplication.cs - SSD cache
- Primary storage
- rclone remotes
- Optional cloud copies
Windows interface
- Setup wizard
tools/medal-sync/MedalSync.Launch/WindowsConfigurationWizard.cs - Windows launcher
tools/medal-sync/MedalSync.Launch/Program.cs - Tray status
tools/medal-sync/MedalSync.Launch/WindowsTrayStatus.cs
Other components
- User
- Medal
Connections 20
- User → Setup wizard: configures
README.md - Setup wizard → Configuration: previews settings
README.md - User → Windows launcher: starts Medal
README.md - Windows launcher → Session coordinator: launches session
tools/medal-sync/MedalSync.Launch/Program.cs - CLI commands → Session coordinator: runs session commands
- Configuration → Session coordinator: configures
- Session coordinator → Coordination store: claims ownership
README.md - Coordination store → Ownership journal: tracks ownership
tools/medal-sync/MedalSync/Coordination/CoordinationStore.cs - Session coordinator → Medal: starts and supervises
README.md - Medal → SSD cache: records clips
README.md - SSD cache → Primary storage: uploads media
README.md - Media replication → rclone remotes: runs transfers
tools/medal-sync/MedalSync/Platform/StorageReplication.cs - rclone remotes → Primary storage: writes primary
- Media replication → Optional cloud copies: verifies copies
README.md - Session coordinator → Media replication: finishes uploads
README.md - Session coordinator → Medal library adapter: checks library
- Medal library adapter → Library snapshots: reads snapshot
tools/medal-sync/MedalSync/Library/LibraryDatabase.cs - Session coordinator → Ownership journal: releases when ready
README.md - Session coordinator → Tray status: reports readiness
README.md - Storage volumes → SSD cache: checks suitability