CodeBrix.VideoPlayback.Dav1d.BsdLicenseForever 1.0.252.1241

CodeBrix.VideoPlayback.Dav1d

AV1 video decoding for CodeBrix.VideoPlayback, for applications that play AV1 video files. CodeBrix.VideoPlayback.Dav1d binds the dav1d AV1 decoder, and is provided as a .NET 10 library and associated CodeBrix.VideoPlayback.Dav1d.BsdLicenseForever NuGet package.

CodeBrix.VideoPlayback.Dav1d supports applications and assemblies that target Microsoft .NET version 10.0 and later. Microsoft .NET version 10.0 is a Long-Term Supported (LTS) version of .NET, and was released on Nov 11, 2025; and will be actively supported by Microsoft until Nov 14, 2028. Please update your C#/.NET code and projects to the latest LTS version of Microsoft .NET.

Installation

dotnet add package CodeBrix.VideoPlayback.Dav1d.BsdLicenseForever

Note that the NuGet package ID and the namespace are different - there is no package named plain CodeBrix.VideoPlayback.Dav1d:

• NuGet package ID: CodeBrix.VideoPlayback.Dav1d.BsdLicenseForever
• Assembly and primary namespace: CodeBrix.VideoPlayback.Dav1d - i.e. using CodeBrix.VideoPlayback.Dav1d;

XML documentation (IntelliSense) ships alongside the assembly.

The package pulls in the following automatically; no version pinning is needed in the consuming project:

• CodeBrix.VideoPlayback.MitLicenseForever - the playback session, the container readers and the frame-buffer pool. It brings CodeBrix.Audio.MitLicenseForever with it for the audio side.

The native decoder libraries for all seven supported platforms travel inside this package, so there is no native-asset package to add.

Two packages this one does NOT bring, and an application usually needs:

• A PRESENTER, to draw the decoded frames - CodeBrix.VideoPlayback.Skia.MitLicenseForever for a SkiaSharp application, or the CodeBrix.Platform video player element. Without one, frames are decoded and never shown.
• CodeBrix.Audio.Opus.BsdLicenseForever, when the files carry Opus audio. Vorbis audio needs nothing extra.

CodeBrix.VideoPlayback.Dav1d supports:

• AV1 decoding for WebM, Matroska and the .cbv container, wherever CodeBrix.VideoPlayback can read them
• Native decoder libraries for seven platforms - Windows x64 and ARM64, macOS Intel and Apple Silicon, and Linux x64, ARM64 and RISC-V 64 - found automatically, whether an application publishes for one runtime or for none
• A zero-copy frame path: the decoder writes decoded pictures straight into the playback session's own frame-buffer pool, so there is no copy between the decoder's output and a graphics upload, and no buffer allocation at all once playback is warm
• A sequence-header probe - Dav1dDecoderFactory.TryProbe - describing a stream's dimensions, layout, bit depth and colour before a single frame is decoded, so a host can size its surface first
• 8, 10 and 12-bit content, in 4:2:0, 4:2:2, 4:4:4 and monochrome, with film grain synthesised by the decoder and HDR metadata carried through to the frame
• Decoded output checked against AV1 conformance streams covering 8-bit and 10-bit, 4:2:0 and 4:4:4, an odd frame size, and film grain both applied and not
• One registration call - CodeBrixVideoPlaybackDav1d.Register() - after which nothing else in an application ever names a decoder type

What this package does not do

No hardware decoding: this is a software decoder, with no VA-API, VideoToolbox or D3D11 path. No other codec - AV1 and nothing else. No encoding. No drawing or colour conversion: frames come out as planar YUV with their colour metadata attached, so an application also needs a presenter to put them on a screen. No container reading either - that is CodeBrix.VideoPlayback's work; this package sees packets, never files.

Sample Code

Register the decoder and play a file

using CodeBrix.VideoPlayback;
using CodeBrix.VideoPlayback.Dav1d;

CodeBrixVideoPlaybackDav1d.Register();      // once, at start-up

VideoPlaybackSession session = new VideoPlaybackSession();
session.Open("clip.webm");
session.Play();

That is the whole of the integration. CodeBrix.VideoPlayback ships no video decoder of its own - a decoder brings a licence and a set of native binaries that not every application wants - so an application that plays AV1 references this package and makes one call.

Describe a stream before anything is decoded

using CodeBrix.VideoPlayback;
using CodeBrix.VideoPlayback.Dav1d;
using CodeBrix.VideoPlayback.Decoding;

session.Open("clip.webm");

if (Dav1dDecoderFactory.TryProbe(session.VideoTrack.CodecPrivate.Span, out VideoStreamInfo info))
{
    // info.Width, info.Height, info.BitDepth, info.Layout, info.Color,
    // info.MaxSampleValue (255, 1023 or 4095), info.ChromaShiftX/Y
    AllocateSurface(info.Width, info.Height);
}

The probe reads a sequence header, so it reports the stream's CODED picture size. A render size that differs from it - the size a player would scale to - is carried on the decoded frames, and only appears once frames arrive.

Lowest latency for a short clip

using CodeBrix.VideoPlayback;
using CodeBrix.VideoPlayback.Dav1d;

VideoPlaybackOptions options = new VideoPlaybackOptions
{
    DecoderOptions = new Dav1dDecoderOptions
    {
        MaxFrameDelay = 1,   // first frame out as soon as it is decoded
        Threads = 2,
    },
};

VideoPlaybackSession session = new VideoPlaybackSession(options);

Documentation

The NuGet package includes AGENT-README.txt, a complete API reference and usage guide written for AI coding agents - point your agent at that file when it is writing code against this library.

This package decodes AV1 and nothing else. Opening files, demuxing, timing, audio and presenting frames belong to CodeBrix.VideoPlayback.MitLicenseForever; read that package's own AGENT-README.txt for the session, container and presenter model.

Additional sample code and usage examples are available in the CodeBrix.VideoPlayback.Dav1d.Tests project: https://github.com/ellisnet/CodeBrix.VideoPlayback.Dav1d/tree/main/tests/CodeBrix.VideoPlayback.Dav1d.Tests

License

CodeBrix.VideoPlayback.Dav1d is licensed under the BSD 2-Clause License - see the LICENSE file.

For licensing and provenance information about the open source code included in this package, see THIRD-PARTY-NOTICES.txt.