MediaToolSwift

Advanced media converter for Apple devices

Requirements

• macOS 12.0+
• iOS 15.0+
• tvOS 15.0+
• Mac Catalyst 15.0+
• visionOS 1.0+
• Xcode 16.0+

Installation

Swift Package Manager

To install library with Swift Package Manager, add the following code to your Package.swift file:

dependencies: [
    .package(url: "https://github.com/starkdmi/MediaToolSwift.git", .upToNextMajor(from: "2.1.0"))
]

CocoaPods

To install library with CocoaPods, add the following line to your Podfile file:

pod 'MediaToolSwift'

Upgrading from 1.x? See the migration guide.

VideoTool

Video compressor focused on:

• Multiple video and audio codecs
• Lossless
• HDR content
• Alpha channel
• Slow motion
• Metadata
• Hardware Acceleration
• Progress and cancellation

Features

Convert	Resize	Crop	Cut	Rotate, Flip, Mirror	Frame Processing*	FPS	Thumbnail	Info
✔️	✔️	✔️	⭐️	⭐️	✔️	✔️	✔️	✔️

⭐️ - do not require re-encoding (lossless)

Supported video codecs:

• H.264
• H.265/HEVC
• ProRes
• JPEG

Additionally decoding is supported for: H.263, MPEG-1, MPEG-2, MPEG-4 Part 2

Supported audio codecs:

• AAC
• Opus
• FLAC
• Linear PCM
• Apple Lossless

Example:

// Optional task for progress and cancellation
let task = CompressionTask(destination: URL(fileURLWithPath: "output.mov"))

// Observe progress
let observation = task.progress.observe(\.fractionCompleted) { progress, _ in
    print("Progress", progress.fractionCompleted)
}

// Run video compression
let info = try await VideoTool.convert(
    source: URL(fileURLWithPath: "input.mp4"),
    destination: URL(fileURLWithPath: "output.mov"),
    // Video
    fileType: .mov, // mov, mp4, m4v
    videoSettings: .init(
        codec: .hevc,
        bitrate: .value(2_000_000), // optional
        size: .fit(.hd), // size to fit or fill
        // quality, fps, alpha channel, profile, color primary, atd.
        edit: [
            .cut(from: 2.5, to: 15.0), // cut, in seconds
            .rotate(.clockwise), // rotate
            // crop, flip, mirror, atd.

            // modify video frames as images or access pixel buffers
            .process(.image { image, _, _ in
                image.applyingGaussianBlur(sigma: 7)
            })
        ]
    ),
    optimizeForNetworkUse: true,
    // Audio
    skipAudio: false,
    audioSettings: .init(
        codec: .opus,
        bitrate: .value(96_000)
        // quality, sample rate, volume, atd.
    ),
    // Metadata
    skipSourceMetadata: false,
    customMetadata: [],
    copyExtendedFileMetadata: true,
    // File options
    overwrite: false,
    deleteSourceFile: false,
    task: task
)
print("Done: \(info.url.path)")

// Cancel compression
task.cancel()

Complex example can be found in this directory.

ImageTool

Image converter focused on:

• Popular image formats
• Animated image sequences
• HDR content
• Metadata
• Orientation
• Multiple Frameworks

Features

Convert	Resize	Crop	Rotate, Flip, Mirror	Image Processing	FPS	Info
✔️	✔️	✔️	✔️	✔️	✔️	✔️

Supported image formats:

• HEIF
• HEIF 10-bit
• HEIC
• HEICS (HEIFS) ✨
• PNG ✨
• GIF ✨
• JPEG
• TIFF
• BMP
• JPEG 2000
• OpenEXR
• ICO
• PDF

Additionally decoding is supported for: WebP ✨, AVIF and others

✨ - support animated image sequences

Example:

let info = try ImageTool.convert(
    source: URL(fileURLWithPath: "input.webp"),
    destination: URL(fileURLWithPath: "output.png"),
    settings: .init(
        format: .png,
        size: .fit(.fhd), // size to fit in
        // size: .crop(options: .init(size: CGSize(width: 512, height: 512), aligment: .center)), // or cropping area
        // quality, frame rate, background color, atd.
        edit: [
            .rotate(.clockwise), // rotate and crop
            // .rotate(.angle(.pi/4), fill: .blur(kernel: 55)), // rotate extend blurred
            // .rotate(.angle(.pi/4), fill: .color(alpha: 255, red: 255, green: 255, blue: 255)), // rotate extend with color
            // flip, mirror, atd.

            // modify image frame(s)
            .imageProcessing { ciImage, cgImage, _, _ in
                guard let ciImage = ciImage else { return (ciImage, cgImage) }
                return (ciImage.applyingGaussianBlur(sigma: 7), nil)
            }
        ]
    )
)

AudioTool

Audio converter focused on:

• Multiple audio formats
• Lossless
• Metadata
• Hardware Acceleration
• Progress and cancellation

Features

Convert	Cut	Info
✔️	⭐️	✔️

⭐️ - do not require re-encoding (lossless)

Supported audio formats:

• AAC
• Opus
• FLAC
• Linear PCM
• Apple Lossless

Supported audio file containers are M4A, WAV, CAF, AIFF, AIFC, AMR

Example:

let task = CompressionTask(destination: URL(fileURLWithPath: "output.m4a"))

// Observe progress
let observation = task.progress.observe(\.fractionCompleted) { progress, _ in
    print("Progress", progress.fractionCompleted)
}

// Run audio conversion
let info = try await AudioTool.convert(
    source: URL(fileURLWithPath: "input.mp3"),
    destination: URL(fileURLWithPath: "output.m4a"),
    // Audio
    fileType: .m4a,
    settings: .init(
        codec: .flac,
        bitrate: .value(96_000)
        // quality, sample rate, volume, atd.
    ),
    edit: [
        .cut(from: 2.5, to: 15.0), // cut, in seconds
    ],
    // Metadata
    skipSourceMetadata: false,
    customMetadata: [],
    copyExtendedFileMetadata: true,
    // File options
    overwrite: false,
    deleteSourceFile: false,
    task: task
)
print("Done: \(info.url.path)")

// Cancel conversion
task.cancel()

Documentation

Swift DocC documentation is hosted on Github Pages

Use those links for more info on video, image and audio features and operations.

Flutter

MediaToolSwift is available in Flutter via media_tool_flutter plugin.

Media Tool

There is a standalone macOS application based on MediaToolSwift source, more info can be found at mediatool.pro