oximedia-aaf

Advanced Authoring Format (AAF) support for OxiMedia — SMPTE ST 377-1 compliant reading and writing for professional post-production workflows.

Part of the oximedia workspace — a comprehensive pure-Rust media processing framework.

Features

• Full SMPTE ST 377-1 (AAF Object Specification) support
• SMPTE ST 2001 (AAF Operational Patterns) support
• Microsoft Structured Storage (compound file) parsing
• Complete object model: Mobs, Segments, Components, Effects, Operation Groups
• Dictionary support with extensibility for class/property/type definitions
• Essence reference handling (embedded and external)
• Timeline and edit rate management
• Metadata preservation and export
• Conversion to OpenTimelineIO and EDL formats
• Read and write capability
• No unsafe code

Usage

Add to your Cargo.toml:

[dependencies]
oximedia-aaf = "0.1.1"

use oximedia_aaf::{AafFile, AafReader};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Open an AAF file
    let mut reader = AafReader::open("timeline.aaf")?;
    let aaf = reader.read()?;

    // Access composition mobs
    for comp_mob in aaf.composition_mobs() {
        println!("Composition: {}", comp_mob.name());
        for track in comp_mob.tracks() {
            println!("  Track: {}", track.name);
        }
    }
    Ok(())
}

API Overview

Core types:

• AafReader — Opens and parses AAF compound files
• AafFile — Top-level AAF file representation
• CompositionMob, Track, SourceClip, Sequence — Object model
• EdlExporter, XmlExporter — Export to EDL and OpenTimelineIO
• Timeline, TimelineClip, TimelineTrack — Timeline abstraction

Modules (29 source files, 853 public items):

• structured_storage — Microsoft Structured Storage compound file parser
• dictionary — AAF class/property/type definitions
• essence, media_data, media_file_ref — Media essence references
• composition_mob, composition — Composition mob types
• descriptor, object_model — AAF object model
• effects, effect_def, operation_group, parameter — Effect handling
• mob_slot, source_clip, selector, scope — Timeline building blocks
• interchange — Data interchange structures
• property_value — Property value handling
• metadata — Metadata structures
• convert — Format conversion utilities
• aaf_export — AAF export functionality
• writer — AAF file writer

License

Apache-2.0 — Copyright 2024-2026 COOLJAPAN OU (Team Kitasan)