Zac Gaetano
8aece9cbc4
End-to-end verification on a fresh Windows machine surfaced three issues: 1. pwsh isn't installed by default — Windows ships powershell.exe (5.1). Switched all script invocations + docs from `pwsh` to `powershell`. 2. .NET's strict XML parser rejects manifest.xml because the <Resources> comment legally contains `--` (inside `--enable-nodejs`/`--mixed-context` CEF flag names). Switched build-installer.ps1 to regex extraction, matching what build-zxp.mjs already does. 3. winget installs Inno Setup 6 to %LOCALAPPDATA%\Programs by default, not Program Files (x86). Added the user-scope path to the ISCC.exe fallback list. Verified: `powershell -File build-all.ps1` produces both artifacts — dragonflight-premiere-panel-1.0.0.zxp (35 KB, signature valid) dragonflight-premiere-panel-1.0.0-windows-setup.exe (2 MB). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
199 lines
5 KiB
Markdown
199 lines
5 KiB
Markdown
# 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
|
|
powershell -File build-all.ps1
|
|
```
|
|
|
|
See [`build/README.md`](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:
|
|
|
|
```javascript
|
|
// 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
|