Install

pcod, the command line over the library, comes with every GitHub Release for Linux x86-64, Windows x86-64 and macOS on Apple Silicon. SHA256SUMS in each Release lists every file’s checksum.

Linux x86-64

v=v1.3.0; curl -fsSLO "https://github.com/gmrdad82/pito-codecs/releases/download/$v/pcod-$v-linux-x86_64.tar.gz"
tar -xzf "pcod-$v-linux-x86_64.tar.gz" pcod && install -Dm755 pcod ~/.local/bin/pcod

macOS on Apple Silicon

v=v1.3.0; curl -fsSLO "https://github.com/gmrdad82/pito-codecs/releases/download/$v/pcod-$v-macos-arm64.tar.gz"
tar -xzf "pcod-$v-macos-arm64.tar.gz" pcod && sudo install -m755 pcod /usr/local/bin/pcod

Windows x86-64

In PowerShell:

$v="v1.3.0"; Invoke-WebRequest "https://github.com/gmrdad82/pito-codecs/releases/download/$v/pcod-$v-windows-x86_64.zip" -OutFile pcod.zip
Expand-Archive pcod.zip "$env:LOCALAPPDATA\pcod" -Force; [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:LOCALAPPDATA\pcod", "User")

On Windows, H.265 decode through Media Foundation needs Microsoft’s HEVC Video Extensions, and N editions need the Media Feature Pack.

From source

Anywhere Rust 1.97 or newer runs, Linux arm64 included:

cargo install --locked --git https://github.com/gmrdad82/pito-codecs --tag v1.3.0 pito-codecs --bin pcod

The library

Add it to a Rust project’s Cargo.toml. Every part is on by default:

[dependencies]
pito-codecs = { git = "https://github.com/gmrdad82/pito-codecs", tag = "v1.3.0" }

Each part is a feature: media, h264, hevc, vp9, aac, ac3, mp3, opus, mp4, mkv, gpu, filter, gif, webp, and cli for pcod alone. The media front (probe, first_frame, export and the rest) needs h264, hevc, vp9, aac, mp4, mkv, gpu and filter; a library user who wants nothing else turns cli off so clap is never built:

[dependencies]
pito-codecs = { git = "https://github.com/gmrdad82/pito-codecs", tag = "v1.3.0", default-features = false, features = ["h264", "hevc", "vp9", "aac", "mp4", "mkv", "gpu", "filter", "opus", "ac3", "mp3"] }

The GPU route needs nothing extra: libva is loaded at run time on Linux (Mesa’s or Intel’s driver), VideoToolbox is part of macOS and Media Foundation part of Windows. Without them everything decodes and encodes on the CPU.

Quick start

On any MP4:

pcod probe clip.mp4
pcod decode clip.mp4 --route gpu
pcod encode clip.mp4 out.mp4 --codec hevc --route gpu

From Rust, let the front pick the fastest route:

use pito_codecs::media::{Prefs, first_frame, probe};

let prefs = Prefs::default();
let info = probe("clip.mp4".as_ref(), &prefs)?;
let still = first_frame("clip.mp4".as_ref(), 240, &prefs)?;
println!("{}x{} at {}/{} fps, first frame {}x{}", info.width, info.height, info.fps.0, info.fps.1, still.width, still.height);

Next: probe, decode and encode with pcod, or use the library.