About

Direct, unobscured and self contained FFmpeg (sys) bindings.

By self contained I mean: * Does not require or link against any FFmpeg system dependencies. * Does not require a network connection for building.

The FFmpeg bindings now include doc comments, including struct fields! See here.

Example

```rust let inputpathcstr = std::ffi::CString::new("path/to/source.mp4").unwrap();

// Open an e.g. MP4 file avformatopeninput( &mut ifmtctx, inputpathcstr.asptr(), std::ptr::nullmut(), std::ptr::nullmut(), ); avformatfindstreaminfo(ifmtctx, std::ptr::null_mut());

// Print info about the loaded file avdumpformat( ifmtctx, 0, inputpathcstr.asptr(), 0, ); ```

For the uninitiated, the std includes lots of convenient ffi related utilities. E.g. using std::slice::from_raw_parts: ```rust use ffmpegdev::sys::{ AVMediaTypeAVMEDIATYPEVIDEO as AVMEDIATYPEVIDEO, AVMediaTypeAVMEDIATYPEAUDIO as AVMEDIATYPEAUDIO, }; let ifmtctx: AVFormatContext = ifmt_ctx; let nb_streams = (ifmtctx).nbstreams as usize;

// Extract video/audio/etc. streams from our mp4 file. let streams = std::slice::fromrawparts((ifmt_ctx).streams, nb_streams) .iter() .map(|x| (x).as_ref().expect("not null")) .collect::>();

for (index, streamptr) in streams.iter().enumerate() { let codecpar = *streamptr.codecpar; if codecpar.codectype == AVMEDIATYPEAUDIO { println!("found audio stream at index {}", index); } else if codecpar.codectype == AVMEDIATYPEVIDEO { println!("found video stream at index {}", index); } } ```

Stability

API bindings should be practically stable now.

Internal Behavior

By default the debug or dev builds compile FFmpeg without optimizations, this is for the purpose of speeding up compilation. Compiling on release mode or setting opt-level > 1 will disable this behavior.

LICENSE WARNING

I’m not a lawyer, furthermore I really don’t understand software licenses. * This codebase is MIT. * At compile time, this library builds and statically links against LGPL code. * This is for the purpose of being self contained, without burdening any library consumers with dependency issues.

Hopefully one day the rust ecosystem will get a decent FFmpeg alternative for e.g. container muxing/demuxing.

Future

It would be interesting to experiment with compiling FFmpeg to WebAssembly. Perhaps as an alternative to static linking, if a local version isn’t available it could link to a remote lib over the network.

Built for Imager - Site performance tools for efficiently distributing media on the web.