final-cut-pro
Reference for generating Apple Final Cut Pro FCPXML files, covering timeline structures, media assets, effects, and project automation for FCP 10.4+.
Introduction
This skill provides a comprehensive reference for Apple Final Cut Pro XML (FCPXML) format, specifically designed for developers and video editors automating project generation. It facilitates the programmatic creation of Final Cut Pro libraries, events, and projects by providing battle-tested patterns for XML structure and element hierarchy. Whether you are generating complex multi-track timelines, integrating external media assets, or applying transitions and video effects, this skill offers the precise schema syntax required for compatibility with Final Cut Pro 10.4 through 10.7.
- Full support for FCPXML versions 1.8 through 1.11, ensuring compatibility with modern features like compound clips, roles, HDR support, and object tracking.
- Detailed templates for core project elements including format definitions, asset mapping, spine construction, and clip timing (offset, start, and duration controls).
- Advanced implementation guides for connected clips, picture-in-picture layering, gap management, and precise video effect transitions.
- Built-in reference for metadata features such as markers, chapter markers, to-do lists, and title/text-style handling.
- Best practices for project-level library organization, including file system paths and library bundle structures.
Usage notes and practical constraints include the necessity of defining accurate frameDuration and resolution in the format element to match sequence requirements. Users should prioritize version 1.9 for maximum broad compatibility when automating complex edit suites. The skill expects XML inputs that adhere to the fcpxml schema, outputting files that can be imported directly into Final Cut Pro for high-velocity video production. It is highly recommended to validate generated XML files against the specific FCPXML version schema to ensure proper rendering of metadata and asset references. This tool is essential for teams building video post-production pipelines that need to bypass manual interface tasks and leverage programmatic assembly of high-quality video content.
Repository Stats
- Stars
- 255
- Forks
- 31
- Open Issues
- 7
- Language
- TypeScript
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- Apr 29, 2026, 06:55 AM