https://github.com/nor0x/xdroidffmpeg

Xamarin.Android Binding for RxFFmpeg. XDroidFFmpeg provides powerful audio and video processing / editing powered by ffmpeg
https://github.com/nor0x/xdroidffmpeg

android-bindings csharp ffmpeg ffmpeg-android xamarin xamarin-android xamarin-forms

Last synced: about 2 months ago
JSON representation

Xamarin.Android Binding for RxFFmpeg. XDroidFFmpeg provides powerful audio and video processing / editing powered by ffmpeg

• Host: GitHub
• URL: https://github.com/nor0x/xdroidffmpeg
• Owner: nor0x
• Created: 2019-09-19T10:58:33.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-11-24T10:40:48.000Z (about 4 years ago)
• Last Synced: 2024-10-11T19:43:54.320Z (2 months ago)
• Topics: android-bindings, csharp, ffmpeg, ffmpeg-android, xamarin, xamarin-android, xamarin-forms
• Language: C#
• Homepage:
• Size: 91.3 MB
• Stars: 12
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


# XDroidFFmpeg

[![Build Status](https://dev.azure.com/nor0x/XDroidFFmpeg/_apis/build/status/nor0x.XDroidFFmpeg?branchName=master)](https://dev.azure.com/nor0x/XDroidFFmpeg/_build/latest?definitionId=6&branchName=master) [![](https://img.shields.io/nuget/vpre/XDroidFFmpeg.svg)](https://nuget.org/packages/XDroidFFmpeg)

[![](https://img.shields.io/nuget/dt/XDroidFFmpeg)](https://nuget.org/packages/XDroidFFmpeg)

Xamarin.Android bindings for [RxFFmpeg](https://github.com/microshow/RxFFmpeg). (Kudos [@microshow](https://github.com/microshow))  This `Java Bindings Library` provides performant audio and video processing / editing powered by `FFmpeg 4.0` + `X264` + `mp3lame` + `fdk-aac`.

| Platform      | Support       | Sample|

| :-------------: |:-------------:| :-----:|

| Xamarin.Android      | ✔      |  ✔    |

| Xamarin.Forms        | ✔      |  ⏳  |

## Why XDroidFFmpeg?

Using [FFmpeg](https://github.com/FFmpeg/FFmpeg) in `(Xamarin.)Android` seems easy at first - there are some projects around, but there are some gotchas like getting compilation for different ABIs right and adding support for hardware acceleration. [RxFFmpeg](https://github.com/microshow/RxFFmpeg) is doing a great job of making it easy to run commands against `ffmpeg`. I was struggling with getting FFmpeg performance right on Xamarin.Android that's way I started binding [RxFFmpeg](https://github.com/microshow/RxFFmpeg) since they have support for `Android` `MediaCodec`. One goal with this `Java Bindings Library` is to make it as easy as possible to call into the native `ffmpeg` commands from `Xamarin.Android`. 

Major credits to [@microshow](https://github.com/microshow) for doing the hard work 👍.

## Getting started

### NuGet

XDroidFFmpeg is up on NuGet and GitHub

[https://www.nuget.org/packages/XDroidFFmpeg](https://www.nuget.org/packages/XDroidFFmpeg)

[https://github.com/nor0x/XDroidFFmpeg/packages](https://github.com/nor0x/XDroidFFmpeg/packages)

### Project

Start by adding a reference to [RxFFmpeg_Bindings.csproj](https://github.com/nor0x/XDroidFFmpeg/blob/master/RxFFmpeg_Bindings/RxFFmpeg_Bindings.csproj "RxFFmpeg_Bindings.csproj") to the `Xamarin.Android` project. Set API Level and supported ABIs in the project properties. Hint: use `arm64-v8a` for best performance on supported devices.

## Running `ffmpeg` commands 

Running commands against `ffmpeg` is as simple as:

    var command = cmd.Split(" ");

    RxFFmpegInvoke.Instance.RunCommand(command, null);

For getting callbacks an implementation of `IFFmpegListener` can be passed to `RunCommand`

There is also a demo project which demonstrates adding `.PNG` watermark to an `.MP4` video. To get the demo working you need to create a `ffmpegtest` folder in `/storage/emulated/0/` and add a `video.mp4` and `watermark.png` file to this folder.

#### Watermark Demo



More demo scenarios might be added in the future. Head over to [ffmpeg documentation](https://ffmpeg.org/ffmpeg.html) for more.

## Contribution

Feel free to create issues and PRs  😃