https://github.com/vbauer/avconv4java
Java interface to avconv tool
https://github.com/vbauer/avconv4java
avconv ffmpeg java libav video video-processing
Last synced: 3 months ago
JSON representation
Java interface to avconv tool
- Host: GitHub
- URL: https://github.com/vbauer/avconv4java
- Owner: vbauer
- Created: 2014-01-21T12:40:54.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2019-05-19T10:26:07.000Z (over 6 years ago)
- Last Synced: 2025-06-24T13:41:29.718Z (7 months ago)
- Topics: avconv, ffmpeg, java, libav, video, video-processing
- Language: Java
- Homepage:
- Size: 871 KB
- Stars: 28
- Watchers: 3
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# avconv4java
[](https://travis-ci.org/vbauer/avconv4java)
[](https://coveralls.io/r/vbauer/avconv4java)
[](http://opensource.org/licenses/Apache-2.0)
[](https://jitpack.io/#vbauer/avconv4java)
[](https://www.codacy.com/app/bauer-vlad/avconv4java)
## Introduction
**avconv** tool is a part of the [Libav](http://libav.org) project (originates from the FFmpeg codebase).
It is a fast and powerful video and audio converter.
Libav supports most common instruction set architectures (including IA-32, x86-64, PowerPC, ARM, etc.) with great performance.
**avconv4java** is a simple pure-java interface to the [avconv](http://libav.org/avconv.html) command-line tool.
API was designed with KISS principle in mind to be as simple as possible.
**Online documentation:**
* [Maven site](https://vbauer.github.io/avconv4java)
* [Javadoc](https://vbauer.github.io/avconv4java/apidocs)
## Features
* Most avconv commands are supported (and tested in real projects).
* Parallel processing is supported out of box.
* It has a very simple API with fluent interfaces and method chaining.
* Options and operators are transformed into similar method-names, e.g.
* -vcodec libx264 -> .videoCodec(AVVideoCodecType.H264)
* -vcodec libtheora -> .videoCodec(AVVideoCodecType.THEORA)
* -vcodec libtheora -> .videoCodec("libtheora")
## Setup
Gradle:
```groovy
repositories {
maven {
url "https://jitpack.io"
}
}
dependencies {
compile 'com.github.vbauer:avconv4java:1.2.3'
}
```
Maven:
```xml
jitpack.io
https://jitpack.io
com.github.vbauer
avconv4java
1.2.3
```
## Example
First of all you need to configure options for avconv command. Builder pattern allows to do it as simple as possible:
```java
final AVRootOptions options = AVRootOptions.create("input.avi", "output.mp4")
.builders(
AVMainOptions.create()
.overwriteOutput(),
AVVideoOptions.create()
.proportionalResizeUsingWidth(800)
.videoCodec(AVVideoCodecType.H264)
.movFlags(AVMovFlagsType.FAST_START),
AVAudioOptions.create()
.audioCodec(AVAudioCodecType.VISUAL_ON_AAC)
.audioBitRate(128)
.audioChannelsCount(2)
.sampleRate(11025),
AVCodecOptions.create()
.bitRate(1000)
)
```
To execute avconv command with needed options you should use the class com.avconv4java.core.AVCommnad:
```java
// It'll be better to configure timeout always. Debug is useful sometimes.
final AVCommand command = AVCommand.create()
.setDebug(true)
.setTimeout(timeout);
final int returnCode = command.run(options);
final String outputFile = options.getOutputFile();
Logger.getGlobal().info(
String.format("Output file: %s, return code: %d", outputFile, returnCode)
);
```
This command is equivalent to the following:
```bash
/usr/bin/avconv -i input.avi -y -vf scale=w=800:h=trunc(ow/a/2)*2 -vcodec libx264 -movflags faststart -acodec libvo_aacenc -ab 128k -b 1000k -ac 2 -ar 11025 output.mp4
```
## FAQ
- What is the default avconv path value?
- Environment variable "AVCONV4JAVA_TOOLPATH" will be checked in priority, otherwise it will be "/usr/bin/avconv".
## Might also like
* [jconditions](https://github.com/vbauer/jconditions) - Extra conditional annotations for JUnit.
* [jackdaw](https://github.com/vbauer/jackdaw) - Java Annotation Processor which allows to simplify development.
* [houdini](https://github.com/vbauer/houdini) - Type conversion system for Spring framework.
* [herald](https://github.com/vbauer/herald) - Logging annotation for Spring framework.
* [caesar](https://github.com/vbauer/caesar) - Library that allows to create async beans from sync beans.
* [commons-vfs2-cifs](https://github.com/vbauer/commons-vfs2-cifs) - SMB/CIFS provider for Commons VFS.
## License
```
Copyright 2014 Vladislav Bauer
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```