Struct rustube::Video

pub struct Video { /* fields omitted */ }

A YouTube downloader, which allows you to download all available formats and qualities of a YouTube video. Each instance of Video represents an existing, available, and downloadable video.

This type is the easiest way to download a video. There are tow major ways of constructing an instance of Video:

1. By using the asynchronous Video::from_* methods. These methods will take some kind of video-identifier, like an Url or an Id, will then internally download the necessary video information and finally descramble it.
2. By calling [VideoDescrambler::descramble]. Since a [VideoDescrambler] already contains the necessary video information, and just need to descramble it, no requests are performed.

Examples

• Constructing using Video::from_url (or Video::from_id) (easiest way)

const URL: &str = "https://youtube.com/watch?iv=5jlI4uzZGjU";
let url = Url::parse(URL).unwrap();

let video: Video = Video::from_url(&url).await.unwrap();

• Constructing using [VideoDescrambler::descramble]

const URL: &str = "https://youtube.com/watch?iv=5jlI4uzZGjU";
let url = Url::parse(URL).unwrap();

let fetcher: VideoFetcher = VideoFetcher::from_url(&url).unwrap();
let descrambler: VideoDescrambler = fetcher.fetch().await.unwrap();  
let video: Video = descrambler.descramble().unwrap();

• Construction using chained calls

const URL: &str = "https://youtube.com/watch?iv=5jlI4uzZGjU";
let url = Url::parse(URL).unwrap();

let video: Video = VideoFetcher::from_url(&url)
   .unwrap()
   .fetch()
   .await
   .unwrap()  
   .descramble()
   .unwrap();

• Downloading a video using an existing Video instance

let video_path = video
   .streams()
   .iter()
   .filter(|stream| stream.mime.subtype() == "mp4" && stream.width.is_some())
   .max_by(|stream0, stream1| stream0.width.unwrap().cmp(&stream1.width.unwrap()))
   .unwrap()
   .download()
   .await
   .unwrap();

println!(
   "The video with the id `{}` was downloaded to: `{:?}`",
   video.id(),
   video_path 
);

Implementations

impl Video

pub async fn from_url(url: &Url) -> Result<Self>

Constructs an instance of Video from a Url

pub async fn from_id(id: IdBuf) -> Result<Self>

pub fn video_info(&self) -> &VideoInfo

pub fn streams(&self) -> &Vec<Stream>

pub fn into_streams(self) -> Vec<Stream>

pub fn video_details(&self) -> Arc<VideoDetails>

pub fn id(&self) -> Id<'_>

pub fn title(&self) -> &str

pub fn is_age_restricted(&self) -> bool

pub fn best_quality(&self) -> Option<&Stream>

pub fn worst_quality(&self) -> Option<&Stream>

pub fn best_video(&self) -> Option<&Stream>

pub fn worst_video(&self) -> Option<&Stream>

pub fn best_audio(&self) -> Option<&Stream>

pub fn worst_audio(&self) -> Option<&Stream>

Trait Implementations

impl Clone for Video

pub fn clone(&self) -> Video

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Video

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

Formats the value using the given formatter.

impl Display for Video

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

Formats the value using the given formatter.

impl PartialEq<Video> for Video

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for Video