# roadsearch/motionflow architecture

> Architecture diagram of the GitHub repository roadsearch/motionflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roadsearch/motionflow
- Repository: https://github.com/roadsearch/motionflow

## Overview

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: [`app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt) (Export worker), [`app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt`](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt) (Editor state), [`app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt`](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt) (Media engine), [`app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt`](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt) (Editor screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Editing"]
  node_screen["Editor screen<br/>[EditorScreen.kt]"]
  node_viewmodel["Editor state<br/>[EditorViewModel.kt]"]
  node_timelineui["Timeline controls<br/>[Timeline.kt]"]
  node_timeline["Timeline operations<br/>[TimelineEditor.kt]"]
  node_math["Timeline math<br/>[TimelineMath.kt]"]
  node_models["Editor models<br/>[EditorModels.kt]"]
  node_animation["Animation model<br/>[Animation.kt]"]
end

subgraph group_media["Preview and effects"]
  node_mediaengine["Media engine<br/>[MediaEngine.kt]"]
  node_composition["Multi-track composition"]
  node_preview["Composition preview"]
  node_effects["Media effects<br/>[AdvancedEffects.kt]"]
  node_renderplan["Render planning<br/>[RenderPlannerV2.kt]"]
end

subgraph group_projects["Project storage"]
  node_repository["Project repository"]
  node_codec["Project state codec"]
  node_database[("Project database<br/>[AppDatabase.kt]")]
  node_entity["Project records<br/>[ProjectEntity.kt]"]
end

subgraph group_export["Export"]
  node_worker["Export worker"]
  node_validation["Export validation"]
  node_sourcevalidation["Media validation"]
  node_exportport["Export interface<br/>[VideoExporter.kt]"]
  node_router["Exporter routing"]
  node_media3export["Media3 exporter"]
  node_ffmpegexport["FFmpeg exporter"]
  node_publisher["MediaStore publisher"]
end

node_user(("Editor user"))

node_user -->|"edits in"| node_screen
node_screen -->|"invokes actions"| node_viewmodel
node_screen -->|"renders"| node_timelineui
node_screen -->|"shows animation tools"| node_animation
node_timelineui -->|"dispatches edits"| node_viewmodel
node_viewmodel -->|"uses timeline rules"| node_math
node_viewmodel -->|"loads and saves"| node_repository
node_viewmodel -->|"controls media"| node_mediaengine
node_viewmodel -->|"queues export"| node_worker
node_timeline -->|"uses timeline rules"| node_math
node_repository -->|"accesses"| node_database
node_repository -->|"encodes state"| node_codec
node_database -->|"stores"| node_entity
node_mediaengine -->|"uses timeline rules"| node_math
node_mediaengine -->|"builds compositions"| node_composition
node_mediaengine -->|"applies effects"| node_effects
node_composition -->|"uses engine effects"| node_mediaengine
node_worker -->|"loads project"| node_repository
node_worker -->|"decodes state"| node_codec
node_worker -->|"checks capabilities"| node_validation
node_worker -->|"validates sources"| node_sourcevalidation
node_worker -->|"requests render"| node_exportport
node_worker -->|"publishes output"| node_publisher
node_router -->|"routes standard exports"| node_media3export
node_router -.->|"routes advanced exports"| node_ffmpegexport
node_renderplan -.->|"plans advanced rendering"| node_ffmpegexport

click node_screen "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt"
click node_viewmodel "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt"
click node_timelineui "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/Timeline.kt"
click node_timeline "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/core/editor/TimelineEditor.kt"
click node_math "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/core/TimelineMath.kt"
click node_models "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/model/EditorModels.kt"
click node_animation "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/model/Animation.kt"
click node_mediaengine "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt"
click node_composition "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/MultiTrackCompositionFactory.kt"
click node_preview "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/CompositionPreviewController.kt"
click node_effects "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/AdvancedEffects.kt"
click node_repository "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt"
click node_codec "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/EditorStateCodec.kt"
click node_database "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/AppDatabase.kt"
click node_entity "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/ProjectEntity.kt"
click node_worker "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt"
click node_validation "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/ExportCapabilityAnalyzer.kt"
click node_sourcevalidation "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/MediaSourceValidator.kt"
click node_exportport "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/VideoExporter.kt"
click node_router "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/RoutedVideoExporter.kt"
click node_media3export "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/Media3VideoExporter.kt"
click node_ffmpegexport "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/AdvancedFfmpegVideoExporter.kt"
click node_publisher "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/MediaStorePublisher.kt"
click node_renderplan "https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/render/RenderPlannerV2.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_screen,node_viewmodel,node_timelineui,node_timeline,node_math,node_models,node_animation,node_user toneBlue
class node_mediaengine,node_composition,node_preview,node_effects,node_renderplan toneAmber
class node_repository,node_codec,node_database,node_entity toneMint
class node_worker,node_validation,node_sourcevalidation,node_exportport,node_router,node_media3export,node_ffmpegexport,node_publisher toneRose
```

## Components

### Editing

- [Editor screen](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt): `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt`
- [Editor state](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt): `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt`
- [Timeline controls](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/ui/Timeline.kt): `app/src/main/java/com/roadsearch/openeditvideo/ui/Timeline.kt`
- [Timeline operations](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/core/editor/TimelineEditor.kt): `app/src/main/java/com/roadsearch/openeditvideo/core/editor/TimelineEditor.kt`
- [Timeline math](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/core/TimelineMath.kt): `app/src/main/java/com/roadsearch/openeditvideo/core/TimelineMath.kt`
- [Editor models](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/model/EditorModels.kt): `app/src/main/java/com/roadsearch/openeditvideo/model/EditorModels.kt`
- [Animation model](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/model/Animation.kt): `app/src/main/java/com/roadsearch/openeditvideo/model/Animation.kt`

### Preview and effects

- [Media engine](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt): `app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt`
- [Multi-track composition](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/MultiTrackCompositionFactory.kt): `app/src/main/java/com/roadsearch/openeditvideo/media/MultiTrackCompositionFactory.kt`
- [Composition preview](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/CompositionPreviewController.kt): `app/src/main/java/com/roadsearch/openeditvideo/media/CompositionPreviewController.kt`
- [Media effects](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/media/AdvancedEffects.kt): `app/src/main/java/com/roadsearch/openeditvideo/media/AdvancedEffects.kt`
- [Render planning](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/render/RenderPlannerV2.kt): `app/src/main/java/com/roadsearch/openeditvideo/render/RenderPlannerV2.kt`

### Project storage

- [Project repository](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt): `app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt`
- [Project state codec](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/EditorStateCodec.kt): `app/src/main/java/com/roadsearch/openeditvideo/data/EditorStateCodec.kt`
- [Project database](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/AppDatabase.kt): `app/src/main/java/com/roadsearch/openeditvideo/data/AppDatabase.kt`
- [Project records](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/data/ProjectEntity.kt): `app/src/main/java/com/roadsearch/openeditvideo/data/ProjectEntity.kt`

### Export

- [Export worker](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`
- [Export validation](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/ExportCapabilityAnalyzer.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/ExportCapabilityAnalyzer.kt`
- [Media validation](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/MediaSourceValidator.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/MediaSourceValidator.kt`
- [Export interface](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/VideoExporter.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExporter.kt`
- [Exporter routing](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/RoutedVideoExporter.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/RoutedVideoExporter.kt`
- [Media3 exporter](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/Media3VideoExporter.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/Media3VideoExporter.kt`
- [FFmpeg exporter](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/AdvancedFfmpegVideoExporter.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/AdvancedFfmpegVideoExporter.kt`
- [MediaStore publisher](https://github.com/roadsearch/motionflow/blob/main/app/src/main/java/com/roadsearch/openeditvideo/export/MediaStorePublisher.kt): `app/src/main/java/com/roadsearch/openeditvideo/export/MediaStorePublisher.kt`

### Other components

- **Editor user**

## Connections

- Editor user → Editor screen: edits in (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt`)
- Editor screen → Editor state: invokes actions (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt`)
- Editor screen → Timeline controls: renders (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt`)
- Editor screen → Animation model: shows animation tools (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorScreen.kt`)
- Timeline controls → Editor state: dispatches edits (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/Timeline.kt`)
- Editor state → Timeline math: uses timeline rules (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt`)
- Editor state → Project repository: loads and saves (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt`)
- Editor state → Media engine: controls media (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt`)
- Editor state → Export worker: queues export (evidence: `app/src/main/java/com/roadsearch/openeditvideo/ui/EditorViewModel.kt`)
- Timeline operations → Timeline math: uses timeline rules (evidence: `app/src/main/java/com/roadsearch/openeditvideo/core/editor/TimelineEditor.kt`)
- Project repository → Project database: accesses (evidence: `app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt`)
- Project repository → Project state codec: encodes state (evidence: `app/src/main/java/com/roadsearch/openeditvideo/data/ProjectRepository.kt`)
- Project database → Project records: stores (evidence: `app/src/main/java/com/roadsearch/openeditvideo/data/AppDatabase.kt`)
- Media engine → Timeline math: uses timeline rules (evidence: `app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt`)
- Media engine → Multi-track composition: builds compositions (evidence: `app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt`)
- Media engine → Media effects: applies effects (evidence: `app/src/main/java/com/roadsearch/openeditvideo/media/MediaEngine.kt`)
- Multi-track composition → Media engine: uses engine effects (evidence: `app/src/main/java/com/roadsearch/openeditvideo/media/MultiTrackCompositionFactory.kt`)
- Export worker → Project repository: loads project (evidence: `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`)
- Export worker → Project state codec: decodes state (evidence: `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`)
- Export worker → Export validation: checks capabilities (evidence: `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`)
- Export worker → Media validation: validates sources (evidence: `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`)
- Export worker → Export interface: requests render (evidence: `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`)
- Export worker → MediaStore publisher: publishes output (evidence: `app/src/main/java/com/roadsearch/openeditvideo/export/VideoExportWorker.kt`)
- Exporter routing → Media3 exporter: routes standard exports (evidence: `app/src/main/java/com/roadsearch/openeditvideo/di/AppModule.kt`)
- Exporter routing → FFmpeg exporter: routes advanced exports (evidence: `app/src/main/java/com/roadsearch/openeditvideo/di/AppModule.kt`)
- Render planning → FFmpeg exporter: plans advanced rendering
