Enum Error 

pub enum Error {
    Http(String),
    Url(String),
    Json(String),
    Xml(String),
    Io(String),
    InvalidYouTubeUrl(String),
    VideoNotFound(String),
    NotLiveStream,
    StreamOffline {
        reason: String,
        scheduled_start: Option<String>,
    },
    Unplayable(String),
    PlayerResponseError(String),
    NoDashManifest,
    QualityNotAvailable(String),
    DownloadFailed(String),
    FragmentFailed {
        seq: u64,
        tries: u32,
    },
    CookieParseFailed(String),
    MissingData(String),
    PoTokenRequired,
    LoginRequired,
    MembersOnly,
    Regex(String),
}

Error types that can occur when using the library.

This enum covers all possible errors from network requests, parsing, stream availability, and download operations.

Variants

Http(String)

HTTP request failed.

This can occur due to network issues, timeouts, or server errors.

Url(String)

URL parsing failed.

The provided URL could not be parsed as a valid URL.

Json(String)

JSON parsing failed.

The response from YouTube could not be parsed as valid JSON.

Xml(String)

XML parsing failed.

The DASH manifest could not be parsed as valid XML.

Io(String)

IO operation failed.

File reading/writing or other IO operations failed.

InvalidYouTubeUrl(String)

Invalid YouTube URL format.

The URL is not a recognized YouTube URL format. Supported formats include:

• https://youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://youtube.com/@channel/live

VideoNotFound(String)

Video not found.

The video ID does not exist or is not accessible.

NotLiveStream

The video is not a live stream.

This library only supports live streams, not regular videos.

StreamOffline

Stream is currently offline.

The live stream exists but is not currently broadcasting. Check scheduled_start for when it might go live.

Fields

reason: String

Reason the stream is offline.

scheduled_start: Option<String>

Scheduled start time, if known.

Unplayable(String)

Stream is unplayable.

YouTube has blocked playback for some reason (geo-restriction, etc.).

PlayerResponseError(String)

Error in the player response from YouTube.

NoDashManifest

No DASH manifest available.

The stream doesn’t have a DASH manifest, which is required for downloading.

QualityNotAvailable(String)

Requested quality is not available.

The stream doesn’t offer the requested quality level.

DownloadFailed(String)

Download operation failed.

FragmentFailed

Fragment download failed after retries.

Fields

seq: u64

Sequence number of the failed fragment.

tries: u32

Number of retry attempts made.

CookieParseFailed(String)

Cookie file parsing failed.

The cookies file is not in valid Netscape format.

MissingData(String)

Required data is missing from the response.

PoTokenRequired

PO Token is required for this stream.

Some streams require a PO token for authentication. Use ClientBuilder::po_token to provide one.

LoginRequired

Login is required to access this stream.

Provide cookies from a logged-in session using ClientBuilder::cookies_file.

MembersOnly

This is a members-only stream.

Access requires channel membership. Provide cookies from a logged-in account with an active membership.

Regex(String)

Regex compilation or matching error.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<DeError> for Error

fn from(e: DeError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(e: ParseError) -> Self

Converts to this type from the input type.