vkscool / javaav

Java interface to FFmpeg.

JavaAV

The aim of this project is to provide an easy to use interface to FFmpeg. This project is not command line based like many others do. In addition JavaAV is easily maintainable. First, the native FFmpeg library is accessed through JNI. There is no other extra layer of native code like in Xuggler. Second, all the JNI classes are automatically generated with JavaCPP. Even the compilation into native code is controlled by JavaCPP. This way there is less effort to react to new FFmpeg updates. To improve JavaAV or fix bugs you do not need to touch the native code.

Supported Platforms

• Android ARM
• Linux x86 / x64
• Mac OS X x64
• Windows x86 / x64

Features

• Encoding / Decoding with any codec that was compiled into FFmpeg
• Muxing / Demuxing
• Audio / Video resampling
• Log access through callback

Code Snippets

Below some code snippets are shown to demonstrate the API usage. For more complete code see the examples section.

Enumerate installed codecs (each string contains name, type and description):

String[] codecs = Codec.getInstalledCodecs();

Create and use a real-time video encoder:

Options options = new Options();
options.put("tune", "zerolatency");
options.put("preset", "ultrafast");
		
Encoder encoder = new Encoder(CodecID.H264);
encoder.setPixelFormat(PixelFormat.YUV420P);
encoder.setImageWidth(1280);
encoder.setImageHeight(720);
encoder.setGOPSize(25);
encoder.setBitrate(2000000);
encoder.setFramerate(25);
encoder.open(options);

BufferedImage image = ...;
VideoFrame frame = VideoFrame.create(image);

MediaPacket packet = encoder.encodeVideo(frame);

... send packet over a network, write it to a file or whatever

encoder.close();
			

Examples

Below is the list of some basic examples. All examples can be found in the projects src/examples folder.

• Demuxer
• Muxer + Transcoding
• Camera

Installation

Maven

For those who use Maven may include this project as dependency:

<dependency>
	<groupId>com.github.hoary</groupId>
	<artifactId>JavaAV</artifactId>
	<version>0.5</version>
</dependency>

Manually

You can also download JavaAV manually. In doing so, JavaAV and the necessary dependencies must be added to the classpath.

License

GPLv2 with Classpath Exception