Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/h4tr3d/avcpp
C++ wrapper for FFmpeg
https://github.com/h4tr3d/avcpp
cmake cpp cpp17 cpp20 ffmpeg vcpkg
Last synced: 2 days ago
JSON representation
C++ wrapper for FFmpeg
- Host: GitHub
- URL: https://github.com/h4tr3d/avcpp
- Owner: h4tr3d
- License: other
- Created: 2013-11-01T12:23:55.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-11-18T04:33:28.000Z (2 months ago)
- Last Synced: 2025-01-11T23:02:05.842Z (9 days ago)
- Topics: cmake, cpp, cpp17, cpp20, ffmpeg, vcpkg
- Language: C++
- Homepage:
- Size: 43.8 MB
- Stars: 469
- Watchers: 26
- Forks: 86
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-bsd.txt
Awesome Lists containing this project
README
# AvCpp [](https://github.com/h4tr3d/avcpp/actions/workflows/cmake-ci.yml) [](https://github.com/h4tr3d/avcpp/security/code-scanning) [](https://makeapullrequest.com)
Wrapper for the FFmpeg that simplify usage it from C++ projects.
Currently covered next functionality:
- Core helper & utility classes (AVFrame -> av::AudioSample & av::VideoFrame, AVRational -> av::Rational and so on)
- Container formats & contexts muxing and demuxing
- Codecs & codecs contexts: encoding and decoding
- Streams (AVStream -> av::Stream)
- Filters (audio & video): parsing from string, manual adding filters to the graph & other
- SW Video & Audio resamplers
You can read the full documentation [here](https://h4tr3d.github.io/avcpp/).
## Requirements
- FFmpeg >= 2.0
- libavformat >= 54.x.x
- libavcodec >= 54.x.x
- libavfilter >= 3.x.x
- libavutil >= 51.x.x
- libswscale >= 2.x.x
- libswresample >= 0.x.x
- libpostproc >= 52.x.x
- GCC >= 5.0 (C++11 is required)
- CMake (> 3.19) or Meson(> 50.0)
### Debian, Ubuntu 19.10 and Linux Mint 20.x or newer
You should install FFmpeg packages from the deb-multimedia.org site:
```bash
sudo apt-get install libavformat-dev \
libavcodec-dev \
libavutil-dev \
libavfilter-dev \
libswscale-dev \
libswresample-dev \
libpostproc-dev \
libavdevice-dev
```
Note 1: I did not test building on Debian.
Note 2: Debian Wheezy repo contains only FFmpeg 1.0.8. I tested building only with 2.x. So it is strongly recoment use Wheezy back-ports repo.
### Ubuntu 18.04 and Linux Mint 19.x
If you are on Ubuntu bionic or Linux Mint 19.x you should add [ffmpeg-4](https://launchpad.net/~jonathonf/+archive/ubuntu/ffmpeg-4) PPA:
```bash
sudo add-apt-repository ppa:jonathonf/ffmpeg-4 -y
sudo apt update && sudo apt upgrade
```
After that just install the same packages as above.
------
## Build
There are two ways to compile either with CMake or with meson.
By default meson is faster, but if your project uses CMake, those instructions might be better for integration.
### Building with CMake
```bash
git clone --recurse-submodules https://github.com/h4tr3d/avcpp.git avcpp-git
cd avcpp-git
mkdir build
cd build
cmake ..
make -j8
```
If your Git version so old (refer to the [SO for clarification](https://stackoverflow.com/questions/3796927/how-to-git-clone-including-submodules)) you can just
replace `--recurse-submodules` with pair of `git submodule init && git submodule update`.
If FFmpeg located in non-standard place:
```bash
cmake -DPC_FFMPEG_LIBRARY_DIRS= -DPC_FFMPEG_INCLUDE_DIRS= ..
```
To point install prefix:
```bash
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
```
Install:
```bash
sudo make install
```
or (for packaging)
```bash
sudo make DESTDIR= install
```
Refer to CMake documentation for more details that can cover some special cases.
### Building with meson
Before you can begin with the building you have to clone the repository like this:
```bash
git clone https://github.com/h4tr3d/avcpp.git avcpp-git
cd avcpp-git
```
IDE Integration:
There are extentions for various IDEs like VS Code/Codium, Eclipse, Xcode, etc.
Refer to the [docs](https://mesonbuild.com/IDE-integration.html) for more information.
Building the project:
If you don't have the dependencies installed, meson will download and compile them.
Because ffmpeg is so large (~2000 c files), you should consider using your package manager to install them.
You can then build the project with the following commands:
```bash
mkdir build
cd build
meson ..
meson compile
```
Configuring the project:
By default the sample projects and the test are compiled.
If you don't want this you can disable it with the following commands:
```bash
meson configure -Dbuild_tests=false
meson configure -Dbuild_samples=false
```
You can set the install prefix using `meson --prefix `.
To see all of the available options just type `meson configure` and `meson configure --help` to get more information.
Installing the project:
Just type `meson install` and the project will be installed in the configured prefix (/usr/local by default).
Running the tests:
To run the test just use `meson test`.
If you disabled the test this will do nothing.