How mjawadi2002/omnimotion works
OmniMotion is a desktop editor for turning talking-head footage—or, in motion mode, an idea—into short-form video. Users create a project, attach media, transcribe and cut speech, plan and refine a word-anchored edit, preview it, then render. The app also supports reference analysis and recreation, custom looks, project memory, and free-model routing. The graph follows documented capabilities; unsampled screen and runtime wiring is represented only where the README or excerpts support it.
Main entry points: main.mjs IPC handlers · api.ts Desktop API · Workspace.tsx Project workspace · ai.mjs AI planning
Components 29
Desktop workflow
- App shell
cutline-app/src/App.tsx - Projects
cutline-app/src/screens/Projects.tsx - Project workspace
cutline-app/src/screens/Workspace.tsx - Media setup
cutline-app/src/screens/MediaTab.tsx - Desktop API
cutline-app/src/lib/api.ts - IPC handlers
cutline-app/electron/main.mjs
Edit and render
- Transcribe and cut
cutline-app/src/screens/StoryTab.tsx - Word-anchored plan
cutline-app/src/screens/PlanTab.tsx - Plan editing
cutline-app/src/screens/EditTab.tsx - Timeline control
cutline-app/src/screens/Timeline.tsx - Render and preview
cutline-app/src/screens/RenderTab.tsx - Media handling
cutline-app/electron/media.mjs - Edit engine runner
cutline-app/electron/engine.mjs
AI and creative modes
- Motion graphics mode
cutline-app/src/screens/MotionMode.tsx - Motion generation
cutline-app/electron/motion.mjs - Reference recreation
cutline-app/electron/agentbuild.mjs - Reference analysis
cutline-app/electron/refanalyze.mjs - Looks
cutline-app/electron/looks.mjs - AI planning
cutline-app/electron/ai.mjs - Analyze reel
cutline-app/src/screens/Analyze.tsx - Reference library
cutline-app/electron/library.mjs
Persistence and services
- Project memory
cutline-app/electron/memory.mjs - Settings and projects
cutline-app/electron/store.mjs - Free model routing
cutline-app/electron/freellm.mjs - FreeLLM gateway
cutline-app/electron/gateway.mjs
Other components
- Editor
- Claude
- ElevenLabs
- Remotion renderer
video-studio/src/Composition.tsx
Connections 41
- Editor → App shell: uses
README.md - App shell → Projects: routes to
cutline-app/src/App.tsx - App shell → Project workspace: routes to
cutline-app/src/App.tsx - App shell → Analyze reel: routes to
cutline-app/src/App.tsx - Projects → Project workspace: opens project
- Project workspace → Media setup: shows stage
- Project workspace → Transcribe and cut: shows stage
- Project workspace → Word-anchored plan: shows stage
- Project workspace → Plan editing: shows stage
- Project workspace → Render and preview: shows stage
- Media setup → Desktop API: requests media operations
- Transcribe and cut → Desktop API: requests preparation
- Word-anchored plan → Desktop API: requests planning
- Plan editing → Desktop API: submits changes
- Render and preview → Desktop API: requests render
- Desktop API → IPC handlers: bridges requests
- IPC handlers → Media handling: attaches media
cutline-app/electron/main.mjs - IPC handlers → Edit engine runner: starts engine runs
cutline-app/electron/main.mjs - Edit engine runner → Looks: resolves look
cutline-app/electron/engine.mjs - Edit engine runner → Remotion renderer: renders composition
README.md - Motion graphics mode → Desktop API: requests motion workflow
cutline-app/src/lib/api.ts - IPC handlers → Motion generation: uses recording
cutline-app/electron/main.mjs - Motion generation → AI planning: generates motion script
cutline-app/electron/motion.mjs - Motion generation → ElevenLabs: requests voice
README.md - Motion generation → Remotion renderer: builds animation
README.md - IPC handlers → Reference recreation: runs reference build
cutline-app/electron/main.mjs - Reference recreation → Reference analysis: analyzes reference
cutline-app/electron/agentbuild.mjs - Reference recreation → AI planning: asks Claude to build
cutline-app/electron/agentbuild.mjs - Analyze reel → Desktop API: requests analysis
cutline-app/src/screens/Analyze.tsx - IPC handlers → Reference library: describes reference
cutline-app/electron/main.mjs - Analyze reel → Looks: creates look from analysis
- IPC handlers → AI planning: runs AI edit
cutline-app/electron/main.mjs - AI planning → Claude: plans edit
README.md - AI planning → Free model routing: uses free fallback
cutline-app/electron/ai.mjs - Free model routing → FreeLLM gateway: gets backend
cutline-app/electron/freellm.mjs - FreeLLM gateway → Claude: routes model requests
- AI planning → Project memory: loads project context
cutline-app/electron/ai.mjs - IPC handlers → Project memory: records spelling fixes
cutline-app/electron/main.mjs - IPC handlers → Settings and projects: saves settings and plans
cutline-app/electron/main.mjs - Media handling → Settings and projects: uses cache
cutline-app/electron/media.mjs - Reference library → Settings and projects: uses project storage
cutline-app/electron/library.mjs