{"id":47912279,"url":"https://github.com/orchetect/swift-fcpxml","last_synced_at":"2026-04-04T05:22:30.905Z","repository":{"id":346844342,"uuid":"1182809991","full_name":"orchetect/swift-fcpxml","owner":"orchetect","description":"Read, write, and reason on FCPXML (Final Cut Pro XML) in Swift.","archived":false,"fork":false,"pushed_at":"2026-03-25T17:17:36.000Z","size":275,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-03-26T18:39:22.012Z","etag":null,"topics":["fcpxml","final-cut-pro","finalcut","finalcutpro","macos","swift","xml"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/orchetect.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"orchetect"}},"created_at":"2026-03-16T01:22:44.000Z","updated_at":"2026-03-25T17:09:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/orchetect/swift-fcpxml","commit_stats":null,"previous_names":["orchetect/swift-fcpxml"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/orchetect/swift-fcpxml","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orchetect%2Fswift-fcpxml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orchetect%2Fswift-fcpxml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orchetect%2Fswift-fcpxml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orchetect%2Fswift-fcpxml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/orchetect","download_url":"https://codeload.github.com/orchetect/swift-fcpxml/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orchetect%2Fswift-fcpxml/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31388623,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fcpxml","final-cut-pro","finalcut","finalcutpro","macos","swift","xml"],"created_at":"2026-04-04T05:22:30.300Z","updated_at":"2026-04-04T05:22:30.896Z","avatar_url":"https://github.com/orchetect.png","language":"Swift","funding_links":["https://github.com/sponsors/orchetect"],"categories":[],"sub_categories":[],"readme":"# swift-fcpxml\n\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Forchetect%2Fswift-fcpxml%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/orchetect/swift-fcpxml) [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Forchetect%2Fswift-fcpxml%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/orchetect/swift-fcpxml) [![License: MIT](http://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat)](https://github.com/orchetect/swift-fcpxml/blob/main/LICENSE)\n\nA Swift library for efficient parsing and extracting timeline events from FCPXML (Final Cut Pro XML) files, with limited authoring support.\n\nThe library is concerned with two main areas:\n\n1. Reading and authoring the FCPXML format using a fast and lightweight data model that wraps the XML objects\n2. Reasoning on FCPXML data and extracting information such as timeline events\n\n\u003e [!NOTE]\n\u003e\n\u003e The library is currently only available on macOS, which is a limitation of Apple's `XMLDocument` API. In future, this could be refactored to use FoundationXML in the Swift 6.x toolchain.\n\n\u003e [!IMPORTANT]\n\u003e\n\u003e The evolution of this library is ongoing, and as such some features may be missing or incomplete. See the [Roadmap](#Roadmap) section below.\n\n## Roadmap\n\nThe evolution of this library is ongoing, and features may be added on an as-needed basis.\n\nThis library grew out of the more focused need to parse timeline events and has gradually gained more ground in modeling the XML. Currently a substantial amount of the FCPXML DTD is modeled and traversable, but is not entirely complete - some of the more esoteric XML elements have not yet been modeled.\n\nThe model is more oriented toward reading, but limited authoring support is available and the library has been built with wider authoring support potentially being added in future in mind.\n\nThe core feature-set does allow for comprehensive reasoning on the XML in order to extract timeline events such as markers, and is being used actively in production.\n\n## Installation\n\n### Swift Package Manager (SPM)\n\nTo add this package to an Xcode app project, use:\n\n `https://github.com/orchetect/swift-fcpxml` as the URL.\n\nTo add this package to a Swift package, add it to your package dependencies:\n\n```swift\n.package(url: \"https://github.com/orchetect/swift-fcpxml\", from: \"0.1.0\")\n```\n\nThen add it to your target dependencies:\n\n```swift\n.product(name: \"SwiftFCPXML\", package: \"swift-fcpxml\")\n```\n\n## Dependencies\n\n- [swift-timecode](https://github.com/orchetect/swift-timecode) to represent timecode values and frame rates\n\n## Documentation\n\nNo formal documentation yet.\n\n## Unit Tests\n\nCore unit tests implemented. More exhaustive tests can be added in future.\n\n## Affiliation\n\nThe author(s) have no affiliation with Apple or Final Cut Pro. This library is built based on open file data format has been made publicly available by Apple. No reverse-engineering of software was involved in implementation of this library. The goal is to promote easier interoperability for developers.\n\nThe library is provided as-is with no warranties. See the [LICENSE](https://github.com/orchetect/swift-fcpxml/blob/master/LICENSE) for more details.\n\n## Author\n\nCoded by a bunch of 🐹 hamsters in a trenchcoat that calls itself [@orchetect](https://github.com/orchetect).\n\n## License\n\nLicensed under the MIT license. See [LICENSE](https://github.com/orchetect/swift-fcpxml/blob/master/LICENSE) for details.\n\n## Community \u0026 Support\n\nPlease do not email maintainers for technical support. Several options are available for issues and questions:\n\n- Questions and feature ideas can be posted to [Discussions](https://github.com/orchetect/swift-fcpxml/discussions).\n- If an issue is a verifiable bug with reproducible steps it may be posted in [Issues](https://github.com/orchetect/swift-fcpxml/issues).\n\n## Contributions\n\nContributions are welcome. Posting in [Discussions](https://github.com/orchetect/swift-fcpxml/discussions) first prior to new submitting PRs for features or modifications is encouraged.\n\n## Legacy\n\nThis repository was formerly a part of [swift-daw-file-tools](https://github.com/orchetect/swift-daw-file-tools) (previously known as DAWFileKit), and was extracted into its own repository in March 2026.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forchetect%2Fswift-fcpxml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forchetect%2Fswift-fcpxml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forchetect%2Fswift-fcpxml/lists"}