Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mtebenev/MediaToolkit.NetCore

A .NET library to convert and process all your video & audio files.
https://github.com/mtebenev/MediaToolkit.NetCore

Last synced: 2 months ago
JSON representation

A .NET library to convert and process all your video & audio files.

Awesome Lists containing this project

README 

        
MediaToolkit.NetCore

============



This is port of MediaToolkit to .Net Core

---



Notable changes are:

1. Projects are compiled with VS2019 using .Net Core

2. ffmpeg.exe is not embedded in library binaries, you should pass a path to ffmpeg.exe explicitly in constructor



The API changes for 0.2.0 Preview

---



Engine class becomes obsolete.

The MediaToolkit now exposes injectable **IMediaToolkitService**.



Instantiating the service

---



Using .Net Core dependency injection:

```csharp

  var ffmpegFilePath = @"C:\ffmpeg\ffmpeg.exe";

  var serviceProvider = new ServiceCollection()

    .AddMediaToolkit(ffmpegFilePath)

    .BuildServiceProvider();

...

  var service = serviceProvider.GetService();

```



Directly:

```csharp

  var ffmpegFilePath = @"C:\ffmpeg\ffmpeg.exe";

  var service = MediaToolkitService.CreateInstance(ffmpegFilePath);

```



Getting the metadata

---



This task uses ffprobe to extract the metadata.

```csharp

  var metadataTask = new FfTaskGetMetadata(videoPath);

  var metadataResult = await service.ExecuteAsync(metadataTask);

```



Saving the thumbnail in a file

---



```csharp

  var saveThumbnailTask = new FfTaskSaveThumbnail(

    videoPath,

    thumbnailPath,

    TimeSpan.FromSeconds(10)

  );

  await service.ExecuteAsync(saveThumbnailTask);

```



Getting the thumbnail data

---

This task returns byte[] with the thumbnail data instead of saving it to a file.

You can pass null to the frame size to let ffmpeg guess the frame dimensions.



```csharp

  var options = new GetThumbnailOptions

  {

    SeekSpan = TimeSpan.FromSeconds(10),

    OutputFormat = OutputFormat.Gif,

    PixelFormat = PixelFormat.Gray

  };

  var getThumbnailTask = new FfTaskGetThumbnail(

    videoPath,

    options

  );

  await service.ExecuteAsync(getThumbnailTask);

```



...From MediaToolkit (original)

---



MediaToolkit provides a straightforward interface for handling media data, making tasks such as converting, slicing and editing both audio and video completely effortless.



Under the hood, MediaToolkit is a .NET wrapper for FFmpeg; a free (LGPLv2.1) multimedia framework containing multiple audio and video codecs, supporting muxing, demuxing and transcoding tasks on many media formats.



Contents

---------



1. [Features](#features)

2. [Get started!](#get-started)

3. [Samples](#samples)

4. [Licensing](#licensing)



Features

-------------

- Resolving metadata

- Generating thumbnails from videos

- Transcode audio & video into other formats using parameters such as:

    -  `Bit rate`

    -  `Frame rate`

    -  `Resolution`

    -  `Aspect ratio`

    -  `Seek position`

    -  `Duration`

    -  `Sample rate`

    -  `Media format`

- Convert media to physical formats and standards such as:

    - Standards include: `FILM`, `PAL` & `NTSC`

    - Mediums include: `DVD`, `DV`, `DV50`, `VCD` & `SVCD`

- Supports custom FFmpeg command line arguments

- Raising progress events



Get started!

------------

Install MediaToolkit from NuGet using the Package Manager Console with the following command (or search on [NuGet MediaToolkit](https://www.nuget.org/packages/MediaToolkit))



    PM> Install-Package MediaToolkit



Samples

-------



- [Retrieve metadata](#retrieve-metadata)

- [Perform basic video conversions](#basic-conversion)

- [Grab thumbnail] (#grab-thumbnail-from-a-video)

- [Convert from FLV to DVD](#convert-flash-video-to-dvd)

- [Convert FLV to MP4 using various transcoding options](#transcoding-options-flv-to-mp4)

- [Cut / split video] (#cut-video-down-to-smaller-length)

- [Subscribing to events](#subscribe-to-events)



### Grab thumbnail from a video



    var inputFile = new MediaFile {Filename = @"C:\Path\To_Video.flv"};

    var outputFile = new MediaFile {Filename = @"C:\Path\To_Save_Image.jpg"};



    using (var engine = new Engine())

    {

        engine.GetMetadata(inputFile);



        // Saves the frame located on the 15th second of the video.

        var options = new ConversionOptions { Seek = TimeSpan.FromSeconds(15) };

        engine.GetThumbnail(inputFile, outputFile, options);

    }



### Retrieve metadata



    var inputFile = new MediaFile {Filename = @"C:\Path\To_Video.flv"};



    using (var engine = new Engine())

    {

        engine.GetMetadata(inputFile);

    }



    Console.WriteLine(inputFile.Metadata.Duration);



### Basic conversion



    var inputFile = new MediaFile {Filename = @"C:\Path\To_Video.flv"};

    var outputFile = new MediaFile {Filename = @"C:\Path\To_Save_New_Video.mp4"};



    using (var engine = new Engine())

    {

        engine.Convert(inputFile, outputFile);

    }



### Convert Flash video to DVD



    var inputFile = new MediaFile {Filename = @"C:\Path\To_Video.flv"};

    var outputFile = new MediaFile {Filename = @"C:\Path\To_Save_New_DVD.vob"};



    var conversionOptions = new ConversionOptions

    {

        Target = Target.DVD,

        TargetStandard = TargetStandard.PAL

    };



    using (var engine = new Engine())

    {

        engine.Convert(inputFile, outputFile, conversionOptions);

    }



### Transcoding options FLV to MP4



    var inputFile = new MediaFile {Filename = @"C:\Path\To_Video.flv"};

    var outputFile = new MediaFile {Filename = @"C:\Path\To_Save_New_Video.mp4"};



    var conversionOptions = new ConversionOptions

    {

        MaxVideoDuration = TimeSpan.FromSeconds(30),

        VideoAspectRatio = VideoAspectRatio.R16_9,

        VideoSize = VideoSize.Hd1080,

        AudioSampleRate = AudioSampleRate.Hz44100

    };



    using (var engine = new Engine())

    {

        engine.Convert(inputFile, outputFile, conversionOptions);

    }



### Cut video down to smaller length



    var inputFile = new MediaFile {Filename = @"C:\Path\To_Video.flv"};

    var outputFile = new MediaFile {Filename = @"C:\Path\To_Save_ExtractedVideo.flv"};



    using (var engine = new Engine())

    {

        engine.GetMetadata(inputFile);



        var options = new ConversionOptions();



        // This example will create a 25 second video, starting from the

        // 30th second of the original video.

        //// First parameter requests the starting frame to cut the media from.

        //// Second parameter requests how long to cut the video.

        options.CutMedia(TimeSpan.FromSeconds(30), TimeSpan.FromSeconds(25));



        engine.Convert(inputFile, outputFile, options);

    }



### Subscribe to events



    public void StartConverting()

    {

        var inputFile = new MediaFile {Filename = @"C:\Path\To_Video.flv"};

        var outputFile = new MediaFile {Filename = @"C:\Path\To_Save_New_Video.mp4"};



        using (var engine = new Engine())

        {

            engine.ConvertProgressEvent += ConvertProgressEvent;

            engine.ConversionCompleteEvent += engine_ConversionCompleteEvent;

            engine.Convert(inputFile, outputFile);

        }

    }



    private void ConvertProgressEvent(object sender, ConvertProgressEventArgs e)

    {

        Console.WriteLine("\n------------\nConverting...\n------------");

        Console.WriteLine("Bitrate: {0}", e.Bitrate);

        Console.WriteLine("Fps: {0}", e.Fps);

        Console.WriteLine("Frame: {0}", e.Frame);

        Console.WriteLine("ProcessedDuration: {0}", e.ProcessedDuration);

        Console.WriteLine("SizeKb: {0}", e.SizeKb);

        Console.WriteLine("TotalDuration: {0}\n", e.TotalDuration);

    }



    private void engine_ConversionCompleteEvent(object sender, ConversionCompleteEventArgs e)

    {

        Console.WriteLine("\n------------\nConversion complete!\n------------");

        Console.WriteLine("Bitrate: {0}", e.Bitrate);

        Console.WriteLine("Fps: {0}", e.Fps);

        Console.WriteLine("Frame: {0}", e.Frame);

        Console.WriteLine("ProcessedDuration: {0}", e.ProcessedDuration);

        Console.WriteLine("SizeKb: {0}", e.SizeKb);

        Console.WriteLine("TotalDuration: {0}\n", e.TotalDuration);

    }



Licensing

---------

- MediaToolkit is licensed under the [MIT license](https://github.com/AydinAdn/MediaToolkit/blob/master/LICENSE.md)

- MediaToolkit uses [FFmpeg](http://ffmpeg.org), a multimedia framework which is licensed under the [LGPLv2.1 license](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html), its source can be downloaded from [here](https://github.com/AydinAdn/MediaToolkit/tree/master/FFmpeg%20src)