final-cut-pro
Reference and generator for Apple Final Cut Pro FCPXML. Automate timeline creation, asset management, and project structure definition for professional video workflows.
Introduction
The final-cut-pro skill provides a comprehensive reference and generation framework for FCPXML, the interchange format used by Apple Final Cut Pro 10.4 and later. Designed for developers and video editors who need to programmatically assemble video projects, this skill enables the rapid creation of complex project structures, including timelines, nested compound clips, and multi-layered media asset references. By leveraging standard XML patterns, users can bypass manual editing for repetitive tasks such as importing raw clips, positioning assets on the magnetic timeline, or applying standardized transitions and effects.
- Support for FCPXML versions 1.8 through 1.11, ensuring compatibility with modern FCP features like object tracking, HDR support, and enhanced color grading.
- Comprehensive template generation for project sequences, including format definitions for various resolutions and frame rates (e.g., 1080p, 4K, NTSC).
- Advanced clip management capabilities, such as automated spine organization, lane assignment for picture-in-picture effects, and precise offset/duration control.
- Metadata handling for marker types including standard markers, to-do items, and chapter markers, perfect for organizing complex long-form projects.
- Ready-to-use boilerplate code for library location paths, asset media-reps, and sequence structural integrity.
When using this skill, ensure your input paths for media assets are absolute to maintain valid file references within the FCP bundle. The tool is optimized for generating clean, validated XML that integrates seamlessly into FCP workflows. Use the format definitions to ensure your sequence settings match your source media, preventing unnecessary rendering or performance issues during import. Typical use cases include automating b-roll assembly for interviews, creating project templates for recurring video series, and bulk-generating timeline structures from metadata logs or external databases. Note that while this tool excels at generating structures, final color correction and manual high-level creative editing should be performed within the Final Cut Pro application interface after importing the generated XML.
Repository Stats
- Stars
- 255
- Forks
- 31
- Open Issues
- 7
- Language
- TypeScript
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- Apr 28, 2026, 12:31 PM