Struct rustube::Video [−][src]
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]
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]
descramble
and download
only.Errors
- When
VideoFetcher::fetch
fails. - When
VideoDescrambler::descramble
fails.
pub fn video_info(&self) -> &VideoInfo
[src]
descramble
only.The VideoInfo
of the video.
pub fn streams(&self) -> &Vec<Stream>
[src]
descramble
only.All Stream
s of the video.
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]
descramble
only.The VideoDetails
s of the video.
pub fn id(&self) -> Id<'_>
[src]
descramble
only.The Id
of the video.
pub fn title(&self) -> &str
[src]
descramble
only.The title of the video.
pub fn is_age_restricted(&self) -> bool
[src]
descramble
only.Weather or not the video is age restricted.
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]
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]
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]
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]
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]
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 Clone for Video
[src]
descramble
only.impl Debug for Video
[src]
descramble
only.impl Display for Video
[src]
descramble
only.impl PartialEq<Video> for Video
[src]
descramble
only.impl StructuralPartialEq for Video
[src]
descramble
only.Auto Trait Implementations
impl !RefUnwindSafe for Video
[src]
impl Send for Video
[src]
impl Sync for Video
[src]
impl Unpin for Video
[src]
impl !UnwindSafe for Video
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,