---
title: "onemedia docs"
url: https://recursiveai.org/onemedia/docs/
description: "Everything about OneMedia: getting started, how MP4 and Matroska files are read, tags, the common view and capture facts, codec headers, the OneAudio…"
version: "0.1.0-preview.1"
---

# onemedia docs

Everything about OneMedia: getting started, how MP4 and Matroska files are read, tags, the common view and capture facts, codec headers, the OneAudio adapter, and how each claim is checked. OneMedia is a preview, 0.1.0-preview.1. It reads containers and decodes nothing.

## Start

- [Getting started](https://recursiveai.org/onemedia/docs/getting-started/index.md): Install OneMedia 0.1.0-preview.1 for .NET 10, open an MP4 or a Matroska file, and read its tracks, codecs, tags and capture facts. OneMedia reads media…
- [Overview](https://recursiveai.org/onemedia/docs/overview/index.md): The goal is the depth of libavformat, GPAC, mkvtoolnix, MediaInfo and ExifTool in one library you can call from C#: demux and mux, lossless tag editing…

## Containers

- [MP4, MOV and 3GP](https://recursiveai.org/onemedia/docs/isobmff/index.md): How RecursiveAI.OneMedia.IsoBmff reads these files. Specifications: ISO/IEC 14496-12 (clause numbers in the code comments), the QuickTime File Format…
- [Matroska and WebM](https://recursiveai.org/onemedia/docs/matroska-differential/index.md): How RecursiveAI.OneMedia.Matroska reads these files and how the result is compared with other implementations. Specifications: RFC 8794 (EBML), RFC 9559…
- [Codec headers](https://recursiveai.org/onemedia/docs/codecs/index.md): Behaviour of RecursiveAI.OneMedia.Codecs.*: header parsing and repackaging only. No sample is decoded or encoded.

## Tags and facts

- [Tags and capture facts](https://recursiveai.org/onemedia/docs/tags/index.md): How RecursiveAI.OneMedia.Tags and RecursiveAI.OneMedia.Metadata read the tags of ISO base media files (MP4, MOV, 3GP) and Matroska/WebM, and what the…
- [Tag mapping](https://recursiveai.org/onemedia/docs/tag-mapping/index.md): How the common tag view picks values from the native tag systems. The table is the one the code reads (TagMappingTable.Rows); this page is generated from…

## Audio

- [OneAudio adapter](https://recursiveai.org/onemedia/docs/audio-adapter/index.md): The adapter presents an audio track of any container OneMedia opens (ISO base media, Matroska/WebM) as a OneAudio IPacketSource, registers the two formats…

## How it is checked

- [Differential and I/O harness](https://recursiveai.org/onemedia/docs/harness/index.md): How the readers are checked against reference tools, and how probe cost is measured. The code is the console app tools/OneMedia.Oracles plus the scripts…
- [Benchmarks](https://recursiveai.org/onemedia/docs/bench/index.md): bench/OneMedia.Bench measures OneMedia against managed comparators and prints the ratio, allocations and memory for each row. It is a console app, not…
- [Speed run: x64](https://recursiveai.org/onemedia/docs/bench-x64/index.md): The 0.1 speed run on x64 (AMD Ryzen 9 7950X3D, Linux): every file, implementation, median time, ratio, allocations and memory, the reference tools’ wall times, and the rows against the bar.
- [Speed run: arm64](https://recursiveai.org/onemedia/docs/bench-arm64/index.md): The 0.1 speed run on arm64 (Apple M2, macOS): every file, implementation, median time, ratio, allocations and memory, the reference tools’ wall times, and the rows against the bar.

## Reference

- [Changelog](https://recursiveai.org/onemedia/docs/changelog/index.md): All notable changes are recorded here. The format follows Keep a Changelog, and versions follow Semantic Versioning.

## Cookbook

- [All recipes](https://recursiveai.org/onemedia/cookbook/index.md): 10 short, task-first recipes with complete code.