# JAVE2
jave-core ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-core?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-core?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-all-deps ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-all-deps?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-all-deps?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-linux-arm32 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-linux-arm32?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-linux-arm32?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-linux-arm64 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-linux-arm64?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-linux-arm64?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-linux32 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-linux32?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-linux32?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-linux64 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-linux64?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-linux64?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-win32 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-win32?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-win32?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-win64 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-win64?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-win64?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-osx64 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-osx64?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-osx64?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
jave-nativebin-osxm1 ![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/ws.schild/jave-nativebin-osxm1?label=release&nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org%2F)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/ws.schild/jave-nativebin-osxm1?label=snapshot&server=https%3A%2F%2Foss.sonatype.org%2F)
The JAVE2 (Java Audio Video Encoder) library is Java wrapper on the ffmpeg
project. Developers can take take advantage of JAVE2 to transcode audio
and video files from a format to another. In example you can transcode
an **AVI** file to a **MPEG** one, you can change a **DivX** video stream into a
(youtube like) **Flash FLV** one, you can convert a **WAV** audio file to a **MP3** or a
**Ogg Vorbis** one, you can separate and transcode audio and video tracks, you can
resize videos, changing their sizes and proportions and so on.
Many other formats, containers and operations are supported by JAVE2.
## Supported Operating Systems + Requirements
> JAVE requires **Java 8 or higher**
> JAVE can also be easily ported to other OS and hardware configurations,
see the JAVE manual for details.
| Operating System | Windows x32,x64 | MacOS intel x64 | MacOS m1 | Linux x32,x64 | Linux arm32,arm64 |
| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |
| Supported? | Parial,YES | YES | YES | YES | Partial,YES |
Please note that the arm+win 32 bit versions are still on 4.4.0 and will be removed in a future release
The win32 binaries will be removed in the next release
## Projects using Jave2
* [XR3Player](https://github.com/goxr3plus/XR3Player)
* [XR3Converter](https://github.com/goxr3plus/XR3Converter)
* [On Github](https://github.com/a-schild/jave2/network/dependents)
* ....
## Usage Example
For the documentation, please have a look at the project wiki pages [**here**](https://github.com/a-schild/jave2/wiki)
or at this file [**DefaultFFMPEGLocatorTest.java**](https://github.com/a-schild/jave2/blob/master/jave-example/src/main/java/ws/schild/jave/example/DefaultFFMPEGLocatorTest.java)
Maven Repository URL -> https://mvnrepository.com/artifact/ws.schild/jave-all-deps
### Use with Maven
It includes all binaries for the supported platforms
``` XML
ws.schild
jave-all-deps
3.5.0
```
You can use maven dependencies to include the libraries in your projects.
Include the following in your pom files.
### [ Remember always to check the latest release [here](https://github.com/a-schild/jave2/releases/latest) ]
**Generally if you want to use for one platform or more what you have to do is add the jave-core:**
``` XML
ws.schild
jave-core
3.5.0
```
and then the specific jar(s) for your platform(s) :
### For one platform only (Linux 64Bit amd/intel in this case)
``` XML
ws.schild
jave-nativebin-linux64
3.5.0
```
### For one platform only (Linux 64Bit arm in this case)
``` XML
ws.schild
jave-nativebin-linux-arm64
3.5.0
```
### For one platform only (Linux 32Bit arm in this case)
``` XML
ws.schild
jave-nativebin-linux-arm32
3.5.0
```
### For one platform only (Windows 64Bit in this case)
``` XML
ws.schild
jave-nativebin-win64
3.5.0
```
### For one platform only (MACOS 64Bit in this case)
``` XML
ws.schild
jave-nativebin-osx64
3.5.0
```
### Use with Gradle
It includes all binaries for the supported platforms
``` XML
compile group: 'ws.schild', name: 'jave-all-deps', version: '3.5.0'
```
### For one platform only (Linux 64Bit in this case)
``` XML
compile group: 'ws.schild', name: 'jave-core', version: '3.5.0'
compile group: 'ws.schild', name: 'jave-nativebin-linux64', version: '3.5.0'
```
### Main Components of Jave2
Jave2 consists of two main components:
1. The `jave-core` dependency, which includes all the java code, which is platform independent
2. The `jave-nativebin-` dependencies, which include the binary executables per platform
There exists a jave-all-deps project, which includes core and all windows und linux binaries.
---
## Examples
#### Converting any audio to mp3
``` JAVA
boolean succeeded;
try {
File source = new File("file path");
File target = new File("file path");
//Audio Attributes
AudioAttributes audio = new AudioAttributes();
audio.setCodec("libmp3lame");
audio.setBitRate(128000);
audio.setChannels(2);
audio.setSamplingRate(44100);
//Encoding attributes
EncodingAttributes attrs = new EncodingAttributes();
attrs.setFormat("mp3");
attrs.setAudioAttributes(audio);
//Encode
Encoder encoder = new Encoder();
encoder.encode(new MultimediaObject(source), target, attrs);
} catch (Exception ex) {
ex.printStackTrace();
succeeded = false;
}
```
## More advanced examples
Can be found [**here**](https://github.com/a-schild/jave2/blob/master/Examples.md)
## Changelog
Can be found [**here**](https://github.com/a-schild/jave2/blob/master/Changelog.md)
## License
JAVE2 is Free Software and it is licensed under [GPL3 LICENSE](https://github.com/a-schild/jave2/blob/master/LICENSE)
> You will find a copy of the license bundled into the
downloadable software distribution.
## Feedback
You can send comments to andre@schild.ws
For bug reports use the github site https://github.com/a-schild/jave2/issues
## Credits
Jave is based on the jave version from Carlo Pelliccia
The original project page with source code can be found here:
http://www.sauronsoftware.it/projects/jave/