dragonflight/services/premiere-plugin/QUICK_START.md

Wild Dragon MAM - Premiere Pro Panel Quick Start

Installation (1 minute)

Grab the installer from https://forge.wilddragon.net/zgaetano/dragonflight/releases.

Windows

1. Download dragonflight-premiere-panel-<version>-windows-setup.exe
2. Double-click it. Next -> Finish.
3. Restart Premiere Pro.

The installer copies the bundle to %APPDATA%\Adobe\CEP\extensions\, sets PlayerDebugMode=1 for CSXS 8..13, and offers to remove any legacy com.wilddragon.mam.panel install.

macOS

1. Download dragonflight-premiere-panel-<version>.zxp
2. Open it with Anastasiy's ZXP Installer (https://install.anastasiy.com/)
3. Run once in Terminal:
   defaults write com.adobe.CSXS.11 PlayerDebugMode 1
4. Restart Premiere Pro.

Building from source

cd services/premiere-plugin/build
npm install
pwsh -File build-all.ps1

See build/README.md.

Access the Panel

Window > Extensions > Wild Dragon MAM

First Time Setup

1. Enter server URL (default: http://localhost:7434)
2. Click "Connect"
3. Green indicator appears when connected
4. Assets load automatically

Basic Workflow

Connect → Browse → Search → Select → Import

Connect

• Enter MAM server URL
• Click Connect button
• Wait for green status indicator

Browse

• Scroll through asset thumbnails
• Click any asset to see details

Search

• Type in search box
• Results update automatically
• Filter by project using dropdown

Select

• Click an asset thumbnail
• Details panel shows metadata
• Asset is highlighted with accent border

Import

• Click "Import" to download and import selected asset
• Click "Import All" to import all visible assets
• Progress bar shows download status
• Success message appears when complete

Features at a Glance

Feature	Location	Action
Server Connection	Top bar	Enter URL + Click Connect
Search Assets	Search box	Type search term
Filter by Project	Dropdown	Select from list
View Details	Details panel	Click any asset
Import Single	Import button	Select asset + Click Import
Import Multiple	Import All button	Click Import All
View Progress	Progress bar	Watch while importing

File Locations

services/premiere-plugin/
├── CSXS/manifest.xml          Extension config
├── index.html                 Main panel UI
├── css/styles.css             Dark theme styles
├── js/
│   ├── CSInterface.js         Adobe interface
│   └── main.js                Panel logic
├── jsx/
│   └── premiere.jsx           Premiere integration
├── build/                     Installer build pipeline (.zxp + .exe)
├── README.md                  Full docs
└── QUICK_START.md             This file

Troubleshooting

Panel doesn't show:

• Is PlayerDebugMode set to 1? Restart Premiere Pro.
• Is the folder in the right location? Check the path above.
• Is Premiere Pro version 22.0 or later? Check Help > About.

Can't connect to server:

• Is the server running? Check http://localhost:7434 in a browser.
• Is the URL correct? Try http://localhost:7434 first.
• Is firewall blocking? Check network settings.

Assets not loading:

• Click Connect again to refresh.
• Check the search box is empty.
• Try a different project filter.

Import fails:

• Are proxy files available on the server?
• Is there disk space for downloads?
• Check Premiere Pro's Event Monitor for errors.

Tips & Tricks

• Server URL is saved to local storage (persists across sessions)
• Thumbnail previews load lazily for performance
• Search updates with 300ms debounce (wait while typing)
• Double-click a card does nothing (use single click instead)
• Progress bar shows download + import progress
• Click red X to dismiss error messages

API Endpoints Expected

The MAM server should provide:

GET  /api/health              ← Server health check
GET  /api/projects            ← List of projects
GET  /api/assets              ← List assets (paginated)
POST /api/assets/{id}/download ← Signed S3 URL

See README.md for full API specification.

ExtendScript Functions Available

The panel can call these Premiere Pro functions:

// Import file into project
importFileToProject(filePath)

// Get current sequence
getActiveSequence()

// Insert into timeline
insertClipToSequence(filePath, trackIndex)

// Get project info
getProjectPath()
getProjectInfo()
getSequenceTracks()

See jsx/premiere.jsx for details.

Color Scheme (Dark Theme)

Primary Background:     #0f0f1e (very dark blue)
Secondary Background:   #1a1a2e (dark blue)
Accent Color:          #e94560 (bright red/pink)
Text Primary:          #ffffff (white)
Text Secondary:        #b0b0c0 (light gray)
Success:               #00d084 (green)
Error:                 #ff4444 (red)

Support

See README.md for:

• Complete installation guide
• Full feature documentation
• API reference
• ExtendScript function reference
• Performance optimization notes
• Security considerations

---

Version 1.0.0 | April 2026