Crate ff_stream 

ff-stream

HLS and DASH adaptive streaming output - the Rust way.

This crate provides segmented HLS and DASH output along with ABR (Adaptive Bitrate) ladder generation. It exposes a safe, ergonomic Builder API and completely hides FFmpeg muxer internals.

Features

• HLS Output: Segmented HLS with configurable segment duration and keyframe interval
• DASH Output: Segmented DASH with configurable segment duration
• ABR Ladder: Multi-rendition HLS / DASH from a single input in one call
• Builder Pattern: Consuming builders with validation in build()

Usage

HLS Output

use ff_stream::HlsOutput;
use std::time::Duration;

HlsOutput::new("/var/www/hls")
    .input("source.mp4")
    .segment_duration(Duration::from_secs(6))
    .keyframe_interval(48)
    .build()?
    .write()?;

DASH Output

use ff_stream::DashOutput;
use std::time::Duration;

DashOutput::new("/var/www/dash")
    .input("source.mp4")
    .segment_duration(Duration::from_secs(4))
    .build()?
    .write()?;

ABR Ladder

use ff_stream::{AbrLadder, Rendition};

AbrLadder::new("source.mp4")
    .add_rendition(Rendition { width: 1920, height: 1080, bitrate: 6_000_000 })
    .add_rendition(Rendition { width: 1280, height:  720, bitrate: 3_000_000 })
    .add_rendition(Rendition { width:  854, height:  480, bitrate: 1_500_000 })
    .hls("/var/www/hls")?;

Module Structure

• hls — HlsOutput: segmented HLS output builder
• dash — DashOutput: segmented DASH output builder
• abr — AbrLadder + Rendition: multi-rendition ABR ladder
• error — StreamError: unified error type for this crate

Status

The public API is stable. HLS and DASH muxing are fully implemented via the FFmpeg HLS/DASH muxers. write() / hls() / dash() perform real encode-and-mux operations against the filesystem.

Re-exports

pub use abr::AbrLadder;

pub use abr::Rendition;

pub use dash::DashOutput;

pub use error::StreamError;

pub use fanout::FanoutOutput;

pub use hls::HlsOutput;

pub use hls::HlsSegmentFormat;

pub use live_abr::AbrRendition;

pub use live_abr::LiveAbrFormat;

pub use live_abr::LiveAbrLadder;

pub use live_dash::LiveDashOutput;

pub use live_hls::LiveHlsOutput;

pub use output::StreamOutput;

pub use rtmp::RtmpOutput;

Modules

abr

Adaptive bitrate (ABR) ladder for multi-rendition HLS / DASH output.

dash

DASH segmented output builder.

error

Unified error type for the ff-stream crate. Error types for streaming operations.

fanout

Multi-target fan-out wrapper.

hls

HLS segmented output builder.

live_abr

Multi-rendition ABR ladder for live frame-push output.

live_dash

Frame-push live DASH output.

live_hls

Frame-push live HLS output.

output

Common interface for live stream outputs.

rtmp

Frame-push RTMP output.