Struct MetadataManager 

pub struct MetadataManager { /* private fields */ }

Metadata manager for handling file metadata.

This manager provides methods to add metadata and thumbnails to downloaded files in various formats (MP3, M4A, MP4, WebM, MKV, etc.).

Implementations

impl MetadataManager

pub async fn add_metadata( &self, file_path: impl Into<PathBuf>, video: &Video, ) -> Result<()>

Add metadata to a file based on its format.

This method automatically detects the file format and applies appropriate metadata. Use this for standalone files when you don’t have format details.

Arguments

• file_path - Path to the file to add metadata to
• video - Video metadata to apply

Errors

Returns an error if the file format is unsupported or if metadata writing fails

Examples

let manager = MetadataManager::new();
// video obtained from a fetch_video_infos call
manager.add_metadata("video.mp4", &video).await?;

pub async fn add_metadata_with_format( &self, file_path: impl Into<PathBuf>, video: &Video, video_format: Option<&Format>, audio_format: Option<&Format>, ) -> Result<()>

Add metadata to a file with format details for audio and video.

This method should be used when you have detailed format information, typically for combined audio+video files. Technical metadata (resolution, codecs, bitrates) will be included for MP4 and WebM formats.

Arguments

• file_path - Path to the file to add metadata to
• video - Video metadata to apply
• video_format - Optional video format details (for technical metadata)
• audio_format - Optional audio format details (for technical metadata)

Errors

Returns an error if the file format is unsupported or if metadata writing fails

pub async fn add_thumbnail_to_file( &self, file_path: impl Into<PathBuf>, thumbnail_path: impl Into<PathBuf>, ) -> Result<()>

Add a thumbnail to a file based on its format.

Thumbnails are embedded in the file metadata. Supported formats: MP3, M4A, MP4, WebM, MKV

Arguments

• file_path - Path to the file to add thumbnail to
• thumbnail_path - Path to the thumbnail image file

Errors

Returns an error if the file format doesn’t support thumbnails or if embedding fails

Examples

let manager = MetadataManager::new();
manager
    .add_thumbnail_to_file("video.mp3", "cover.jpg")
    .await?;

impl MetadataManager

pub async fn add_metadata_with_chapters( &self, file_path: impl Into<PathBuf>, video: &Video, video_format: Option<&Format>, audio_format: Option<&Format>, ) -> Result<()>

Add both regular metadata and chapters to a video file.

This is a convenience method that combines add_metadata_with_format and add_chapters_metadata in a single operation.

Arguments

• file_path - Path to the video file
• video - The video metadata
• video_format - Optional video format for technical metadata
• audio_format - Optional audio format for technical metadata

Errors

Returns an error if metadata or chapters cannot be added

pub async fn add_chapters_metadata( &self, file_path: impl Into<PathBuf>, chapters: &[Chapter], ) -> Result<()>

Add chapters metadata to a video file using FFmpeg.

This method embeds chapter markers into MP4/MKV/WebM files. Chapters allow media players to navigate to specific sections of the video.

Arguments

• file_path - Path to the video file
• chapters - The chapters to embed

Errors

Returns an error if FFmpeg fails or if the file cannot be processed

Returns

Ok(()) if chapters were successfully embedded

impl MetadataManager

pub fn new() -> Self

Create a new MetadataManager with default ffmpeg path.

The default ffmpeg path is “ffmpeg” unless overridden by the FFMPEG_PATH environment variable.

Returns

A new MetadataManager instance

pub fn with_ffmpeg_path(ffmpeg_path: impl Into<PathBuf>) -> Self

Create a new MetadataManager with custom ffmpeg path.

Arguments

• ffmpeg_path - Path to the ffmpeg executable

Returns

A new MetadataManager instance with custom ffmpeg path

Trait Implementations

impl BaseMetadata for MetadataManager

fn extract_basic_metadata(video: &Video) -> Vec<(String, String)>

Extract basic metadata from a video.

fn extract_video_format_metadata(format: &Format) -> Vec<(String, String)>

Extract video format metadata.

fn extract_audio_format_metadata(format: &Format) -> Vec<(String, String)>

Extract audio format metadata.

fn format_timestamp(timestamp: i64, format_str: &str) -> Option<String>

Format a timestamp into a string according to a specified format.

fn add_metadata_if_some<T: ToString>( metadata: &mut Vec<(String, String)>, key: &str, value: Option<T>, )

Add metadata to a vector if the value exists.

impl Clone for MetadataManager

fn clone(&self) -> MetadataManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetadataManager

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

Formats the value using the given formatter.

impl Default for MetadataManager

fn default() -> Self

Returns the “default value” for a type.

impl Eq for MetadataManager

impl PartialEq for MetadataManager

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MetadataManager