Recursive AI
onemediaDocs

From ATL.NET

OneMedia 0.8.0-preview.2docs/migration/atl-net.md at 16456e4 Markdown

All onemedia docs

Basis: the ATL.NET wiki page "Usage / Code snippets" (https://github.com/Zeugma440/atldotnet/wiki/3.-Usage-_-Code-snippets, last edited 2025-08-24), fetched 2026-11-02; ATL.NET 7.19.0 is the bench comparator. Every ATL member named below appears on that page. Source was not read.

ATL's Track merges properties and tags into one object whose fields you set and Save(). OneMedia separates the file (MediaFile), its tracks (media.Tracks) and its tags (media.Tags, media.Native).

ATL.NETOneMedia
new Track(path)Media.Open(path)
track.Title, Artist, Album, Genre, Comment, Composersame names on media.Tags
track.Yearmedia.Tags.Date (string as stored); media.CaptureTime for video
track.TrackNumber, DiscNumbermedia.Tags.TrackNumber, DiscNumber (int?)
track.Duration (seconds)media.Duration (TimeSpan?), media.ExactDuration
track.Bitrate (KBps), track.ChannelsArrangement.NbChannelsmedia.Audio.BitRate (bit/s), media.Audio.Channels; also .SampleRate
track.AdditionalFields["key"]media.Native[system, key], media.Native.Find(system, key) (system named, e.g. QuickTime, ID3v2, RIFF)
track.EmbeddedPicturesmedia.Tags.Pictures; SetPicture, RemovePictures
track.Lyrics, track.Chaptersmedia.Tags.Lyrics; chapters through the native layer
track.Save()media.Save(), SaveAs(path), SaveInPlace()
Settings.ID3v2_tagSubVersion = 3not a global switch; the file's ID3v2 version is kept, a new tag is 2.4, or 2.3 through the writer option Id3v2Version (docs/tag-writing.md)
C#
using RecursiveAI.OneMedia;
using MediaFile media = Media.Open("aac.m4a");
MediaTrack audio = media.Audio!;
string summary = $"{media.Tags.Title} / {media.Tags.Album} / {audio.Audio!.Value.SampleRate} Hz / {audio.BitRate} bit/s / {media.Duration}";
C#
using RecursiveAI.OneMedia;
using RecursiveAI.OneMedia.Writing;
 
using MediaFile media = Media.Open("atl.m4a");
media.Tags.Title = "Edited";
try { media.SaveInPlace(); }
catch (PaddingRequiredException) { media.Save(); }   // no room in the file's padding: atomic replace

Differences that matter

  • No global settings. ATL's behaviour is steered by static Settings; OneMedia has none. Limits are one MediaLimits object you pass in.
  • Namespaced native keys. ATL flattens custom fields into one dictionary with prefixes (bext., info.); OneMedia keeps each system separate, so ID3v2/TXXX and QuickTime/©day never collide.
  • Saving is explicit about where bytes go: new file, atomic replace, or existing padding (see the TagLib# page).
  • Video is first-class: the same call opens MP4, MKV, AVI, TS and the audio formats ATL covers.
  • Decoding is not ATL's job either; media.Decode() in RecursiveAI.OneMedia.Audio hands the audio track to OneAudio.