5 releases

0.0.5 Aug 2, 2024
0.0.4 Aug 1, 2023
0.0.3 Jul 26, 2023
0.0.2 May 1, 2023
0.0.1 Apr 28, 2023

#7 in Multimedia

Download history 720/week @ 2024-07-11 523/week @ 2024-07-18 846/week @ 2024-07-25 525/week @ 2024-08-01 525/week @ 2024-08-08 349/week @ 2024-08-15 286/week @ 2024-08-22 350/week @ 2024-08-29 663/week @ 2024-09-05 402/week @ 2024-09-12 463/week @ 2024-09-19 454/week @ 2024-09-26 617/week @ 2024-10-03 371/week @ 2024-10-10 314/week @ 2024-10-17 487/week @ 2024-10-24

1,838 downloads per month

BSD-3-Clause

2.5MB
31K SLoC

Cros-codecs

crates.io docs.rs

A lightweight, simple, low-dependency, and hopefully safe crate for hardware-accelerated video decoding and encoding on Linux.

It is developed for use in ChromeOS (particularly crosvm), but has no dependency to ChromeOS and should be usable anywhere.

Current features

  • Simple decoder API,
  • VAAPI decoder support (using cros-libva) for H.264, H.265, VP8, VP9 and AV1,
  • VAAPI encoder support for H.264, VP9 and AV1,
  • Stateful V4L2 encoder support.

Planned features

  • Stateful V4L2 decoder support,
  • Stateless V4L2 decoder support,
  • Support for more encoder codecs,
  • C API to be used in non-Rust projects.

Non-goals

  • Support for systems other than Linux.

Example programs

The ccdec example program can decode an encoded stream and write the decoded frames to a file. As such it can be used for testing purposes.

$ cargo build --examples
$ ./target/debug/examples/ccdec --help
Usage: ccdec <input> [--output <output>] --input-format <input-format> [--output-format <output-format>] [--synchronous] [--compute-md5 <compute-md5>]

Simple player using cros-codecs

Positional Arguments:
  input             input file

Options:
  --output          output file to write the decoded frames to
  --input-format    input format to decode from.
  --output-format   pixel format to decode into. Default: i420
  --synchronous     whether to decode frames synchronously
  --compute-md5     whether to display the MD5 of the decoded stream, and at
                    which granularity (stream or frame)
  --help            display usage information

Testing

Fluster can be used for testing, using the ccdec example program described above. This branch contains support for cros-codecs testing. Just make sure the ccdec binary is in your PATH, and run Fluster using one of the ccdec decoders, e.g.

python fluster.py run -d ccdec-H.264 -ts JVT-AVC_V1

Credits

The majority of the code in the initial commit has been written by Daniel Almeida as a VAAPI backend for crosvm, before being split into this crate.

Dependencies