Struct FfmpegLiveThumbnailCommand 

pub struct FfmpegLiveThumbnailCommand { /* private fields */ }

One-frame capture from a live HLS playlist, used to populate the directory thumbnail for an active channel.

Network reads are bounded so a stalled HLS source can never block the per-channel capture loop. -rw_timeout is microseconds in FFmpeg; it is set to 5s, which is well below a typical capture cadence so a hung source fails the tick and lets the next one run unimpeded.

Implementations

impl FfmpegLiveThumbnailCommand

pub fn new( ffmpeg_bin: impl Into<String>, input_url: impl Into<String>, output_path: impl Into<PathBuf>, ) -> Self

Build a live-thumbnail capture command.

pub fn args(&self) -> Vec<OsString>

The exact FFmpeg argument vector this command runs.

The output path is threaded through as its raw OsStr (not a lossy String) so a non-UTF-8 path reaches Command intact.

pub fn run(&self) -> Result<u64, MediaError>

Run FFmpeg and return the captured file size in bytes.

Errors

Returns an error when the output directory cannot be created, FFmpeg exits unsuccessfully, or the output cannot be inspected.

pub async fn run_with_deadline( &self, deadline: Duration, ) -> Result<u64, MediaError>

Run FFmpeg under an async deadline, killing the child process on timeout so a hung source can never leak a detached process across capture ticks.

Errors

Returns an error when the output directory cannot be created, the child cannot be spawned, the deadline elapses (after killing the child), FFmpeg exits unsuccessfully, or the output cannot be inspected.

Trait Implementations

impl Clone for FfmpegLiveThumbnailCommand

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FfmpegLiveThumbnailCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FfmpegLiveThumbnailCommand

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FfmpegLiveThumbnailCommand

impl PartialEq for FfmpegLiveThumbnailCommand

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FfmpegLiveThumbnailCommand

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FfmpegLiveThumbnailCommand