How oil-oil/oil-motion works
Oil Motion is an agent-oriented toolkit for creating interactive web animation assets and integrating them into pages. Its documented workflow runs from defining the motion and confirming keyframes, through AI video generation and frame preparation, to choosing and producing a delivery format for browser interaction. The graph also shows the documented credential setup and explainer-page capability. Source excerpts are partial, so links between unsampled runtime features and asset-processing stages are omitted where their callers are unclear.
Main entry points: compile_scroll_video.py Video compilation · concepts.md Motion contract · video_job.py Video generation · image_job.py Keyframe generation
Components 20
Motion design
- Motion contract
references/concepts.md
Asset generation
- Keyframe generation
scripts/image_job.py - Video generation
scripts/video_job.py
Asset preparation
- Frame processing
scripts/motion_pipeline.py - Delivery selection
scripts/motion_budget.py - Video compilation
scripts/compile_scroll_video.py - Asset optimization
scripts/optimize_motion.py - Chroma keying
scripts/chroma_key.py - Pilot approval
scripts/production_gate.py
Web integration
- Interactive playback
assets/interactive-motion.ts - Chroma renderer
assets/chroma-video-renderer.ts - Gesture input
assets/step-gesture.ts - Explainer-page generator
scripts/create_explainer.py - Explainer template
assets/motion-explainer-template.html
Credentials
- Credential setup
scripts/credential-ui
Other components
- Project user
- Image service
- Video service
- Web page
- System credential store
Connections 18
- Project user → Motion contract: defines motion
- Motion contract → Keyframe generation: guides keyframes
- Keyframe generation → Image service: requests images
- Motion contract → Video generation: guides action
- Video generation → Video service: submits job
- Delivery selection → Video compilation: selects route
- Video compilation → Delivery selection: checks report
- Video compilation → Frame processing: prepares frames
- Asset optimization → Frame processing: extracts frames
- Video compilation → Chroma keying: uses keying
- Pilot approval → Video generation: approves production
- Web page → Interactive playback: provides interaction
- Web page → Chroma renderer: plays video
- Web page → Gesture input: provides gestures
- Explainer-page generator → Explainer template: fills template
- Web page → Explainer-page generator: views preview
- Project user → Credential setup: enters keys
- Credential setup → System credential store: stores credentials