FFmpegVideoPlayer.Avalonia 2.1.1

FFmpegVideoPlayer.Avalonia

A self-contained FFmpeg video player control for Avalonia UI. FFmpeg 8.x libraries are bundled - no external installation required!

✨ Features

• 🎬 Full-featured video player control
• 📦 Self-contained - FFmpeg libraries bundled in the NuGet package
• 🖥️ Cross-platform: Windows x64, macOS ARM64 (Apple Silicon)
• 🎨 Customizable appearance via XAML properties
• 🎛️ Built-in controls: Play/Pause, Stop, Seek, Volume, Mute
• ⚡ Hardware-accelerated decoding

📦 Installation

dotnet add package FFmpegVideoPlayer.Avalonia

That's it! The FFmpeg libraries are included in the package.

🚀 Quick Start

1. Add Material Icons to App.axaml

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:materialIcons="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia"
             x:Class="YourApp.App">
    <Application.Styles>
        <FluentTheme />
        <materialIcons:MaterialIconStyles />
    </Application.Styles>
</Application>

2. Initialize FFmpeg in Program.cs

using Avalonia.FFmpegVideoPlayer;

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

3. Add the Video Player to your Window

<Window xmlns="https://github.com/avaloniaui"
        xmlns:ffmpeg="clr-namespace:Avalonia.FFmpegVideoPlayer;assembly=Avalonia.FFmpegVideoPlayer"
        Title="Video Player">
    
    <ffmpeg:VideoPlayerControl />
    
</Window>

🎨 XAML Properties

All properties can be set directly in XAML:

<ffmpeg:VideoPlayerControl 
    Source="/path/to/video.mp4"
    AutoPlay="True"
    Volume="80"
    ShowControls="True"
    ShowOpenButton="False"
    ControlPanelBackground="#1a1a1a" />

Available Properties

Styling Examples

Dark themed player:

<ffmpeg:VideoPlayerControl 
    ControlPanelBackground="#1a1a1a" />

Embedded player (no file picker):

<ffmpeg:VideoPlayerControl 
    Source="C:\Videos\intro.mp4"
    AutoPlay="True"
    ShowOpenButton="False" />

Transparent controls (overlay style):

<ffmpeg:VideoPlayerControl 
    ControlPanelBackground="Transparent" />

Using theme resources:

<ffmpeg:VideoPlayerControl 
    ControlPanelBackground="{DynamicResource SystemControlBackgroundAltHighBrush}" />

💻 Programmatic Control

// Open and play a video
VideoPlayer.Open(@"C:\Videos\movie.mp4");
VideoPlayer.Play();

// Or use Source property (auto-loads)
VideoPlayer.Source = @"C:\Videos\movie.mp4";
VideoPlayer.AutoPlay = true;

// Playback control
VideoPlayer.Pause();
VideoPlayer.Stop();
VideoPlayer.Seek(0.5f);  // Seek to 50%

// Volume control
VideoPlayer.Volume = 50;
VideoPlayer.ToggleMute();

// Customize appearance
VideoPlayer.ShowOpenButton = false;
VideoPlayer.ControlPanelBackground = new SolidColorBrush(Color.Parse("#2d2d2d"));

📋 Complete Example

YourApp.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Avalonia" Version="11.3.6" />
    <PackageReference Include="Avalonia.Desktop" Version="11.3.6" />
    <PackageReference Include="Avalonia.Themes.Fluent" Version="11.3.6" />
    <PackageReference Include="FFmpegVideoPlayer.Avalonia" Version="2.0.0" />
  </ItemGroup>
</Project>

App.axaml:

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:materialIcons="clr-namespace:Material.Icons.Avalonia;assembly=Material.Icons.Avalonia"
             x:Class="YourApp.App">
    <Application.Styles>
        <FluentTheme />
        <materialIcons:MaterialIconStyles />
    </Application.Styles>
</Application>

App.axaml.cs:

using Avalonia;
using Avalonia.Markup.Xaml;

namespace YourApp;

public partial class App : Application
{
    public override void Initialize() => AvaloniaXamlLoader.Load(this);
}

Program.cs:

using Avalonia;
using Avalonia.FFmpegVideoPlayer;

namespace YourApp;

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

    public static AppBuilder BuildAvaloniaApp()
        => AppBuilder.Configure<App>()
            .UsePlatformDetect()
            .LogToTrace();
}

MainWindow.axaml:

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:ffmpeg="clr-namespace:Avalonia.FFmpegVideoPlayer;assembly=Avalonia.FFmpegVideoPlayer"
        x:Class="YourApp.MainWindow"
        Title="Video Player" Width="800" Height="600">
    
    <ffmpeg:VideoPlayerControl 
        x:Name="VideoPlayer"
        ControlPanelBackground="#2d2d2d" />
    
</Window>

📖 API Reference

Methods

Read-only Properties

Events

🌍 Platform Support

🔧 Troubleshooting

Video doesn't play:

• Ensure FFmpegInitializer.Initialize() is called before creating windows
• Check console output for FFmpeg initialization errors

No audio:

• OpenAL is required for audio. On Linux: sudo apt install libopenal1

Player shows black screen:

• Some video codecs may not be supported. Try a different video file.

📄 License

MIT License - see LICENSE for details.

🙏 Credits

• FFmpeg - Multimedia framework
• FFmpeg.AutoGen - .NET bindings
• OpenTK - Audio playback
• Material.Icons.Avalonia - UI icons