# LibVLCSharp [![Build Status](https://camo.githubusercontent.com/5c0f06e67ad37f4b7b5cba965aa6a3364164a3a16cfb4ef30c2ec55d936d87ce/68747470733a2f2f766964656f6c616e2e76697375616c73747564696f2e636f6d2f4c6962564c4353686172702f5f617069732f6275696c642f7374617475732f766964656f6c616e2e6c6962766c6373686172703f6272616e63684e616d653d6d6173746572)](https://videolan.visualstudio.com/LibVLCSharp/_build?definitionId=22) [![Join the chat at https://discord.gg/3h3K3JF](https://camo.githubusercontent.com/90283613843153dbf7b4c10bff3a450270dfb4a3873b60b91af455c05f94e008/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3731363933393339363436343530383935383f6c6162656c3d646973636f7264)](https://discord.gg/3h3K3JF) [![LibVLCSharp API Docs](https://camo.githubusercontent.com/9a135e51a20c948cedcbb3ad76af0837b6a65372258263da5b55d0b3b9c535a4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d6c6962766c6373686172702d316661656365)](https://code.videolan.org/videolan/LibVLCSharp/-/blob/3.x/docs/home.md) LibVLCSharp is a cross-platform audio and video API for .NET platforms based on VideoLAN's LibVLC Library. It provides a comprehensive multimedia API that can be used across mobile, server and desktop to render video and output audio as well as encode and stream. _The official repository URL for this repo is https://code.videolan.org/videolan/LibVLCSharp._ - [Features](https://github.com/videolan/libvlcsharp/raw/3.x/#features) - [MediaPlayerElement](https://github.com/videolan/libvlcsharp/raw/3.x/#mediaplayerelement) - [Supported platforms](https://github.com/videolan/libvlcsharp/raw/3.x/#supported-platforms) - [Installation](https://github.com/videolan/libvlcsharp/raw/3.x/#installation) - [Preview builds](https://github.com/videolan/libvlcsharp/raw/3.x/#Pre-release-versions) - [Getting started](https://github.com/videolan/libvlcsharp/raw/3.x/#getting-started) - [Documentation](https://github.com/videolan/libvlcsharp/raw/3.x/#documentation) - [Ebook](https://github.com/videolan/libvlcsharp/raw/3.x/#ebook) - [Migrating from Vlc.DotNet](https://github.com/videolan/libvlcsharp/blob/3.x/docs/migrating_from_Vlc.DotNet.md) - [Samples](https://github.com/videolan/libvlcsharp/raw/3.x/#samples) - [Quick API overview](https://github.com/videolan/libvlcsharp/raw/3.x/#quick-api-overview) - [Roadmap](https://github.com/videolan/libvlcsharp/raw/3.x/#roadmap) - [Versioning](https://github.com/videolan/libvlcsharp/raw/3.x/#versioning) - [Release Notes](https://github.com/videolan/libvlcsharp/raw/3.x/#release-notes) - [Contribute](https://github.com/videolan/libvlcsharp/raw/3.x/#contribute) - [Pull request](https://github.com/videolan/libvlcsharp/raw/3.x/#pull-request) - [Gitlab issues](https://github.com/videolan/libvlcsharp/raw/3.x/#gitlab-issues) - [Questions and Support](https://github.com/videolan/libvlcsharp/raw/3.x/#questions-and-support) - [Bug trackers](https://github.com/videolan/libvlcsharp/raw/3.x/#bug-trackers) - [Discord](https://github.com/videolan/libvlcsharp/raw/3.x/#discord) - [StackOverflow](https://github.com/videolan/libvlcsharp/raw/3.x/#stackoverflow) - [Commercial Support](https://github.com/videolan/libvlcsharp/raw/3.x/#commercial-support) - [Code of Conduct](https://github.com/videolan/libvlcsharp/raw/3.x/#code-of-conduct) - [Licenses](https://github.com/videolan/libvlcsharp/raw/3.x/#licenses) ## Features Check out [libvlc-nuget](https://code.videolan.org/videolan/libvlc-nuget) to get a basic understanding of how `libvlc` works, what it can offer and how to install it with NuGet. Some of the [features](https://www.videolan.org/vlc/features.html) include: - Play every media file formats, every codec and every streaming protocols - Run on every platform, from desktop (Windows, Linux, Mac) to mobile (Android, iOS) and TVs - Hardware and efficient decoding on every platform, up to 8K - Network browsing for distant filesystems (SMB, FTP, SFTP, NFS...) and servers (UPnP, DLNA) - Playback of Audio CD, DVD and Bluray with menu navigation - Support for HDR, including tonemapping for SDR streams - Audio passthrough with SPDIF and HDMI, including for Audio HD codecs, like DD+, TrueHD or DTS-HD - Support for video and audio filters - Support for 360 video and 3D audio playback, including Ambisonics - Able to cast and stream to distant renderers, like Chromecast and UPnP renderers. Most things you can achieve with the regular VLC desktop app, you can also achieve using `libvlc`. ### MediaPlayerElement Full featured video control for Xamarin.Forms available in LibVLCSharp.Forms (iOS/Android) and Uno platform (iOS/Android/UWP).

## Supported platforms Mono, .NET Framework and .NET Core runtimes are supported. - Xamarin.Android - Xamarin.iOS - Xamarin.tvOS - Xamarin.Mac (Cocoa) - Windows Classic (WPF, WinForms, GTK) - Windows Universal (UWP for Desktop, mobile and Xbox) - Linux including desktop, server and Raspberry Pi (GTK) - Xamarin.Forms - MAUI - Uno Platform (UWP, Android, iOS) - Avalonia (Windows, macOS, Linux) - .NET Standard 1.1 and 2.0 - .NET Framework 4.0 and later - .NET Core (including ASP.NET Core) - [Unity3D](https://code.videolan.org/videolan/vlc-unity) - Windows Classic - Android - UWP - iOS - macOS ## Installation 1. Install **LibVLC** in your platform specific project. LibVLC is the actual VLC engine written mostly in C/C++ and compiled for your target platform. More information [here](https://code.videolan.org/videolan/libvlc-nuget). | Platform | LibVLC Package | NuGet | Minimum OS Version | | ----------------- | ----------------------------------- | -------------------------------------- |--------------------| | Windows | VideoLAN.LibVLC.Windows | [![LibVLCWindowsBadge]][LibVLCWindows] | Windows XP | | UWP | VideoLAN.LibVLC.UWP | [![LibVLCWin10Badge]][LibVLCWin10] | Windows 10 | | Mac | VideoLAN.LibVLC.Mac | [![LibVLCMacBadge]][LibVLCMac] | macOS 10.7 | | Android | VideoLAN.LibVLC.Android | [![LibVLCAndroidBadge]][LibVLCAndroid] | Android 2.3 | | iOS | VideoLAN.LibVLC.iOS | [![LibVLCiOSBadge]][LibVLCiOS] | iOS 8.4 | | tvOS | VideoLAN.LibVLC.tvOS | [![LibVLCtvOSBadge]][LibVLCtvOS] | tvOS 10.2 | | Linux | [Linux guide](https://github.com/videolan/libvlcsharp/blob/3.x/docs/linux-setup.md) | N/A | N/A | ```cmd dotnet add package VideoLAN.LibVLC.[Windows|UWP|Android|iOS|Mac|tvOS] ``` 2. Install **LibVLCSharp** _or_ **LibVLCSharp.Forms** (if you plan on using Xamarin.Forms) LibVLCSharp is the .NET wrapper that consumes `LibVLC` and allows you to interact with native code from C#/F#. | Platform | LibVLCSharp Package | NuGet | | ----------------- | ----------------------------------------------- | ------------------------------------------------- | | .NET Standard | [LibVLCSharp](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp/README.md) | [![LibVLCSharpBadge]][LibVLCSharp] | | Xamarin.Android | [LibVLCSharp](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp/README.md) | [![LibVLCSharpBadge]][LibVLCSharp] | | Xamarin.iOS | [LibVLCSharp](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp/README.md) | [![LibVLCSharpBadge]][LibVLCSharp] | | Xamarin.tvOS | [LibVLCSharp](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp/README.md) | [![LibVLCSharpBadge]][LibVLCSharp] | | Xamarin.Mac | [LibVLCSharp](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp/README.md) | [![LibVLCSharpBadge]][LibVLCSharp] | | UWP | [LibVLCSharp](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp/README.md) | [![LibVLCSharpBadge]][LibVLCSharp] | | Xamarin.Forms | [LibVLCSharp.Forms][RLibVLCSharpForms] | [![LibVLCSharpFormsBadge]][LibVLCSharpForms] | | MAUI | [LibVLCSharp.MAUI][RLibVLCSharpMAUI] | [![LibVLCSharpMAUIBadge]][LibVLCSharpMAUI] | | WPF | [LibVLCSharp.WPF][RLibVLCSharpWPF] | [![LibVLCSharpWPFBadge]][LibVLCSharpWPF] | | Xamarin.Forms.WPF | [LibVLCSharp.Forms.WPF][RLibVLCSharpFormsWPF] | [![LibVLCSharpFormsWPFBadge]][LibVLCSharpFormsWPF]| | GTK | [LibVLCSharp.GTK][RLibVLCSharpGTK] | [![LibVLCSharpGTKBadge]][LibVLCSharpGTK] | | Xamarin.Forms.GTK | [LibVLCSharp.Forms.GTK][RLibVLCSharpFormsGTK] | [![LibVLCSharpFormsGTKBadge]][LibVLCSharpFormsGTK]| | Windows Forms | [LibVLCSharp.WinForms][RLibVLCSharpWinForms] | [![LibVLCSharpWinFormsBadge]][LibVLCSharpWinForms]| | Uno Platform | [LibVLCSharp.Uno][RLibVLCSharpUno] | [![LibVLCSharpUnoBadge]][LibVLCSharpUno] | | Avalonia | [LibVLCSharp.Avalonia][RLibVLCSharpAvalonia] | [![LibVLCSharpAvaloniaBadge]][LibVLCSharpAvalonia]| | Eto.Forms | [LibVLCSharp.Eto][RLibVLCSharpEto] | [![LibVLCSharpEtoBadge]][LibVLCSharpEto] | | Unity3D - Windows | [VLC for Unity (Windows)][VLCUnityStore] | [![VLCUnityBadge]][VLCUnityStore] | | Unity3D - UWP | [VLC for Unity (UWP)][VLCUnityStore] | [![VLCUnityBadge]][VLCUnityStore] | | Unity3D - Android | [VLC for Unity (Android)][VLCUnityStore] | [![VLCUnityBadge]][VLCUnityStore] | | Unity3D - iOS | [VLC for Unity (iOS)][VLCUnityStore] | [![VLCUnityBadge]][VLCUnityStore] | | Unity3D - macOS | [VLC for Unity (macOS)][VLCUnityStore] | [![VLCUnityBadge]][VLCUnityStore] | ### Pre-release versions LibVLCSharp 4 preview and LibVLC 4 nightly builds are distributed using https://feedz.io/ for now. To pull pre-release versions into your project, use the following `NuGet.config` file: ``` ``` See the docs for [preview builds installation details](https://github.com/videolan/libvlcsharp/blob/3.x/docs/libvlc_preview.md). [RLibVLCSharpForms]: src/LibVLCSharp.Forms/README.md [RLibVLCSharpMAUI]: src/LibVLCSharp.MAUI/README.md [RLibVLCSharpWPF]: src/LibVLCSharp.WPF/README.md [RLibVLCSharpFormsWPF]: src/LibVLCSharp.Forms.Platforms.WPF/README.md [RLibVLCSharpGTK]: src/LibVLCSharp.GTK/README.md [RLibVLCSharpFormsGTK]: src/LibVLCSharp.Forms.Platforms.GTK/README.md [RLibVLCSharpWinForms]: src/LibVLCSharp.WinForms/README.md [RLibVLCSharpUno]: src/LibVLCSharp.Uno/README.md [RLibVLCSharpAvalonia]: src/LibVLCSharp.Avalonia/README.md [RLibVLCSharpEto]: src/LibVLCSharp.Eto/README.md [LibVLCWindowsBadge]: https://camo.githubusercontent.com/53a21d923505fef1cb2d20195254d523f8ade3b7b6a76a60f02e3cf152a86ddc/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f566964656f4c414e2e4c6962564c432e57696e646f77732e737667 [LibVLCWindows]: https://www.nuget.org/packages/VideoLAN.LibVLC.Windows/ [LibVLCWin10Badge]: https://camo.githubusercontent.com/098dfabe9718209a0a14ce87251d74b95be26af32c97eded655c423afc2aa951/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f566964656f4c414e2e4c6962564c432e5557502e737667 [LibVLCWin10]: https://www.nuget.org/packages/VideoLAN.LibVLC.UWP/ [LibVLCMac]: https://www.nuget.org/packages/VideoLAN.LibVLC.Mac/ [LibVLCMacBadge]: https://camo.githubusercontent.com/5a5383fc7ac893d7c281bcd6edb0bcb5b657e939ae31735a464cd803eac9818c/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f566964656f4c414e2e4c6962564c432e4d61632e737667 [LibVLCAndroid]: https://www.nuget.org/packages/VideoLAN.LibVLC.Android/ [LibVLCAndroidBadge]: https://camo.githubusercontent.com/a9d7630e0a7876544ad5bebd3e6f1b9ad314179f086444fbc6a02244a777849b/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f566964656f4c414e2e4c6962564c432e416e64726f69642e737667 [LibVLCiOS]: https://www.nuget.org/packages/VideoLAN.LibVLC.iOS/ [LibVLCiOSBadge]: https://camo.githubusercontent.com/e3e6689565cdba9b5e5aa4f603e6657c465d2fe1cbc3946ad975bf9302cdd2cc/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f566964656f4c414e2e4c6962564c432e694f532e737667 [LibVLCtvOS]: https://www.nuget.org/packages/VideoLAN.LibVLC.tvOS/ [LibVLCtvOSBadge]: https://camo.githubusercontent.com/92b0c4e3bed5f10d51438255f8fb09473d9ac5716bc13629f00bf50728337a40/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f566964656f4c414e2e4c6962564c432e74764f532e737667 [LibVLCSharp]: https://www.nuget.org/packages/LibVLCSharp/ [LibVLCSharpBadge]: https://camo.githubusercontent.com/84eb17dcf0eabb02d62a1c18ef8e842dafbb1f9e8d30acb3b1d949f3cf9a860f/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e737667 [LibVLCSharpForms]: https://www.nuget.org/packages/LibVLCSharp.Forms/ [LibVLCSharpFormsBadge]: https://camo.githubusercontent.com/e406436c82a3c5e0187136fe956bb1f0017050c1077d2255ecf5765dcbac661a/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e466f726d732e737667 [LibVLCSharpMAUI]: https://www.nuget.org/packages/LibVLCSharp.MAUI/ [LibVLCSharpMAUIBadge]: https://camo.githubusercontent.com/4fb7b49ecc9ca04508b3763878d9a9577ab575e17bc29087e73539c960ac94cd/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e4d4155492e737667 [LibVLCSharpWPF]: https://www.nuget.org/packages/LibVLCSharp.WPF/ [LibVLCSharpWPFBadge]: https://camo.githubusercontent.com/0fc4479be5a37f15086d312312820ce488d9923b6d20bc39eb0fb1a32da09f68/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e5750462e737667 [LibVLCSharpFormsWPF]: https://www.nuget.org/packages/LibVLCSharp.Forms.WPF/ [LibVLCSharpFormsWPFBadge]: https://camo.githubusercontent.com/2cc44e0fc8224e6af54eb0b27e13911ddf17ad66b1bd87ead503e4c1f4224ab2/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e466f726d732e5750462e737667 [LibVLCSharpGTK]: https://www.nuget.org/packages/LibVLCSharp.GTK/ [LibVLCSharpGTKBadge]: https://camo.githubusercontent.com/46b9c5a8138de1ea4f912017acb685f4f7f9191bdeca394c4e750feef106e98e/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e47544b2e737667 [LibVLCSharpFormsGTK]: https://www.nuget.org/packages/LibVLCSharp.Forms.GTK/ [LibVLCSharpFormsGTKBadge]: https://camo.githubusercontent.com/4245f2a9bf219cc4ab4d6508db3160f5fa4d0262e97ea3e9e68dbbc6bbafae1f/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e466f726d732e47544b2e737667 [LibVLCSharpWinForms]: https://www.nuget.org/packages/LibVLCSharp.WinForms/ [LibVLCSharpWinFormsBadge]: https://camo.githubusercontent.com/09448ec2066c1526764948991bd7122a48a3c96b76eb9f79352c08d84b98749a/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e57696e466f726d732e737667 [LibVLCSharpUno]: https://www.nuget.org/packages/LibVLCSharp.Uno/ [LibVLCSharpUnoBadge]: https://camo.githubusercontent.com/9a49f080accd5929bd5b49b714f5021b4988666ab60869f33c3fbb8d7e039cf4/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e556e6f2e737667 [LibVLCSharpAvalonia]: https://www.nuget.org/packages/LibVLCSharp.Avalonia/ [LibVLCSharpAvaloniaBadge]: https://camo.githubusercontent.com/bd15dd8f306d53cce925f0f0689c73531d918437102372d51bf2403edf84cbae/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e4176616c6f6e69612e737667 [LibVLCSharpEto]: https://www.nuget.org/packages/LibVLCSharp.Eto/ [LibVLCSharpEtoBadge]: https://camo.githubusercontent.com/0dfbd7c5114ad6c8f69f83e0e94b0c58d35b82aa9e41e07df466983a27b18c3a/68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4c6962564c4353686172702e45746f2e737667 [VLCUnityStore]: https://videolabs.io/store/unity [VLCUnityBadge]: https://camo.githubusercontent.com/0000212e6051ddc7949cc1c5bbc701244625c946faad86c6efb57be6c62057d9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d616465253230776974682d556e6974792d3537623964332e7376673f7374796c653d666c6174266c6f676f3d756e697479 ## Getting started Follow the [Getting started guide](https://github.com/videolan/libvlcsharp/blob/3.x/docs/getting_started.md). Make sure you read it since it contains platform-specific caveats ## Documentation Our [Documentation](https://github.com/videolan/libvlcsharp/blob/3.x/docs/home.md) is part of this repository. Feel free to browse it and if you see something missing, you can improve it by sending a PR. It includes helpful documents such as: ### [Best practices](https://github.com/videolan/libvlcsharp/blob/3.x/docs/best_practices.md) This document details how to use LibVLCSharp in a correct way, notably taking into consideration the native interop part. ### [Q&A guide](https://github.com/videolan/libvlcsharp/blob/3.x/docs/how_do_I_do_X.md) This is a Q&A document which I compiled from all the questions I got asked regarding LibVLC and LibVLCSharp. Continuously updated. ### [Troubleshooting issues](https://github.com/videolan/libvlcsharp/blob/3.x/docs/troubleshooting.md) When you encounter an issue with LibVLC/LibVLCSharp, identifying the cause is not always straightforward. This document gives you clues on how to go about it. ### [Libvlc specific information](https://github.com/videolan/libvlcsharp/blob/3.x/docs/libvlc_documentation.md) This page focuses on the core native library and contains information regarding advanced libvlc configuration and its versioning strategy by VideoLAN. ### [Tutorials](https://github.com/videolan/libvlcsharp/blob/3.x/docs/tutorials.md) This page indexes all available tutorial materials about LibVLCSharp. There are currently videos, talks, blogposts and code samples. ### [Community projects](https://github.com/videolan/libvlcsharp/blob/3.x/docs/made_with_libvlcsharp.md) Here we list several interesting projects made by the community using LibVLCSharp. Feel free to send a PR to yours! ## Ebook In September 2022, the first book ever about LibVLC, the VideoLAN community and LibVLCSharp was released! [The Good Parts of LibVLC](https://mfkl.gumroad.com/l/libvlc-good-parts) contains everything you need to know about VLC, LibVLC and how to use it from .NET with LibVLCSharp. ## Samples For more advanced samples, have a look at [libvlcsharp-samples](https://code.videolan.org/mfkl/libvlcsharp-samples) with apps such as: - [Chromecast sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/Chromecast): Discover chromecasts on your local network and select one for playback in 100% shared code (Xamarin.Forms, iOS/Android). - [Record HLS sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/RecordHLS): Simple .NET Core CLI app which shows how to record an HLS stream to the filesystem. - [RTSP Mosaic sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/VideoMosaic): Cross-platform RTSP player sample with 4 views mosaic (Xamarin.Forms, iOS/Android). - [PulseMusic UX sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/PulseMusic): A stylish music player UX example using Skia on iOS and Android. - [Gestures sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/Gestures/Gestures): Cross-platform touch gestures and 360 videos on iOS and Android. - [LocalNetwork sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/LocalNetwork): Cross-platform local network browsing and playback with network shares (SMB, UPnP) on Android, iOS and WPF. - [MediaPlayerElement sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/MediaElement): Minimal iOS/Android sample showing how to get started with the crossplatform MediaPlayerElement control from LibVLCSharp.Forms. - [SkiaSharp Preview Thumbnailer sample](https://code.videolan.org/mfkl/libvlcsharp-samples/tree/master/PreviewThumbnailExtractor.Skia): .NET Core sample app showing how to use LibVLC 3 video callbacks and encode the frame with SkiaSharp before saving it to disk. - [lvst](https://github.com/mfkl/lvst): Watch a movie while it is downloading! lvst is a .NET Core CLI app using MonoTorrent and LibVLCSharp for macOS, Linux and Windows. Feel free to suggest and contribute new samples. ## Quick API overview ```csharp using var libvlc = new LibVLC(enableDebugLogs: true); using var media = new Media(libvlc, new Uri(@"C:\tmp\big_buck_bunny.mp4")); using var mediaplayer = new MediaPlayer(media); mediaplayer.Play(); Console.ReadKey(); ``` - [`LibVLC.cs`](https://code.videolan.org/videolan/LibVLCSharp/-/raw/master/src/LibVLCSharp/LibVLC.cs): Main object pointing to a native `libvlc` instance in native code. - [`MediaPlayer.cs`](https://code.videolan.org/videolan/LibVLCSharp/-/raw/master/src/LibVLCSharp/MediaPlayer.cs): Manages playback, offers event listeners and more. Accessible from `VideoView` with data-binding support. - [`Media.cs`](https://code.videolan.org/videolan/LibVLCSharp/-/raw/master/src/LibVLCSharp/Media.cs): Class representing and providing information about a media such as a video or audio file or stream. - `VideoView.cs`: Custom native view which holds a `MediaPlayer` object. - [`MediaDiscoverer.cs`](https://code.videolan.org/videolan/LibVLCSharp/-/raw/master/src/LibVLCSharp/MediaDiscoverer.cs): This object should be used to find media on NAS and any SMB/UPnP-enabled device on your local network. - [`RendererDiscoverer.cs`](https://code.videolan.org/videolan/LibVLCSharp/-/raw/master/src/LibVLCSharp/RendererDiscoverer.cs): Use this to find and use a Chromecast or other distant renderers. - [`Dialog.cs`](https://code.videolan.org/videolan/LibVLCSharp/-/raw/master/src/LibVLCSharp/Dialog.cs): Dialogs can be raised from the `libvlc` engine in some cases. Register callbacks with this object. The [LibVLCSharp.Forms](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp.Forms/README.md) and [Uno](https://github.com/videolan/libvlcsharp/blob/3.x/src/LibVLCSharp.Uno/README.md) packages features a `MediaPlayerElement` control, similar to the ones provided by the .NET Framework on WPF and UWP. It currently supports iOS, Android and UWP (Uno only). ## Roadmap - Game engines ([Unity](https://code.videolan.org/videolan/vlc-unity), [Unreal](https://code.videolan.org/videolan/LibVLCSharp/-/issues/357), Godot) - [LibVLC 4 support](https://github.com/videolan/libvlcsharp/blob/3.x/docs/libvlc_preview.md) If you have a request or question regarding the roadmap, feel free to open an [issue](https://code.videolan.org/videolan/LibVLCSharp/issues) (using an issue template) or [PR](https://github.com/videolan/libvlcsharp/pulls). ## Versioning As this is a libvlc binding, we try to follow the libvlc versioning scheme as much as possible. The versioning strategy is explained in the [versioning](https://github.com/videolan/libvlcsharp/blob/3.x/docs/versioning.md) document. ## Release Notes Check out the [NEWS](https://github.com/videolan/libvlcsharp/raw/3.x/NEWS) file for details about each release. ## Contribute ### Pull request Pull requests are more than welcome! If you do submit one, please make sure to read the [contributing guidelines](https://github.com/videolan/libvlcsharp/blob/3.x/CONTRIBUTING.md) first, and use our pull request template. ### Gitlab issues You can look through issues we currently have on the [VideoLAN Gitlab](https://code.videolan.org/videolan/LibVLCSharp). Please pick one of our GitLab issue templates so we can assist you better. There are [up for grabs tickets](https://code.videolan.org/videolan/LibVLCSharp/-/issues?label_name%5B%5D=up-for-grabs) as well if you would like to start contributing. ## Questions and Support ### Bug trackers You have encountered an issue and wish to report it to the VLC dev team? You can create one on our [Gitlab](https://code.videolan.org/videolan/LibVLCSharp/issues) (using an issue template) for .NET related questions/problems. _For LibVLC/VLC specific issues, usually native code, please go to the [bug tracker of the VLC project](https://code.videolan.org/videolan/vlc/-/issues)._ Before creating an issue or ticket, please double check for duplicates! ### Discord We are on [![Join the chat at https://discord.gg/3h3K3JF](https://camo.githubusercontent.com/90283613843153dbf7b4c10bff3a450270dfb4a3873b60b91af455c05f94e008/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f3731363933393339363436343530383935383f6c6162656c3d646973636f7264)](https://discord.gg/3h3K3JF) ### StackOverflow We regularly monitor the `libvlcsharp` tag on ### Forum If you have any question or if you're not sure it's actually an issue, please visit our [forum](https://forum.videolan.org/). ### Commercial services If you would like VLC developers to provide you with: - custom development on LibVLC and/or LibVLCSharp, - training and workshops, - [commercial licenses](https://videolabs.io/products/libvlcsharp), - support services, - consulting services, - other multimedia services. Feel free to [contact us](https://videolabs.io/#contact). ## Code of Conduct Please read and follow the [VideoLAN CoC](https://wiki.videolan.org/Code_of_Conduct/) license. ## Licenses LibVLCSharp is released under the [LGPLv2.1](https://tldrlegal.com/license/gnu-lesser-general-public-license-v2.1-(lgpl-2.1)) and is also available under a [commercial license](https://videolabs.io/products/libvlcsharp). Note: the .NET4.0 LibVLCSharp build references a nuget package that may indicate its license as the .NET Library license but it's actually [opensource](https://github.com/Microsoft/referencesource/commit/6952d2c3923d30a4d88bf57120688b9532bbe1d8) under MIT.