FFmpegVideoPlayer.Avalonia 2.1.7

FFmpegVideoPlayer.Avalonia

Self-contained FFmpeg video player for Avalonia UI. FFmpeg libraries bundled - no installation required.

Installation

dotnet add package FFmpegVideoPlayer.Avalonia

Quick Start

Program.cs:

using Avalonia.FFmpegVideoPlayer;

public static void Main(string[] args)
{
    FFmpegInitializer.Initialize();
    BuildAvaloniaApp().StartWithClassicDesktopLifetime(args);
}

App.axaml:

<Application.Styles>
    <FluentTheme />
    <materialIcons:MaterialIconStyles />
</Application.Styles>

MainWindow.axaml:

<ffmpeg:VideoPlayerControl />

Try the Example

git clone https://github.com/jojomondag/FFmpegVideoPlayer.Avalonia.git
cd FFmpegVideoPlayer.Avalonia/examples/FFmpegVideoPlayerExample
dotnet run

Properties

Methods

Events

PlaybackStarted · PlaybackPaused · PlaybackStopped · MediaEnded

Control-less Usage (Custom UI)

For advanced scenarios like live wallpapers or custom video UIs, you can use FFmpegMediaPlayer directly and build your own controls:

using Avalonia.FFmpegVideoPlayer;

// Initialize FFmpeg once at startup
FFmpegInitializer.Initialize();

// Create player instance
var player = new FFmpegMediaPlayer();

// Subscribe to events
player.FrameReady += (s, e) =>
{
    // e.Data contains BGRA pixel data
    // e.Width, e.Height, e.Stride for frame dimensions
    // Render to your own Image control or OpenGL surface
};

player.PositionChanged += (s, e) => 
{
    // e.Position is 0.0 to 1.0
    // Update your custom seek bar
};

player.Playing += (s, e) => { /* Update UI */ };
player.Paused += (s, e) => { /* Update UI */ };
player.EndReached += (s, e) => { /* Handle loop or next video */ };

// Control playback
player.Open("video.mp4");
player.Play();
player.Pause();
player.Seek(0.5f); // Seek to 50%
player.Volume = 75; // 0-100

// Properties
bool isPlaying = player.IsPlaying;
long durationMs = player.Length;
float position = player.Position; // 0.0 to 1.0

// Cleanup
player.Dispose();

Minimal Control-less Example

<ffmpeg:VideoPlayerControl ShowControls="False" 
                           ShowOpenButton="False"
                           VideoBackground="Transparent"
                           Source="background.mp4"
                           AutoPlay="True" />

Platform Support

License

MIT