Avalonia.Controls.MediaPlayer 12.0.3

Prefix Reserved
dotnet add package Avalonia.Controls.MediaPlayer --version 12.0.3
                    
NuGet\Install-Package Avalonia.Controls.MediaPlayer -Version 12.0.3
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Avalonia.Controls.MediaPlayer" Version="12.0.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Avalonia.Controls.MediaPlayer" Version="12.0.3" />
                    
Directory.Packages.props
<PackageReference Include="Avalonia.Controls.MediaPlayer" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Avalonia.Controls.MediaPlayer --version 12.0.3
                    
#r "nuget: Avalonia.Controls.MediaPlayer, 12.0.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Avalonia.Controls.MediaPlayer@12.0.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Avalonia.Controls.MediaPlayer&version=12.0.3
                    
Install as a Cake Addin
#tool nuget:?package=Avalonia.Controls.MediaPlayer&version=12.0.3
                    
Install as a Cake Tool

Avalonia MediaPlayer

The Avalonia MediaPlayer component enables audio and video playback in Avalonia applications. It leverages Avalonia's composition rendering and native platform capabilities for efficient, integrated media playback.

Requirements

This package requires Avalonia Accelerate license: https://avaloniaui.net/accelerate

Quick Start

Get started quickly with the MediaPlayer component: https://docs.avaloniaui.net/accelerate/components/media-player/quickstart

Components

MediaPlayerControl Control

The MediaPlayerControl is a fully-featured UI control for media playback that provides transport controls, progress display, volume control, and video rendering. It encapsulates a MediaPlayer instance and provides a rich user interface for media playback.

<MediaPlayerControl Name="MediaPlayerControl" Source="{Binding MediaSource}" 
                    Volume="0.8"
                    LoadedBehavior="AutoPlay" />

Documentation: https://docs.avaloniaui.net/accelerate/components/media-player/mediaplayercontrol

MediaPlayer

The MediaPlayer class provides the core functionality for media playback in Avalonia applications. It handles media loading, playback control, and platform-specific backend management, serving as the engine behind the MediaPlayerControl.

It also can be used to playback audio without any UI.

// Create and initialize
var player = new MediaPlayer();
await player.InitializeAsync();

// Configure
player.Volume = 0.8;
player.LoadedBehavior = MediaPlayerLoadedBehavior.Manual;

// Load and play media
player.Source = new UriSource("https://example.com/audio.mp3");
await player.PrepareAsync();
await player.PlayAsync();

Documentation: https://docs.avaloniaui.net/accelerate/components/media-player/mediaplayer

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-android36.0 is compatible.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-ios26.0 is compatible.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
12.0.3 0 6/24/2026
12.0.2 69 6/23/2026
12.0.1 4,152 4/21/2026
12.0.0 1,883 4/7/2026
12.0.0-beta1 140 3/24/2026
11.3.11 10,281 3/13/2026
11.3.10 187 3/12/2026
11.3.9 1,609 2/11/2026
11.3.8 822 1/29/2026
11.3.7.6 1,452 1/13/2026
11.3.7.5 1,441 12/17/2025
11.3.7.4 400 12/5/2025
11.3.7.3 237 12/5/2025
11.3.7.2 981 12/3/2025
11.3.7.1 764 11/28/2025
11.3.7 248 11/28/2025
11.3.6 2,682 11/10/2025
11.3.5 4,060 10/13/2025

## 12.0.3

- Fixed a crash when rapidly attaching and detaching media player views on Linux.
- Fixed a crash during media teardown on Linux caused by a video callback running after the player was released.
- Media playback errors are now logged instead of raising unhandled exceptions.

## 12.0.2

- Fixed HLS video not rendering on macOS.
- Fixed a crash when stopping playback on Linux.
- Fixed video going blank after the first loop cycle on Linux.
- Fixed a resource leak on Windows when switching media sources.
- Added software rendering fallback on Windows when no hardware GPU adapter is present.
- Improved error reporting on Windows with more descriptive error messages.
- Improved error reporting on Android by surfacing playback exceptions.
- Added centralized logging infrastructure across all backends.

## 12.0.1

- Improved rendering stability when changing the target visual on macOS and with the VLC backend, including paused playback scenarios.
- Improved Windows Media Foundation playback reliability with fixes for frame presentation, render-thread handling, and race conditions.
- Fixed Android duration reporting for media sources that expose invalid or unavailable length values.
- Updated package compatibility for Avalonia 12.0.1 and expanded support across .NET 8 and .NET 10 targets.

## 11.3.9

- Improvements to macOS & iOS playback and concurrency guarantees. This should result in better macOS/iOS media player stability.

## 11.3.7.2

- Hotfix for VLC and Vulkan backends.