How roadsearch/motionflow works
MotionFlow is an Android video editor. Users assemble and animate clips on a multi-track timeline, preview the composition, save project state, then request a validated background export. Media3 is the primary playback/export path; advanced FFmpeg rendering is optional. The graph preserves documented rendering and editing capabilities, but some connections to unsampled render-planning and effects modules are left unlinked because their call sites were not shown.
Main entry points: VideoExportWorker.kt Export worker · EditorViewModel.kt Editor state · MediaEngine.kt Media engine · EditorScreen.kt Editor screen
Components 25
Editing
- Editor screen
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt - Editor state
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt - Timeline controls
app/src/main/java/com/roadsearch/openeditvideo/ui/Timeline.kt - Timeline operations
app/src/main/java/com/roadsearch/openeditvideo/core/editor/TimelineEditor.kt - Timeline math
app/src/main/java/com/roadsearch/openeditvideo/core/TimelineMath.kt - Editor models
app/src/main/java/com/roadsearch/openeditvideo/model/EditorModels.kt - Animation model
app/src/main/java/com/roadsearch/openeditvideo/model/Animation.kt
Preview and effects
- Media engine
app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt - Multi-track composition
app/src/main/java/com/roadsearch/openeditvideo/media/MultiTrackCompositionFactory.kt - Composition preview
app/src/main/java/com/roadsearch/openeditvideo/media/CompositionPreviewController.kt - Media effects
app/src/main/java/com/roadsearch/openeditvideo/media/AdvancedEffects.kt - Render planning
app/src/main/java/com/roadsearch/openeditvideo/render/RenderPlannerV2.kt
Project storage
- Project repository
app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt - Project state codec
app/src/main/java/com/roadsearch/openeditvideo/data/EditorStateCodec.kt - Project database
app/src/main/java/com/roadsearch/openeditvideo/data/AppDatabase.kt - Project records
app/src/main/java/com/roadsearch/openeditvideo/data/ProjectEntity.kt
Export
- Export worker
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt - Export validation
app/src/main/java/com/roadsearch/openeditvideo/export/ExportCapabilityAnalyzer.kt - Media validation
app/src/main/java/com/roadsearch/openeditvideo/export/MediaSourceValidator.kt - Export interface
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExporter.kt - Exporter routing
app/src/main/java/com/roadsearch/openeditvideo/export/RoutedVideoExporter.kt - Media3 exporter
app/src/main/java/com/roadsearch/openeditvideo/export/Media3VideoExporter.kt - FFmpeg exporter
app/src/main/java/com/roadsearch/openeditvideo/export/AdvancedFfmpegVideoExporter.kt - MediaStore publisher
app/src/main/java/com/roadsearch/openeditvideo/export/MediaStorePublisher.kt
Other components
- Editor user
Connections 26
- Editor user → Editor screen: edits in
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt - Editor screen → Editor state: invokes actions
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt - Editor screen → Timeline controls: renders
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt - Editor screen → Animation model: shows animation tools
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt - Timeline controls → Editor state: dispatches edits
app/src/main/java/com/roadsearch/openeditvideo/ui/Timeline.kt - Editor state → Timeline math: uses timeline rules
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt - Editor state → Project repository: loads and saves
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt - Editor state → Media engine: controls media
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt - Editor state → Export worker: queues export
app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt - Timeline operations → Timeline math: uses timeline rules
app/src/main/java/com/roadsearch/openeditvideo/core/editor/TimelineEditor.kt - Project repository → Project database: accesses
app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt - Project repository → Project state codec: encodes state
app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt - Project database → Project records: stores
app/src/main/java/com/roadsearch/openeditvideo/data/AppDatabase.kt - Media engine → Timeline math: uses timeline rules
app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt - Media engine → Multi-track composition: builds compositions
app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt - Media engine → Media effects: applies effects
app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt - Multi-track composition → Media engine: uses engine effects
app/src/main/java/com/roadsearch/openeditvideo/media/MultiTrackCompositionFactory.kt - Export worker → Project repository: loads project
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt - Export worker → Project state codec: decodes state
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt - Export worker → Export validation: checks capabilities
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt - Export worker → Media validation: validates sources
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt - Export worker → Export interface: requests render
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt - Export worker → MediaStore publisher: publishes output
app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt - Exporter routing → Media3 exporter: routes standard exports
app/src/main/java/com/roadsearch/openeditvideo/di/AppModule.kt - Exporter routing → FFmpeg exporter: routes advanced exports
app/src/main/java/com/roadsearch/openeditvideo/di/AppModule.kt - Render planning → FFmpeg exporter: plans advanced rendering