TimecodeKit

[!IMPORTANT]
This bumps the minimum requirement for AVFoundation methods to macOS 12, iOS 15, tvOS 15, watchOS 8.
The requirements are only bumped for AVFoundation-specific methods. The core TimecodeKit functionality requirements remain the same as before.

Improvements

• Modernized the library: Migrated all AVAsset and AVAssetTrack methods to Swift Concurrency

Added

• Timecode.StringFormat: Added Identifiable and Sendable conformances
• Timecode: Added UTType static constants
• Timecode: Added Transferable conformance (conditionally available on supported platform versions)
• Timecode: Added NSItemProvider encoding and decoding methods

Maintenance

• Updated docs with fixes and usage guide for the newly-added UTType/Transferable/NSItemProvider features
• Improved unit test performance for some slow tests

Added

• Fraction: Added stringValue property

Improvements

• Added Identifiable conformance to all relevant types

Improvements

• Improved AVAsset add/replace timecode track reliability
• Fixed rare compiler error on build pipelines using old minimum platform versions

Added

• Fraction: Added * and / math operators between two instances (#71)

Added

• Timecode: Added base parameter to converted(to:) instance method (to convert to a new sub-frames base if needed)

Added

• TimecodeInterval: Added init(realTime: TimeInterval)
• Fraction: Added Sendable conformance
• Timecode.Properties: Added Sendable conformance
• Timecode.UpperLimit: Added Sendable conformance

Improvements

• Fraction: Changed Equatable behavior to compare reduced values and not literal values
• Fraction: init(fcpxmlString:) no longer reduces fraction implicitly
• Fraction: fcpxmlStringValue property no longer reduces fraction implicitly

• Fraction: Added zero static constructor
• Fraction: Added Comparable conformance
• Fraction: Added + and - math operators between instances

• Fraction: Fixed bug where fraction might not normalize
• Fraction: Improved conversion from Double
• Fraction: Added init?(double:decimalPrecision:)
• Fraction: Added decimalValue property
• Fraction: Added isWholeInteger property
• Fraction: Added init?(fcpxmlString:) and fcpxmlStringValue property
  This can init from and produce strings formatted like "60s" or "1125/500s"
• Updated unit tests

• Fixed bug where performing math between two Timecode instances with different frame rates would produce incorrect results
• Timecode description now includes subframes for better debugging

• Added Sendable conformance to all concrete types

Fixes

• Timecode: Fixed potential overflow/underflow crash when raw component value(s) were very large

• Resolved an issue that could prevent app archival

• Hotfix release for regressions.

TimecodeKit 2.0.0

• New cleaner, more consistent API
• New DocC documentation
  • Browsable online
  • Buildable in Xcode's IDE to browse in Xcode's documentation browser
• Minor improvements and fixes

For previous users of TimecodeKit 1.x, see the 2.x Migration Guide for details.

Fixes

• Fixed visionOS 1.0 build

TimecodeKit 2: Coming Soon

Note: This is the last release of TimecodeKit 1.x before the forthcoming TimecodeKit 2 which maintains the same functionality but brings improved API and ease-of-use going forward.

Fixes

• Fixed visionOS 1.0 beta (xrOS) build

Improvements

• AVMutableMovie: add and replace Timecode Track methods allow omitting duration parameter to auto-detect video duration (#59)

• AVAssetTrack: Added durationTimecode() method
• CMTimeRange: Added timecodeRange() method

New

• Added Feet+Frames conversion support (Avid / Pro Tools 35mm 4-perf standard)

  • New FeetAndFrames struct
  • Added related Timecode init and feetAndFramesValue property

• Timecode / TimecodeFrameRate: Added 96 fps & 95.904 fps (96/1.001) (#57)

• VideoFrameRate: Added 96p & 95.9p (#57)

• VideoFrameRate: Added 59.94i

Improvements

• Timecode.SubFramesBase: Added Identifiable conformance
• VideoFrameRate: Added strict: Bool = false parameter to init(fps:interlaced:)

Fixes

• VideoFrameRate: Fixed typo in _59_94p.stringValue string value

AVFoundation Related

It is now possible to fully read, mutate, and create timecode tracks in supported video file formats (.mov, .mp4).

• AVAsset: Improved resiliency of reading timecode
• AVMutableMovie
  • Added addTimecodeTrack(startTimecode:duration:extensions:fileType:)
  • Added replaceTimecodeTrack(startTimecode:duration:extensions:fileType:)
• Timecode: Added cmFormatDescription(extensions:)

In a future release, some of the AVAsset methods will be improved to handle AVAsset timecode tracks with multiple samples (ie: not just a start timecode and total duration, but subranges as well if the track contains edit segments). For the time being, all origin timecodes are returned for timecode tracks without ranges. The first of which is the start timecode which is most important.

Timecode Comparison and Sorting

• Timecode: Added compare(to:timelineStart:) method to return ComparisonResult
• Collection of Timecode: Added mutating sort(ascending:timelineStart:)
• Collection of Timecode: Added sorted(ascending:timelineStart:) -> [Timecode]
• Collection of Timecode: Added isSorted(ascending:timelineStart:) -> Bool
• Added new TimecodeSortComparator

Misc

• Timecode: Added isZero property
• Timecode.FrameCount: Added isZero property
• Timecode.FrameCount.Value: Added isZero property
• Readme updated
• Unit tests updated