Motion Previs Studio is a cross-platform desktop app (Electron/TypeScript) for AI-film previsualization, exporting bundles for downstream workflows like Blender and Blockout. It supports macOS (Apple Silicon) and Windows builds, with MCP agent control and OpenPose export in v4.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Motion Previs Studio v4 is an open-source cross-platform desktop application for turning source video shots into AI-film previsualization and control-reference bundles. It exports a production pack geared for downstream AI-video and Blender workflows, and includes features such as pose, depth, and camera-move extraction, along with control layers and export presets. It is licensed under Apache-2.0.
How it works
- Imports local video files and YouTube-compatible URLs via yt-dlp.
- Uses ffmpeg to normalize clips and create local control passes.
- Uses MediaPipe Pose Landmarker locally to extract 2D/world-space pose landmarks.
- Exports a bundle folder and ZIP designed for downstream workflows, including OpenPose BODY_25 skeleton video and keypoints.
- Provides multiple reference modes (Camera only, Actor motion, Object motion, Full scene) and selectable control layers.
- Encodes control videos deterministically frame-by-frame through ffmpeg for reproducibility.
- Includes an Agent Control (MCP) with a localhost control server and MCP bridge to drive the app via AI agents.
Getting started
- macOS: The README provides a one-liner to install the latest macOS build:
curl -fsSL https://raw.githubusercontent.com/wassermanproductions/motion-previs-studio/main/install.sh | bash
- Windows 11: Download the win-x64.exe installer from GitHub Releases. If SmartScreen prompts, use More info → Run anyway.
- Additional commands for macOS safety: the app can be opened after a quarantine-bypass with:
xattr -cr "/Applications/Motion Previs Studio v4.app"
- Development setup:
npm install
npm run dev
- Building and packaging commands:
npm run build
npm run dist:dir
- Packaging for macOS/Windows:
npm run package:mac
npm run package:win
Recent releases
- Latest: v4.1.0-desktop.1 Motion Previs Studio 4.1.0 — Windows 11 (prerelease) (2026-07-12)
- Windows 11 x64 installer file: Motion-Previs-Studio-4.1.0-win-x64.exe
- Other assets include macOS media tools and v4.1.0 Motion Previs Studio 4.1.0 (2026-07-10) with OpenPose export enhancements.
Traction
- Stars: 281
- Forks: 40
- Open issues: 0
Behind the repo
- Developer: Sam Wasserman; organization Wasserman Productions / Wasserman.ai
- The project hosts a MCP bridge and agent-control features described in the README and mcp/README.md.
Caveats
- License: Apache-2.0
- Open-source status and build assets are distributed separately (FFmpeg/FFprobe are GPL-3.0+ components with their own provenance).
- macOS builds mention Apple Silicon installation and notarization considerations; Windows builds may show SmartScreen prompts for unsigned installers.
- The README notes that macOS builds may be published separately and that local signed app bundles are not committed.