Everything you need to know about MotionMate

What's New in v2.0

MotionMate v2.0 brings major improvements to installation, performance, security, and user experience.

System Requirements

Installation

MotionMate v2.0 uses a professional Windows installer for easy one-click setup.

Step 1: Download the Installer

After subscribing, download MotionMate_v2.0_Setup.exe (~400 MB) from your Dashboard.

Step 2: Prepare for Installation

1. Close After Effects — Make sure After Effects is completely closed (check Task Manager if unsure)
2. Run as Administrator — Right-click MotionMate_v2.0_Setup.exe and select "Run as administrator"

Step 3: Installation Wizard

1. Select Language — Choose English or Türkçe for the installer interface
2. Welcome Screen — Click "Yes" to continue when prompted about installation details
3. Wait for Installation — The installer will:
   • Copy extension files to CEP extensions folder
   • Install Python backend and AI models
   • Configure Adobe CEP debug mode (PlayerDebugMode registry keys)
   • Create uninstaller entry in Control Panel
4. Installation Complete — You'll see a success message. Click "OK" to finish.

Step 4: Launch in After Effects

1. Open After Effects — Launch (or restart) After Effects
2. Open MotionMate — Go to Window → Extensions → MotionMate
3. License Activation — You'll see the activation screen. Enter your license key to continue.

Verification

To verify the installation was successful:

• Extension appears in Window → Extensions menu
• Panel opens without errors
• Bottom-left status shows "Python Server: Online" after a few seconds

Installation Location

C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\com.motionmate.panel.hybrid\
├── client/       (UI files - HTML, CSS, JS)
├── host/         (ExtendScript - After Effects integration)
├── CSXS/         (Extension manifest)
└── server/       (Python backend + AI models)

License Activation

After installing the extension, you need to activate it with your license key. Activation is fast and secure.

Activation Process

1. Get your license key — After subscribing, your license key will appear in your Dashboard. Format: MMATE-XXXX-XXXX-XXXX
2. Open the extension — In After Effects, go to Window → Extensions → MotionMate. You'll see the activation screen.
3. Enter your license key — Paste your license key (including dashes) and click Activate License
4. Wait for confirmation — Activation typically completes in 1-2 seconds with v2.0's async system
5. Start using! — All 6 modules are now unlocked and ready to use

Activation Details

• One device at a time — Each license activates on one computer
• Hardware-tied — Activation is linked to your hardware ID (HWID)
• Offline usage — Once activated, most features work offline (except initial AI model downloads)
• Automatic verification — The extension periodically verifies your subscription status

Switching Computers

To use MotionMate on a different computer:

1. Open MotionMate on the old computer
2. Click the Settings (⚙️) icon
3. Scroll to "License Information"
4. Click "Deactivate Device"
5. Wait for confirmation (~1 second with v2.0)
6. Install and activate on your new computer

Modules Overview

MotionMate includes 6 professional tools in a single panel. Click any module below for detailed usage instructions.

Beat Detection

Automatically detect beats in your audio and create markers or keyframes synced to the rhythm. This feature runs natively inside After Effects — no Python backend needed.

How to Use

1. Select a composition with an audio layer
2. Click Beat Detection in the sidebar
3. Choose your output type:
   • Composition Markers — Adds markers at each beat on the comp timeline
   • Layer Markers — Adds markers on the audio layer itself
4. Click Detect Beats
5. After Effects will convert the audio to keyframes and detect the peaks

Auto Subtitles (AI)

Generate perfectly timed subtitles using OpenAI's Whisper speech recognition model. Supports 90+ languages with sentence-level or word-level (karaoke) timing.

How to Use

1. Select a composition with audio
2. Click Auto Subtitles in the sidebar
3. Configure settings:
   • Model — tiny (fastest), base, small, medium, large (most accurate)
   • Language — Auto-detect or select a specific language
   • Mode — Sentence mode or Word mode (karaoke)
4. Click Generate Subtitles
5. The AI will transcribe the audio and create text layers in your composition

Subtitle Modes

Model Comparison

Graph Editor

A visual bezier curve editor with 29 professional easing presets. Apply smooth, bounce, elastic, and custom easing curves to your keyframes without leaving the MotionMate panel.

How to Use

1. Select one or more layers with keyframes in your composition
2. Select the keyframes you want to ease (at least 2 keyframes)
3. Click Graph Editor in the sidebar
4. Choose a preset from the grid, or create a custom curve by dragging the control points
5. Click Apply to apply the easing to selected keyframes

Preset Categories

• Ease In — Starts slow, ends fast (6 variations)
• Ease Out — Starts fast, ends slow (6 variations)
• Ease In-Out — Slow start and end (6 variations)
• Back — Overshoots then settles (3 variations)
• Bounce — Bouncing effect (3 variations)
• Elastic — Spring-like oscillation (3 variations)
• Linear — No easing
• Custom — Draw your own curve

Custom Presets

You can save your custom curves as presets:

1. Drag the control points to create your desired curve
2. Click the Save icon next to the curve
3. Name your preset
4. Your custom presets appear at the bottom of the preset grid

Noise Removal (AI)

Remove background noise from audio or isolate vocals using AI-powered models. Supports two modes: noise reduction (keeps speech, removes noise) and vocal isolation (separates vocals from music).

How to Use

1. Select a composition with an audio layer
2. Click Noise Removal in the sidebar
3. Choose your mode:
   • Noise Reduction — Removes background noise while preserving speech/dialogue
   • Vocal Isolation — Separates vocals from music and instruments (uses Demucs AI)
4. Adjust the Strength slider (higher = more aggressive removal)
5. Click Process
6. The processed audio will replace or be added alongside the original layer

Noise Reduction vs Vocal Isolation

Comp Splitter

Split a composition into individual compositions — one for each layer. Useful for organizing complex projects, creating modular templates, or preparing layers for separate rendering.

How to Use

1. Select the composition you want to split
2. Click Comp Splitter in the sidebar
3. Choose which layers to include (all layers or selected layers only)
4. Click Split Comp
5. New compositions will be created in a folder, one per layer, with the same dimensions and duration as the original

Plugin Guide

A built-in reference for After Effects effects. Browse 27+ effects with descriptions, parameter details, and quick-apply functionality. Great for discovering effects you didn't know AE had.

How to Use

1. Click Plugin Guide in the sidebar
2. Click Scan Effects to detect all available effects in your AE installation
3. Browse or search through the effect categories
4. Click on any effect to see its description and parameters

Available Categories

• Color Correction
• Blur & Sharpen
• Distort
• Generate
• Stylize
• Transition
• And more...

Architecture

MotionMate uses a hybrid architecture combining local processing with cloud authentication for optimal performance and security.

System Components

Request Routing

User Action
    ↓
CEP Panel (Client)
    ├─→ ExtendScript (AE native operations)
    ├─→ Local Python Server (AI features)
    └─→ Cloud VDS (license validation)

Why Hybrid?

• Privacy: AI processing stays on your machine — no audio/video uploads
• Speed: Local AI inference is faster than cloud APIs
• Offline: Most features work without internet after activation
• Security: Sensitive operations (auth) use HTTPS to cloud server

Performance

MotionMate v2.0 includes significant performance optimizations across all systems.

Activation Performance

Technical Improvements

1. Async Activation

Instead of blocking for 15+ seconds, activation now:

• Returns immediately with a request ID
• Processes validation in the background
• Polls status every 2 seconds
• Shows real-time progress to user

2. Database Optimization

Backend database improvements:

• WAL mode — Write-Ahead Logging for better concurrency
• Optimized queries — Indexed lookups for license keys
• Connection pooling — Reuse connections instead of creating new ones
• Async operations — Non-critical tasks (audit logging) run in background

3. Python Server Optimization

• Pre-compiled exe — PyInstaller bundle starts in <2 seconds
• Model caching — AI models loaded once, cached for subsequent uses
• Multi-threading — Parallel processing for audio analysis

Benchmarks

Troubleshooting

Installer Issues

"Cannot create output directory" error

• Run the installer as Administrator (right-click → Run as administrator)
• Make sure no other program is using the CEP extensions folder
• Close After Effects completely before installing

Installer won't start

• Check if your antivirus is blocking the installer
• Re-download the installer (file may be corrupted)
• Run as Administrator
• Check Windows Event Viewer for error details

"After Effects is currently running" message during install

• Close After Effects completely
• Open Task Manager (Ctrl+Shift+Esc) and end any AfterFX.exe processes
• Run the installer again

Extension not showing in After Effects

• Verify installation: Check that this folder exists:

  C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\com.motionmate.panel.hybrid\

• Restart After Effects: Completely close and reopen (not just reload panel)
• Check PlayerDebugMode: The installer should have set this automatically. Verify in Registry:

  HKEY_CURRENT_USER\Software\Adobe\CSXS.12\PlayerDebugMode = "1"

• Manual registry fix: If PlayerDebugMode is missing, run this command as Administrator:

  reg add "HKCU\Software\Adobe\CSXS.12" /v PlayerDebugMode /t REG_SZ /d 1 /f

License key not activating

• Check subscription status: Verify you have an active subscription in your Dashboard
• Copy key correctly: Include all dashes (format: MMATE-XXXX-XXXX-XXXX)
• Internet connection: Activation requires HTTPS connection to api.getmotionmate.com
• Already activated elsewhere? Deactivate from the other computer first (Settings → Deactivate Device)
• Firewall blocking: Check if your firewall is blocking outbound HTTPS connections
• Timeout error (rare): v2.0 uses async activation with 60-second timeout. If you see timeout, check your connection speed.

AI features not working (Subtitles / Noise Removal)

• The Python backend must be running — check the status indicator in the bottom-left of the panel
• If the status shows "offline", wait a few seconds for it to start automatically
• First use of AI features requires model downloads, which may take a few minutes
• Ensure you have enough disk space (2 GB+ recommended for AI models)
• On some systems, antivirus software may block the Python process — add an exception if needed

Beat Detection produces no results

• Make sure there's an audio layer in your composition
• The audio layer must have audio content (not just a video layer with audio stripped)
• Try with audio that has a clear rhythmic pattern

Graph Editor not applying to keyframes

• Select at least 2 keyframes on the same property before applying
• The keyframes must be spatial or temporal — some property types don't support easing
• Make sure the layer is not locked

Frequently Asked Questions

Support

Need help? We're here for you.