🎬 RealPremiere

A powerful CLI utility for managing Adobe Premiere Pro projects. Analyze, organize, and migrate your Premiere Pro projects with ease.

📋 Features

• Project Analysis: Calculate total project size and list all external files
• File Statistics: View detailed file-by-file statistics with human-readable sizes
• XML Inspection: Decompress and view the internal XML structure of projects
• Project Backup: Copy projects with all their footages to a new location
• Project Migration: Move projects and clean up empty source folders
• Smart Organization: Organize files by extension in separate folders
• Auto-discovery: Automatically find .prproj files in directories
• Update Management: Check for and install updates directly from npm

🚀 Installation

Global Installation (Recommended)

npm install -g realpremiere

Use with npx (No Installation)

npx realpremiere [command]

📖 Usage

Basic Commands

# Show help
realpremiere
realpremiere help

# Check version
realpremiere version

# Check for updates
realpremiere check-update

# Update to latest version
realpremiere software-upgrade

Project Analysis

Calculate Project Size

# Using file path
realpremiere project-size myproject.prproj

# Using folder path (auto-detects .prproj file)
realpremiere project-size ./project-folder/

Output: 50.34 GB (54045883392 bytes)

List Project Files

realpremiere project-files myproject.prproj

Output: Lists all external files used in the project with absolute paths.

Show File Statistics

# Show sizes in bytes
realpremiere project-sizes myproject.prproj

# Show human-readable sizes
realpremiere project-sizes -h myproject.prproj
realpremiere project-sizes --human myproject.prproj

Example Output:

     1.5 GB   1610612736 /path/to/video.mp4
   500.2 MB    524435456 /path/to/audio.wav

View Project XML

realpremiere project-xml myproject.prproj

Decompresses and displays the internal XML structure of the Premiere Pro project.

Project Management

Backup Project (project-dump)

Copy a project with all its files to a new location:

# Basic copy
realpremiere project-dump myproject.prproj backup/

# Copy with organized structure
realpremiere project-dump -o myproject.prproj backup/

Result:

• Creates backup/ folder with:
  • myproject.prproj (modified with new paths)
  • footages/ folder with all files

With -o option:

• Files organized in subfolders by extension:
  • footages/mp4/ - Video files
  • footages/mp3/ - Audio files
  • footages/psd/ - Photoshop files
  • footages/png/ - Image files
  • etc.

Move Project (project-move)

Move a project with all its files to a new location and clean up the source:

# Basic move
realpremiere project-move myproject.prproj archive/

# Move with organized structure
realpremiere project-move -o myproject.prproj archive/
realpremiere project-move --organize myproject.prproj archive/

What it does:

1. Copies all project files to the destination
2. Updates paths in the .prproj file
3. Deletes original files and project
4. Removes empty source folder (if empty)
5. Logs any deletion errors to move-log.txt

🔧 Options

| Option | Alias | Description | Commands | |--------|-------|-------------|----------| | --human | -h | Show human-readable sizes | project-sizes | | --organize | -o | Organize files by extension in subfolders | project-dump, project-move |

💡 Examples

Analyze a project

# Get project size
realpremiere project-size ~/Documents/MyProject.prproj

# List all files
realpremiere project-files ~/Documents/MyProject.prproj

# Show detailed statistics
realpremiere project-sizes -h ~/Documents/MyProject.prproj

Backup a project

# Simple backup
realpremiere project-dump MyProject.prproj ./backups/MyProject_Backup/

# Organized backup (files sorted by extension)
realpremiere project-dump -o MyProject.prproj ./backups/MyProject_Backup/

Migrate a project

# Move project to external drive
realpremiere project-move MyProject.prproj /Volumes/ExternalDrive/Projects/

# Move and organize
realpremiere project-move -o MyProject.prproj /Volumes/ExternalDrive/Projects/

Using with folders

# Auto-detect .prproj file in folder
realpremiere project-size ./my-project-folder/

# Works with all commands
realpremiere project-dump ./my-project-folder/ ./backup/

🛠️ How It Works

Project File Format

Adobe Premiere Pro .prproj files are actually gzip-compressed XML files. RealPremiere:

1. Decompresses the .prproj file
2. Parses the XML to find file references
3. Extracts absolute and relative paths
4. Resolves relative paths based on project location
5. Verifies file existence on disk
6. Performs requested operations

Smart Path Detection

The tool intelligently finds file paths in the XML by looking for:

• FilePath, ActualMediaFilePath, ConformedAudioPath
• PeakFilePath, RelativePath, Path
• And other Premiere-specific XML tags

Auto-Discovery

When you provide a folder instead of a file:

• ✅ Single .prproj file found → Uses it automatically
• ❌ No .prproj files found → Error
• ❌ Multiple .prproj files found → Error (specify exact file)

📊 Output

Standard Output (stdout)

Clean data output suitable for piping:

• File paths
• Size calculations
• Statistics

Error Output (stderr)

Progress bars, messages, and headers:

• Copy/delete progress
• Status messages
• Errors and warnings

This separation allows you to pipe data without noise:

realpremiere project-files myproject.prproj | grep ".mp4"

🔄 Updating

Check for updates and install the latest version:

# Check if update is available
realpremiere check-update

# Update to latest version
realpremiere software-upgrade

⚠️ Important Notes

1. Destination Folder: Must not exist (safety feature to prevent overwrites)
2. File Existence: Only processes files that actually exist on disk
3. Duplicate Names: Automatically handles duplicate filenames with suffixes
4. Empty Folders: project-move removes empty source folders after successful move
5. Error Logging: Move operation logs deletion errors to move-log.txt

🐛 Troubleshooting

Permission Denied Error

If you get a permission error:

chmod +x /path/to/realpremiere/index.js

Multiple Projects in Folder

If you get "Multiple .prproj files found", specify the exact file:

realpremiere project-size ./folder/specific-project.prproj

Files Not Found

The tool only processes files that:

• Are referenced in the project XML
• Actually exist on disk
• Have valid paths (absolute or resolvable relative paths)

📝 License

MIT © Fabio Gatto

🤝 Contributing

Contributions, issues, and feature requests are welcome!

👤 Author

Fabio Gatto

• Email: [email protected]

🌟 Show Your Support

Give a ⭐️ if this project helped you!