Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hendriks73/tagtraum-ffmpeg-package
FFmpeg built with support for javax.sound.sampled in mind, i.e. mostly decoders, demuxers etc. Codecs to have known patent problems are disabled (no guarantee). tagtraum industries is not the developer of FFmpeg or any of its libraries. It only assembled this particular package. For more information on FFmpeg, please visit https://www.ffmpeg.org/
https://github.com/hendriks73/tagtraum-ffmpeg-package
ffmpeg java maven
Last synced: about 2 months ago
JSON representation
FFmpeg built with support for javax.sound.sampled in mind, i.e. mostly decoders, demuxers etc. Codecs to have known patent problems are disabled (no guarantee). tagtraum industries is not the developer of FFmpeg or any of its libraries. It only assembled this particular package. For more information on FFmpeg, please visit https://www.ffmpeg.org/
- Host: GitHub
- URL: https://github.com/hendriks73/tagtraum-ffmpeg-package
- Owner: hendriks73
- License: lgpl-2.1
- Created: 2013-06-20T15:10:42.000Z (over 11 years ago)
- Default Branch: main
- Last Pushed: 2023-10-30T09:11:05.000Z (about 1 year ago)
- Last Synced: 2023-11-30T11:20:45.380Z (about 1 year ago)
- Topics: ffmpeg, java, maven
- Language: CSS
- Homepage:
- Size: 300 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)
[](https://maven-badges.herokuapp.com/maven-central/com.tagtraum/ffmpeg-package)
[](https://github.com/hendriks73/tagtraum-FFmpeg-package/actions)
# tagtraum FFmpeg package
The *tagtraum FFmpeg package* is a binary release of some of the libraries released by
the [FFmpeg](https://www.ffmpeg.org) project. Its purpose is to provide easy access
to Windows, macOS, and Linux (currently Ubuntu) binaries and sources for decoding audio
via a [Maven](https://maven.apache.org/) repository.
Thus it serves as an upstream project for [Java JNI projects wishing to interface
with the native libraries](https://www.tagtraum.com/ffsampledsp/).
Codecs with known patent problems are disabled (but can be enabled, see below).
However, this obviously is no guarantee.
Also, as the focus lies on decoding audio, most encoders are disabled.
This distribution comes with absolutely no support, warranty etc. you name it.
*tagtraum FFmpeg package's* online home is at https://www.tagtraum.com/ffmpeg/
## Usage
To use this package, simply introduce a Maven dependency like this:
```xml
com.tagtraum
ffmpeg-x86_64-macos
```
The dependency is a `.jar` file containing static libraries. To compile
against them, you will need to first `unpack` the jar, for example using the
[dependency:unpack](https://maven.apache.org/plugins/maven-dependency-plugin/usage.html#dependency:unpack).
goal.
Should you need sources to compile your native code against, use
a dependency like this:
```xml
com.tagtraum
ffmpeg-x86_64-macos
tar.bz2
ffmpeg-sources
provided
```
Again, you will need to `unpack` this to use it.
## Build
Currently, this library is built automatically via [GitHub Actions](https://github.com/features/actions).
If you want to build it yourself, you'll need:
- [Maven](https://maven.apache.org/)
- [Apple Command Line Tools](https://developer.apple.com/) or [Xcode](https://developer.apple.com/xcode/) for macOS
- MSYS2 for Windows with a GCC toolchain (`mingw-w64-i686-toolchain` / `mingw-w64-x86_64-toolchain`)
- [YASM](https://yasm.tortall.net/releases/Release1.3.0.html), available via `brew install yasm` (macOS), `pacman -S mingw-w64-x86_64-yasm` (msys2 for 64bit Windows), `pacman -S mingw-w64-i686-yasm` (msys2 for 64bit Windows, crosscompile for 32bit Windows) or whatever your Linux distro makes you do
- a JDK (to run Maven)
Once all pre-requisites are in place, you must invoke the *right* profile.
Automatic activation is *off* by default.
To build the package for macOS (x86_64), run
```shell
$ mvn --activate-profiles compile,ffmpeg-x86_64-macos install
```
The profile `compile` ensures that FFmpeg and other sources are downloaded and built.
`ffmpeg-x86_64-macos` packages the resulting static library files `*.a` into a jar
with the artifact name `ffmpeg-x86_64-macos` and group id `com.tagtraum`.
If you would like to change the FFmpeg configuration, add
"-Dffmpeg.configure=--enable-static --disable-programs ... "
Note that you need to add quotes around the entire `-D` parameter to allow for spaces
in the value part.
## Release Notes
Please see [here](NOTES.md).
Enjoy.