Struct rustube::Video [−][src]
pub struct Video { /* fields omitted */ }
Expand description
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.
There are two ways of constructing an instance of Video
:
- By using the asynchronous
Video::from_*
methods. These methods will take some kind of video-identifier, like anUrl
or anId
, will then internally download the necessary video information and finally descramble it. - By calling
VideoDescrambler::descramble
. Since aVideoDescrambler
already contains the necessary video information, and just need to descramble it, no requests are performed. (This gives you more control over the process).
Examples
- Constructing using
Video::from_url
(orVideo::from_id
) (easiest way)
let url = Url::parse("https://youtube.com/watch?iv=5jlI4uzZGjU")?; let video: Video = Video::from_url(&url).await?;
- Constructing using
VideoDescrambler::descramble
let url = Url::parse("https://youtube.com/watch?iv=5jlI4uzZGjU")?; let fetcher: VideoFetcher = VideoFetcher::from_url(&url)?; let descrambler: VideoDescrambler = fetcher.fetch().await?; let video: Video = descrambler.descramble()?;
- Construction using chained calls
let url = Url::parse("https://youtube.com/watch?iv=5jlI4uzZGjU")?; let video: Video = VideoFetcher::from_url(&url)? .fetch() .await? .descramble()?;
- Downloading a video using an existing
Video
instance
let video_path = video .streams() .iter() .filter(|stream| stream.includes_video_track && stream.includes_audio_track) .max_by_key(|stream| stream.quality_label) .unwrap() .download() .await?;
Implementations
impl Video
[src]
impl Video
[src]pub async fn from_url(url: &Url) -> Result<Self>
[src]
This is supported on crate features download
and regex
and descramble
only.
pub async fn from_url(url: &Url) -> Result<Self>
[src]download
and regex
and descramble
only.Errors
- When
VideoFetcher::from_url
fails. - When
VideoFetcher::fetch
fails. - When
VideoDescrambler::descramble
fails.
pub async fn from_id(id: IdBuf) -> Result<Self>
[src]
This is supported on crate features descramble
and download
only.
pub async fn from_id(id: IdBuf) -> Result<Self>
[src]descramble
and download
only.Errors
- When
VideoFetcher::fetch
fails. - When
VideoDescrambler::descramble
fails.
pub fn video_info(&self) -> &VideoInfo
[src]
This is supported on crate feature descramble
only.
pub fn video_info(&self) -> &VideoInfo
[src]descramble
only.The VideoInfo
of the video.
pub fn streams(&self) -> &Vec<Stream>
[src]
This is supported on crate feature descramble
only.
pub fn streams(&self) -> &Vec<Stream>
[src]descramble
only.All Stream
s of the video.
pub fn into_streams(self) -> Vec<Stream>
[src]
This is supported on crate feature descramble
only.
pub fn into_streams(self) -> Vec<Stream>
[src]descramble
only.Takes all Stream
s of the video.
pub fn video_details(&self) -> Arc<VideoDetails>
[src]
This is supported on crate feature descramble
only.
pub fn video_details(&self) -> Arc<VideoDetails>
[src]descramble
only.The VideoDetails
s of the video.
pub fn id(&self) -> Id<'_>
[src]
This is supported on crate feature descramble
only.
pub fn id(&self) -> Id<'_>
[src]descramble
only.The Id
of the video.
pub fn title(&self) -> &str
[src]
This is supported on crate feature descramble
only.
pub fn title(&self) -> &str
[src]descramble
only.The title of the video.
pub fn is_age_restricted(&self) -> bool
[src]
This is supported on crate feature descramble
only.
pub fn is_age_restricted(&self) -> bool
[src]descramble
only.Whether or not the video is age restricted.
pub fn best_quality(&self) -> Option<&Stream>
[src]
This is supported on crate feature descramble
only.
pub fn best_quality(&self) -> Option<&Stream>
[src]descramble
only.The Stream
with the best quality.
This stream is guaranteed to contain both a video as well as an audio track.
pub fn worst_quality(&self) -> Option<&Stream>
[src]
This is supported on crate feature descramble
only.
pub fn worst_quality(&self) -> Option<&Stream>
[src]descramble
only.The Stream
with the worst quality.
This stream is guaranteed to contain both a video as well as an audio track.
pub fn best_video(&self) -> Option<&Stream>
[src]
This is supported on crate feature descramble
only.
pub fn best_video(&self) -> Option<&Stream>
[src]descramble
only.The Stream
with the best video quality.
This stream is guaranteed to contain only a video but no audio track.
pub fn worst_video(&self) -> Option<&Stream>
[src]
This is supported on crate feature descramble
only.
pub fn worst_video(&self) -> Option<&Stream>
[src]descramble
only.The Stream
with the worst video quality.
This stream is guaranteed to contain only a video but no audio track.
pub fn best_audio(&self) -> Option<&Stream>
[src]
This is supported on crate feature descramble
only.
pub fn best_audio(&self) -> Option<&Stream>
[src]descramble
only.The Stream
with the best audio quality.
This stream is guaranteed to contain only a audio but no video track.
pub fn worst_audio(&self) -> Option<&Stream>
[src]
This is supported on crate feature descramble
only.
pub fn worst_audio(&self) -> Option<&Stream>
[src]descramble
only.The Stream
with the worst audio quality.
This stream is guaranteed to contain only a audio but no video track.
Trait Implementations
impl StructuralPartialEq for Video
[src]
descramble
only.Auto Trait Implementations
impl !RefUnwindSafe for Video
impl Send for Video
impl Sync for Video
impl Unpin for Video
impl !UnwindSafe for Video
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> Instrument for T
[src]
impl<T> Instrument for T
[src]fn instrument(self, span: Span) -> Instrumented<Self>
[src]
fn instrument(self, span: Span) -> Instrumented<Self>
[src]Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
fn in_current_span(self) -> Instrumented<Self>
[src]
fn in_current_span(self) -> Instrumented<Self>
[src]impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more