How yuki-jp/wavesync works
WaveSync is a desktop multicamera audio/video synchronizer that exports an FCP XML timeline for Premiere. The main workflow is selecting reference audio and camera videos, synchronizing them, saving the XML, and importing it into Premiere. The graph also shows configuration, DSP and evidence validation, audit/layout reporting, diagnostics, and the documented update check. Some internal links are based on the SOURCE INDEX and README; unsampled implementation details are not inferred beyond those relationships.
Main entry points: main.py Sync Engine · WaveSync.py WaveSync UI · audio_processor.py Audio DSP · sync_evidence.py Sync Evidence
Components 14
Desktop Interface
- WaveSync UI
WaveSync.py - Config Builder
tools/make_config.py
Synchronization
- Sync Engine
main.py - Audio DSP
backend/audio_processor.py - Sync Evidence
backend/sync_evidence.py
Timeline and Reports
- Premiere XML
backend/xml_generator.py - Sync Audit
backend/audit_report.py - Audio Layout Report
backend/audio_layout_report.py
Support and Updates
- Diagnostic Package and Upload
backend/diagnostics.py
Other components
- User
- Local Outputs and Cache
- Adobe Premiere
- Support Relay
- GitHub Version Check
Connections 17
- User → WaveSync UI: selects media
README.md - WaveSync UI → Config Builder: builds selection config
WaveSync.py - WaveSync UI → Sync Engine: starts sync
WaveSync.py - Sync Engine → Audio DSP: extracts and correlates audio
main.py - Sync Engine → Sync Evidence: validates placements
main.py - Sync Evidence → Audio DSP: decodes samples
backend/sync_evidence.py - Sync Engine → Premiere XML: generates timeline
main.py - Sync Engine → Sync Audit: creates audit reports
main.py - Sync Engine → Audio Layout Report: creates layout report
main.py - Audio DSP → Local Outputs and Cache: caches WAV and features
backend/audio_processor.py - Premiere XML → Local Outputs and Cache: writes XML
README.md - Sync Audit → Local Outputs and Cache: writes audit files
README.md - Audio Layout Report → Local Outputs and Cache: writes layout reports
- User → Adobe Premiere: imports XML
README.md - WaveSync UI → Diagnostic Package and Upload: creates and sends package
WaveSync.py - Diagnostic Package and Upload → Support Relay: uploads package
README.md - WaveSync UI → GitHub Version Check: checks for updates
README.md