Skip to content

BerlinKing/MotionBastard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🀬 MotionBastard

AI-powered motion design assistant β€” generates AE scripts & frontend animations from chat.

An opinionated, foul-mouthed AI motion designer that lives inside After Effects. Describe what you want, it figures out the best way to build it β€” AE ExtendScript or frontend code β€” and does it for you.


What it does

Two paths, one chat:

  • AE Path β†’ You describe an animation β†’ AI generates ExtendScript β†’ Click "Execute" β†’ Animation appears in your AE comp
  • Frontend Path β†’ You describe a CSS/JS animation β†’ AI generates code β†’ Live preview renders in the panel β†’ Copy code to your project

It also:

  • Reads your current AE comp & selected layers automatically
  • Detects which path is best for your request (AE vs frontend)
  • Speaks its mind about your design choices (you've been warned)

Screenshots

TODO: Add screenshots here


Install

Prerequisites

One-line install

Mac (open Terminal):

curl -sL https://raw.githubusercontent.com/BerlinKing/MotionBastard/main/install.sh | bash

Windows (open PowerShell as Admin):

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/BerlinKing/MotionBastard/main/install.bat" -OutFile "$env:TEMP\mb_install.bat"; Start-Process "$env:TEMP\mb_install.bat" -Verb RunAs

Then:

  1. Restart After Effects
  2. Go to Window β†’ Extensions β†’ Motion AI Assistant
  3. Click βš™ Settings β†’ Select provider β†’ Paste your API key β†’ Save
  4. Start chatting

Manual install

Click to expand

Mac:

git clone https://github.com/BerlinKing/MotionBastard.git "/Library/Application Support/Adobe/CEP/extensions/motion-ai-panel"
curl -o "/Library/Application Support/Adobe/CEP/extensions/motion-ai-panel/js/CSInterface.js" https://raw.githubusercontent.com/nickvdh/cep-resources/main/CSInterface_12.js
defaults write com.adobe.CSXS.12 PlayerDebugMode 1

Windows (as Admin):

git clone https://github.com/BerlinKing/MotionBastard.git "C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\motion-ai-panel"
curl -o "C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\motion-ai-panel\js\CSInterface.js" https://raw.githubusercontent.com/nickvdh/cep-resources/main/CSInterface_12.js
reg add "HKCU\Software\Adobe\CSXS.12" /v PlayerDebugMode /t REG_DWORD /d 1 /f

Supported API Providers

Provider Models Key format
OpenRouter (default) Claude Sonnet 4, Claude Opus 4, Claude Haiku 4 sk-or-...
Anthropic (direct) Claude Sonnet 4, Claude Opus 4 sk-ant-...

OpenRouter is recommended β€” it's easier to set up and supports more models.


Project Structure

motion-ai-panel/
β”œβ”€β”€ CSXS/
β”‚   └── manifest.xml          # CEP extension config
β”œβ”€β”€ css/
β”‚   └── style.css             # Panel styles (dark theme)
β”œβ”€β”€ js/
β”‚   β”œβ”€β”€ CSInterface.js        # Adobe CEP bridge (download separately)
β”‚   └── app.js                # Main app logic + Claude API
β”œβ”€β”€ jsx/
β”‚   └── host.jsx              # ExtendScript functions for AE control
β”œβ”€β”€ .debug                    # CEP debug config
└── index.html                # Panel UI

How it works

  1. Panel connects to AE via CSInterface + ExtendScript bridge
  2. Status bar shows current comp & selected layer in real-time
  3. When you send a message, AE context (comp size, layers, effects) is automatically injected
  4. AI decides the best path: AE ExtendScript or frontend code
  5. AE path: code goes to Code tab β†’ click Execute β†’ runs in AE
  6. Frontend path: code renders in Preview tab β†’ copy when satisfied

The AI Personality

MotionBastard's AI is a veteran motion designer with 10+ years of experience. It's technically brilliant but has zero patience for bad taste. It will:

  • Tell you if your idea is ugly
  • Suggest better approaches (with reasons)
  • Refuse to write code until your requirements are clear
  • Occasionally roast your design choices

Don't take it personally. It's making your work better.


Roadmap

  • Voice input for hands-free iteration
  • Multi-model support (GPT, Gemini)
  • Reverse detection (sync AE manual changes back)
  • Conversation history
  • SP remote hot-update

Contributing

PRs welcome. If you're improving the System Prompt, test it in the Anthropic Workbench first.


License

MIT β€” do whatever you want.

About

AI-powered motion design assistant for After Effects

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors