avio 0.2.0

Safe, high-level audio/video/image processing for Rust — backend-agnostic multimedia toolkit
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

# avio


Safe, high-level audio/video/image processing for Rust — backend-agnostic multimedia toolkit.

![Coming Soon](https://img.shields.io/badge/status-coming%20soon-yellow)

> **⚠️ Coming Soon — This crate is a placeholder and not yet fully implemented.**
> The core crates (`ff-probe`, `ff-decode`, `ff-encode`) are under active development.

## Overview


`avio` is the facade crate for the ff-* crate family. It re-exports the public APIs of all member crates behind feature flags, so you can depend on a single crate and opt into only the functionality you need.

Currently backed by FFmpeg, with planned support for GStreamer and other backends.

## Feature Flags


| Feature    | Crate         | Default |
|------------|---------------|---------|
| `probe`    | `ff-probe`    | yes     |
| `decode`   | `ff-decode`   | yes     |
| `encode`   | `ff-encode`   | yes     |
| `filter`   | `ff-filter`   | no      |
| `pipeline` | `ff-pipeline` | no      |
| `stream`   | `ff-stream`   | no      |

## Planned Usage


```toml
[dependencies]
# Default features: probe + decode + encode

avio = "0.5"

# With filter graph and pipeline support

avio = { version = "0.5", features = ["filter", "pipeline"] }

# Full feature set

avio = { version = "0.5", features = ["filter", "pipeline", "stream"] }
```

```rust,ignore
use avio::prelude::*;

let info = avio::probe::open("input.mp4")?;
println!("duration: {:?}", info.duration());
```

## Minimum Supported Rust Version


Rust 1.93.0 or later (edition 2024).

## The ff-* Crate Family


| Crate          | Description                              |
|----------------|------------------------------------------|
| `ff-sys`       | Raw FFmpeg FFI bindings (bindgen)        |
| `ff-common`    | Shared pool abstractions                 |
| `ff-format`    | Shared type system (codecs, frames, ...) |
| `ff-probe`     | Metadata and chapter extraction          |
| `ff-decode`    | Video/audio/image decoding               |
| `ff-encode`    | Video/audio encoding                     |
| `ff-filter`    | Filter graph (libavfilter)               |
| `ff-pipeline`  | Unified decode-filter-encode pipeline    |
| `ff-stream`    | HLS/DASH streaming output                |
| `avio`         | Facade crate (this crate)                |

## License


MIT OR Apache-2.0