Struct AudioAdder 

pub struct AudioAdder { /* private fields */ }

Mux an audio track into a silent (or existing) video file.

The video bitstream is stream-copied (no decode/encode cycle). When the audio source is shorter than the video and loop_audio has been called, the audio is looped by re-seeking and advancing the PTS offset until the video is exhausted.

Returns RemuxError::OperationFailed when no video stream is found in video_input or no audio stream is found in audio_input.

Example

use ff_remux::AudioAdder;

AudioAdder::new("silent.mp4", "soundtrack.mp3", "output.mp4")
    .loop_audio()
    .run()?;

Implementations

impl AudioAdder

pub fn new( video_input: impl Into<PathBuf>, audio_input: impl Into<PathBuf>, output: impl Into<PathBuf>, ) -> Self

Create a new AudioAdder.

• video_input — source file whose video stream is kept.
• audio_input — source file whose first audio stream is used.
• output — path for the combined output file.

Examples found in repository

examples/audio_addition.rs (line 67)

fn main() {
    let mut args = std::env::args().skip(1);
    let mut video = None::<String>;
    let mut audio = None::<String>;
    let mut output = None::<String>;
    let mut loop_audio = false;

    while let Some(flag) = args.next() {
        match flag.as_str() {
            "--video" | "-v" => video = Some(args.next().unwrap_or_default()),
            "--audio" | "-a" => audio = Some(args.next().unwrap_or_default()),
            "--output" | "-o" => output = Some(args.next().unwrap_or_default()),
            "--loop" | "-l" => loop_audio = true,
            other => {
                eprintln!("Unknown flag: {other}");
                process::exit(1);
            }
        }
    }

    let video = video.unwrap_or_else(|| {
        eprintln!("Usage: audio_addition --video <file> --audio <file> --output <file> [--loop]");
        process::exit(1);
    });
    let audio = audio.unwrap_or_else(|| {
        eprintln!("--audio is required");
        process::exit(1);
    });
    let output = output.unwrap_or_else(|| {
        eprintln!("--output is required");
        process::exit(1);
    });

    println!("Video source: {video}");
    println!("Audio source: {audio}");
    println!("Loop audio:   {loop_audio}");
    println!("Output:       {output}");
    println!();
    println!("Adding audio track (stream-copy, no re-encode)…");

    let mut adder = AudioAdder::new(&video, &audio, &output);
    if loop_audio {
        adder = adder.loop_audio();
    }

    adder.run().unwrap_or_else(|e| {
        eprintln!("Error: {e}");
        process::exit(1);
    });

    let size = match std::fs::metadata(&output) {
        Ok(m) => {
            #[allow(clippy::cast_precision_loss)]
            let kb = m.len() as f64 / 1024.0;
            if kb < 1024.0 {
                format!("{kb:.0} KB")
            } else {
                format!("{:.1} MB", kb / 1024.0)
            }
        }
        Err(_) => "(unknown size)".to_string(),
    };

    println!("Done. {output}  {size}");
}

pub fn loop_audio(self) -> Self

Loop the audio when it is shorter than the video.

The audio is re-seeked to the start and the PTS offset is advanced each time the audio stream is exhausted, until the video ends.

Examples found in repository

examples/audio_addition.rs (line 69)

fn main() {
    let mut args = std::env::args().skip(1);
    let mut video = None::<String>;
    let mut audio = None::<String>;
    let mut output = None::<String>;
    let mut loop_audio = false;

    while let Some(flag) = args.next() {
        match flag.as_str() {
            "--video" | "-v" => video = Some(args.next().unwrap_or_default()),
            "--audio" | "-a" => audio = Some(args.next().unwrap_or_default()),
            "--output" | "-o" => output = Some(args.next().unwrap_or_default()),
            "--loop" | "-l" => loop_audio = true,
            other => {
                eprintln!("Unknown flag: {other}");
                process::exit(1);
            }
        }
    }

    let video = video.unwrap_or_else(|| {
        eprintln!("Usage: audio_addition --video <file> --audio <file> --output <file> [--loop]");
        process::exit(1);
    });
    let audio = audio.unwrap_or_else(|| {
        eprintln!("--audio is required");
        process::exit(1);
    });
    let output = output.unwrap_or_else(|| {
        eprintln!("--output is required");
        process::exit(1);
    });

    println!("Video source: {video}");
    println!("Audio source: {audio}");
    println!("Loop audio:   {loop_audio}");
    println!("Output:       {output}");
    println!();
    println!("Adding audio track (stream-copy, no re-encode)…");

    let mut adder = AudioAdder::new(&video, &audio, &output);
    if loop_audio {
        adder = adder.loop_audio();
    }

    adder.run().unwrap_or_else(|e| {
        eprintln!("Error: {e}");
        process::exit(1);
    });

    let size = match std::fs::metadata(&output) {
        Ok(m) => {
            #[allow(clippy::cast_precision_loss)]
            let kb = m.len() as f64 / 1024.0;
            if kb < 1024.0 {
                format!("{kb:.0} KB")
            } else {
                format!("{:.1} MB", kb / 1024.0)
            }
        }
        Err(_) => "(unknown size)".to_string(),
    };

    println!("Done. {output}  {size}");
}

pub fn run(self) -> Result<(), RemuxError>

Execute the audio addition operation.

Errors

• RemuxError::OperationFailed if video_input has no video stream or audio_input has no audio stream.
• RemuxError::Ffmpeg if any FFmpeg API call fails.

Examples found in repository

examples/audio_addition.rs (line 72)

fn main() {
    let mut args = std::env::args().skip(1);
    let mut video = None::<String>;
    let mut audio = None::<String>;
    let mut output = None::<String>;
    let mut loop_audio = false;

    while let Some(flag) = args.next() {
        match flag.as_str() {
            "--video" | "-v" => video = Some(args.next().unwrap_or_default()),
            "--audio" | "-a" => audio = Some(args.next().unwrap_or_default()),
            "--output" | "-o" => output = Some(args.next().unwrap_or_default()),
            "--loop" | "-l" => loop_audio = true,
            other => {
                eprintln!("Unknown flag: {other}");
                process::exit(1);
            }
        }
    }

    let video = video.unwrap_or_else(|| {
        eprintln!("Usage: audio_addition --video <file> --audio <file> --output <file> [--loop]");
        process::exit(1);
    });
    let audio = audio.unwrap_or_else(|| {
        eprintln!("--audio is required");
        process::exit(1);
    });
    let output = output.unwrap_or_else(|| {
        eprintln!("--output is required");
        process::exit(1);
    });

    println!("Video source: {video}");
    println!("Audio source: {audio}");
    println!("Loop audio:   {loop_audio}");
    println!("Output:       {output}");
    println!();
    println!("Adding audio track (stream-copy, no re-encode)…");

    let mut adder = AudioAdder::new(&video, &audio, &output);
    if loop_audio {
        adder = adder.loop_audio();
    }

    adder.run().unwrap_or_else(|e| {
        eprintln!("Error: {e}");
        process::exit(1);
    });

    let size = match std::fs::metadata(&output) {
        Ok(m) => {
            #[allow(clippy::cast_precision_loss)]
            let kb = m.len() as f64 / 1024.0;
            if kb < 1024.0 {
                format!("{kb:.0} KB")
            } else {
                format!("{:.1} MB", kb / 1024.0)
            }
        }
        Err(_) => "(unknown size)".to_string(),
    };

    println!("Done. {output}  {size}");
}