0.2.8

New Features

• Added unique icon image for captions (#8)

Changes

• Renamed icon image filenames to improve clarity and alphabetical sorting (#72)
• Removed --exclude-exclusive-roles CLI flag (#5)
  As an alternative, users can sort and filter by Clip Type manifest field after extraction.

Refinements

• Improved accuracy for parsing roles from complex timelines
• Default roles encoded lowercase in FCPXML will now be title-cased to match FCP (#66)

0.2.7

New Features

• Added --markers-source CLI flag, allowing import of markers and/or captions (#8)

0.2.6

New Features

• MarkersExtractor.extract() now returns result information (#68)
• Added result file JSON key outputFolder containing the final output path of the extracted files (#67)
• Added result file JSON key profile containing the profile identifier for the profile that was used (#67)

Changes

• Changed --done-filename filename to --result-file-path path (#67)
• Removed --create-done-file flag as it is now redundant. (#67)
  If --done-file-path is specified, a result file will be written to disk and if not specified, none will be written.
• Renamed result file JSON key csvPath to csvManifestPath
• Renamed result file JSON key jsonPath to jsonManifestPath

0.2.5

Changes

• Markers within compound clips are now discarded (#7)
• Renamed "Type" manifest field to "Marker Type" (#63)
• Added "Clip Type" manifest field (#62)
• Removed "Clip Filename" manifest field (#65)

Bug Fixes

• Fixed bug where image generation could fail when project start time was later than 00:00:00:00 (#37)

0.2.4

Changes

• Markers exactly on clip boundaries are now considered within clip bounds (#56)
• Output folder name is now uniqued if it already exists instead of aborting process (#35)

Refinements

• Substantial internal refactors to the FCPXML parser, which fixes several bugs and increases maintainability

0.2.3

New Features

• Added --no-progress CLI flag to suppress progress output to console (#31)

Bug Fixes

• Resolved issue where CLI was not outputting progress to the console in a release build (#31)
• Performance and reliability improvements for thumbnail image generation (#49)

0.2.2

Refinements

• Progress reporting is now more relevant and reliable (#31)

Bug Fixes

• Fixed hang during thumbnail image generation on Intel systems (#53)
• Fixed potential crash when media contains fewer frames than required to produce an animated GIF

0.2.1

⚠️ Note: A bug was discovered in this release that causes the tool to hang on Intel machines

General

• Updated README and added new icon thanks to Bor Jen Goh

New Features

• Thumbnail image generation is now multithreaded to improve performance (#49)
• CLI now outputs progress percentage to the console (#31)

Library Refinements

• Added async/await support (#49)
• Errors thrown now provide more granular error cases (#46)
• MarkersExtractor now conforms to ProgressReporting (#31)
• Most concrete types now conform to Sendable
• Internal refactors and improvements

0.2.0

General

• Major internal refactors to improve reliability and scalability for possible future formats and feature additions
• Unit tests added with automated GitHub CI

New Features

• Default done file renamed to done.json and content is now JSON formatted (#2)
• Added --exclude-exclusive-roles <video, audio> CLI flag (#5)
• Markers that share the same ID will gain unique incrementing number suffixes by default (#9)
• Markers are now sorted chronologically by timecode (#10)
• Added --label-hide-names CLI flag to hide label names on thumbnail images (#16)
• Added --done-filename <filename> CLI argument to customize done filename (#17)
• Added --media-search-path <path> argument to allow custom media search path(s) (#20)
• Added Airtable export profile (--export-format airtable) (#21)
• Added MIDI file export profile (--export-format midi) (#23)
• Added --enable-subframes CLI flag to show subframes in all timecode strings (#29)
• Added --include-outside-clip-boundaries CLI flag (#34)
• Added --folder-format CLI flag (#35)
• Added --no-media CLI flag (#40)
• Added JSON manifest file output in addition to CSV (#44)

Refinements

• --id-naming-mode and --label CLI arguments now take short-form label IDs (#15)
• Empty roles with no default role receive placeholder role (#33)
• Redundant subroles are now stripped in metadata output (#33)
• Parsing marker locations is now more reliable (#34)

Bug Fixes

• Correctly supports all FCP frame rates (including drop frame) (#3)
• Library name is now URL decoded and stripped of file extension (#13)
• Markers outside of clip bounds now correctly log a warning (#34)

0.2.0-alpha-20230425.0

Alpha release for testing.