---
title: "Migrating to OneMedia"
url: https://recursiveai.org/onemedia/docs/migration/
description: "One page per tool you may be coming from (FFMpegCore, ffprobe and ffmpeg; TagLib#; ATL.NET; MetadataExtractor; MediaInfo; ExifTool), each mapping its common calls or flags to OneMedia and listing where behavior differs. No shims."
version: "0.8.0-preview.2"
source: https://github.com/recursive-ai-oss/onemedia-csharp/blob/16456e4d405f037d1b029e967dfc7d028ae3a0d5/docs/migration/README.md
---

# Migrating to OneMedia

One page per tool. Each maps that tool's common tasks to OneMedia calls and says where behaviour differs. There are no shims and no
look-alike classes: OneMedia's calls are shaped by the file formats, not by another library's API.

| Coming from | Page |
|---|---|
| FFMpegCore, ffprobe, ffmpeg (`-c copy` work) | [ffmpeg-ffprobe.md](https://recursiveai.org/onemedia/docs/migration-ffmpeg-ffprobe/) |
| TagLib# | [taglib-sharp.md](https://recursiveai.org/onemedia/docs/migration-taglib-sharp/) |
| ATL.NET | [atl-net.md](https://recursiveai.org/onemedia/docs/migration-atl-net/) |
| MetadataExtractor | [metadataextractor.md](https://recursiveai.org/onemedia/docs/migration-metadataextractor/) |
| MediaInfo | [mediainfo.md](https://recursiveai.org/onemedia/docs/migration-mediainfo/) |
| ExifTool | [exiftool.md](https://recursiveai.org/onemedia/docs/migration-exiftool/) |

Every OneMedia snippet on these pages is compiled and run by `samples/OneMedia.Samples` (`Migration.cs`). The happy-path tasks of the
README are in `Tasks.cs` there, one or two lines each.

What is the same everywhere:

- **No decoding.** OneMedia reads and writes containers and tags. Anything that needs pixels or audio samples (thumbnails, scaling,
  re-encoding, filters) stays with the tool that did it; `RecursiveAI.OneMedia.Audio` decodes audio through OneAudio.
- **Typed defects, not silent repair.** A damaged file opens when it safely can and lists what is wrong on `media.Defects`, with byte offsets.
- **Evidence, not one guess.** Capture time, location and device are lists of candidates (source, raw value, interpretation, time-zone
  certainty) with a resolved value: `media.CaptureTime.Candidates`, `media.CaptureTime.Value`.
- **Writes never touch media bytes.** Tag edits go to a new file (`SaveAs`), an atomic replace (`Save`) or existing padding (`SaveInPlace`,
  which throws `PaddingRequiredException` from `RecursiveAI.OneMedia.Writing` rather than rewriting the file). The result is a report of what was written and what was refused.