Skip to content

[WIP] Golang binding for FFmpeg and libav

License

Notifications You must be signed in to change notification settings

Lensual/go-libav

Repository files navigation

go-libav

Go Reference GitHub release (with filter) GitHub go.mod Go version (subdirectory of monorepo) Static Badge Go Report Card Static Badge

English | 中文

Golang binding for FFmpeg and libav.

Things to know

  1. This package is implemented using CGO and requires FFmpeg's header files and libraries for compilation.
  2. Due to well-known performance issues with CGO calls, it is recommended to use C/CPP to achieve your needs.

Getting Started

Package go-libav/av* are cgo bindings. Before using this package, you'd better to master the basic usage of the FFmpeg library.

Package golibav/advance is a secondary package to simplify use in go.

Need Golang version 1.21 and FFmpeg library version 6.1.

Set your environment variable if your library is not in the default directory.

# using pkg-config
PKG_CONFIG_PATH="/ffmpeg/lib/pkgconfig"

# or set compiler flags
CGO_LDFLAGS="-L/ffmpeg/lib -lavcodec -lavdevice -lavfilter -lavformat -lavutil -lswresample -lswscale"
CGO_CFLAGS="-I/ffmpeg/include"

Examples

Check advance/example directory.

Try examples With Docker

# Run container with Debian 13 (trixie).
sudo docker run --rm -it debian:trixie
# Install development environment.
apt install golang git
# Clone project.
git clone https://github.com/Lensual/go-libav
# Install FFmpeg development libraries.
apt install libavcodec-dev libavdevice-dev libavfilter-dev libavformat-dev libavutil-dev libswresample-dev libswscale-dev
# Build example like 'mux' and then run iut.
cd go-libav/example/mux
go build .
./mux ./test.mp4

License

GNU Lesser General Public License version 2.1