Struct Generic 

pub struct Generic { /* private fields */ }

Generic extractor for all non-YouTube sites.

This extractor provides a simple wrapper around yt-dlp that works with any supported site. It includes helpers for authentication.

Implementations

impl Generic

pub fn new(executable_path: PathBuf) -> Self

Create a new generic extractor with automatic detection.

Arguments

• executable_path - Path to the yt-dlp executable

Returns

A new Generic extractor instance

pub fn for_extractor(executable_path: PathBuf, name: String) -> Self

Create for specific extractor (skip detection).

Arguments

• executable_path - Path to the yt-dlp executable
• name - Name of the extractor to use

Returns

A new Generic extractor instance for the specified extractor

pub fn with_extractor_args(&mut self, extractor: &str, args: &str) -> &mut Self

Add extractor-specific arguments.

Arguments

• extractor - Name of the extractor
• args - Arguments to pass to the extractor

Returns

Self for method chaining

Examples

let mut extractor = Generic::new(PathBuf::from("yt-dlp"));
extractor.with_extractor_args("tiktok", "api_hostname=api-h2.tiktokv.com");

pub fn with_credentials(&mut self, username: &str, password: &str) -> &mut Self

Use credentials for sites requiring login.

Security note: Credentials are passed via --username and --password CLI arguments, which may be visible in process listings. For sensitive environments, prefer [with_netrc] or [with_cookies] on the Downloader instead.

Arguments

• username - Username for authentication
• password - Password for authentication

Returns

Self for method chaining

Examples

let mut extractor = Generic::new(PathBuf::from("yt-dlp"));
extractor.with_credentials("user@email.com", "password");

Trait Implementations

impl Clone for Generic

fn clone(&self) -> Generic

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Generic

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

Formats the value using the given formatter.

impl ExtractorBase for Generic

fn executable_path(&self) -> PathBuf

Get the executable path.

fn timeout(&self) -> Duration

Get the request timeout.

fn build_base_args(&self) -> Vec<String>

Build base arguments for yt-dlp.

fn fetch_video_metadata<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Video>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch and parse video metadata.

fn fetch_playlist_metadata<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Playlist>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch and parse playlist metadata.

fn log_and_fetch_video<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, url: &'life1 str, extractor: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Video>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Fetches video metadata and emits structured tracing on success or failure.

fn log_and_fetch_playlist<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, url: &'life1 str, extractor: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Playlist>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Fetches playlist metadata and emits structured tracing on success or failure.

impl ExtractorConfig for Generic

fn args_mut(&mut self) -> &mut Vec<String>

Returns a mutable reference to the internal args vector.

fn timeout_mut(&mut self) -> &mut Duration

Returns a mutable reference to the internal timeout.

fn with_arg(&mut self, arg: String) -> &mut Self

Add custom yt-dlp argument.

fn with_timeout(&mut self, timeout: Duration) -> &mut Self

Set timeout for yt-dlp operations.

fn with_cookies(&mut self, path: impl AsRef<Path>) -> &mut Self

Use a Netscape cookie file for authentication.

fn with_cookies_from_browser(&mut self, browser: &str) -> &mut Self

Extract cookies from a browser for authentication.

fn with_netrc(&mut self) -> &mut Self

Use .netrc for authentication.

impl VideoExtractor for Generic

fn fetch_video<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Video>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch video metadata from a URL.

fn fetch_playlist<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Playlist>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch playlist metadata from a URL.

fn name(&self) -> ExtractorName

Get the name of this extractor.

fn supports_url(&self, _url: &str) -> bool

Check if this extractor supports the given URL pattern.