Final Cut Pro Integration

Instruction → EditIntent JSON → FCPXML → CommandPost Watch Folder → FCP Auto-Import

pip install praisonai openai

# Simple concatenation (no LLM required)
praisonai fcp autoedit --simple \
  --media /path/to/clip1.mov \
  --media /path/to/clip2.mov

# AI-powered editing
praisonai fcp autoedit \
  --instruction "Create a highlight reel with the best moments" \
  --media /path/to/clip1.mov \
  --media /path/to/clip2.mov

# Dry run (generate without importing)
praisonai fcp autoedit \
  --instruction "Add background music" \
  --media /path/to/video.mov \
  --media /path/to/music.mp3 \
  --dry-run --print-fcpxml

from praisonai.integrations.fcp import (
    generate_edit_intent,
    FCPXMLGenerator,
    Injector,
)

# Generate EditIntent from natural language
intent, warnings = generate_edit_intent(
    instruction="Concatenate all clips with crossfades",
    media_paths=["/path/to/clip1.mov", "/path/to/clip2.mov"],
    project_name="My Project",
    format_preset="1080p25",
)

# Generate FCPXML
generator = FCPXMLGenerator(intent)
fcpxml = generator.generate()

# Inject into Final Cut Pro
injector = Injector()
job_id, path, messages = injector.inject_one_shot(fcpxml)
print(f"Injected: {job_id}")

praisonai fcp doctor

============================================================
FCP Integration Health Check
============================================================

  ✓ macOS: Running on macOS 14.0
  ✓ Final Cut Pro: Found at /Applications/Final Cut Pro.app
  ✓ CommandPost App: Found at /Applications/CommandPost.app
  ✓ cmdpost CLI: Found at /Applications/CommandPost.app/...
  ✓ Watch Folder: Exists at ~/.praisonai/fcp/watch/fcpxml
  ✓ Auto-Import: Enabled in CommandPost
  ✓ OpenAI API Key: Set (ending in ...abc1)

============================================================
All checks passed! FCP integration is ready.
============================================================

praisonai fcp bootstrap-commandpost

# Start daemon
praisonai fcp daemon start

# Check status
praisonai fcp daemon status

# Stop daemon
praisonai fcp daemon stop

{
  "version": "1",
  "project": {
    "name": "My Project",
    "format": {"width": 1920, "height": 1080, "fps": 25.0},
    "audio": {"layout": "stereo", "rate": 48000, "channels": 2}
  },
  "assets": [
    {
      "id": "r2",
      "name": "interview",
      "path": "/path/to/interview.mov",
      "has_video": true,
      "has_audio": true
    }
  ],
  "timeline": {
    "segments": [
      {
        "asset_id": "r2",
        "offset": "0/2500s",
        "start": "0/2500s",
        "duration": "5000/2500s",
        "role": "dialogue"
      }
    ],
    "markers": []
  }
}

praisonai run fcp-autoedit "Create a 30-second highlight reel" \
  --media /videos/clip1.mov \
  --media /videos/clip2.mov