Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dzenanjupic/rustube
A YouTube video downloader, originally inspired by pytube, written in Rust.
https://github.com/dzenanjupic/rustube
rust youtube youtube-downloader
Last synced: about 5 hours ago
JSON representation
A YouTube video downloader, originally inspired by pytube, written in Rust.
- Host: GitHub
- URL: https://github.com/dzenanjupic/rustube
- Owner: DzenanJupic
- License: apache-2.0
- Created: 2020-12-20T15:38:24.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-07-05T10:35:36.000Z (6 months ago)
- Last Synced: 2024-12-07T18:06:24.221Z (14 days ago)
- Topics: rust, youtube, youtube-downloader
- Language: Rust
- Homepage:
- Size: 288 KB
- Stars: 231
- Watchers: 9
- Forks: 41
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
#
rustube
[](https://crates.io/crates/rustube)
[](https://docs.rs/rustube)
[](https://github.com/DzenanJupic/rustube)
---
A complete (WIP), and easy to use YouTube downloader.
> **Note**: 0.3.5 is a temporary fix to adapt to changes in the YouTube api (#38). Unfortunately this fix does not
> work for age restricted videos. We are working on a fix for that in #39.
## Overview
- [Roadmap](#roadmap)
- [Usage](#usage)
- [CLI](#cli)
- [Contributing](#contributing)
## Roadmap
- [x] download normal videos
- [ ] download age restricted videos *(no longer works since 0.3.5 due to a change in the YouTube API)*
- [x] asynchronous API
- [x] blocking API
- [ ] full video info deserialization
- [ ] feature based opt-in deserialization of video info
- [x] CLI
- [x] testing suite
- [ ] benchmarks
- [ ] Python bindings
- [ ] C / C++ bindings
## Usage
`rustube` provides an extremely easy to use API. If you just want to download a video and don't care about any
intermediate steps and any video information, this is all you need:
```rust
#[tokio::main]
async fn main() {
let url = "https://www.youtube.com/watch?v=Edx9D2yaOGs&ab_channel=CollegeHumor";
println!("downloaded video to {:?}", rustube::download_best_quality(&url).await.unwrap());
}
```
Of course, `rustube` has a lot more capabilities than just downloading videos. It also aims at deserializing the
complete video information provided by YouTube (this is still WIP). So finding out the view count of a video is as
simple as:
```rust
use rustube::{Id, VideoFetcher};
let id = Id::from_raw("https://www.youtube.com/watch?v=Edx9D2yaOGs&ab_channel=CollegeHumor").unwrap();
let descrambler = VideoFetcher::from_id(id.into_owned())
.unwrap()
.fetch()
.await
.unwrap();
let view_count = descrambler.video_details().view_count;
let title = descrambler.video_title();
println!("The video `{}` was viewed {} times.", title, view_count);
```
For more examples, an overview of the blocking API have a look at the [API documentation].
## CLI
`rustube` comes with a CLI, `rustube-cli`, so you can download your favorite YouTube videos without having to write a
single line of code.
To install it, simply run
```
cargo install rustube-cli
```
After you successfully installed `rustube-cli`, you have access to the command `rustube`
```
A simple CLI for the rustube YouTube-downloader library.
For documentation and more information about rustube or the rustube-cli checkout
`https://github.com/DzenanJupic/rustube`.
For help with certain subcommands run `rustube --help`.
USAGE:
rustube
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
check Checks if a video can be downloaded and fetches information about it
This command is similar to fetch, in the way that it also fetches information
about a video, but, other then fetch, will also decrypt all stream URLs.
Therefore you can use the returned URLs for downloading the video. This of
course means that the video has to be downloadable.
By default this command will check for any streams that contain a video and an
audio track. To specify other behavior, like checking for a stream with a
particular quality, have a look at the subcommand help.
download Downloads a YouTube video
By default, the Stream with the best quality and both a video, and an audio
track will be downloaded. To specify other download behavior, have a look the
the subcommand help.
fetch Fetches information about a YouTube video
Fetching information does not require the video to actually be downloadable. So
this also works when a video is, i.e., an offline stream. The downside is that
you often don't have access to the stream URLs. Some videos come with pre-
decrypted urls, in which case you can also use these to download the video, but
if the video url is encrypted there's no way for you to download the video using
only the returned information. To get decrypted URLs, have a look at `check`.
For most use cases it's recommended to use `check` instead, since it gives you
both more control and more information.
help Prints this message or the help of the given subcommand(s)
```
## Contributing
`rustube` is still in a pretty early stage, and you are welcome to contribute to it! The goal is to utilize the speed,
the type system, and the safety of Rust to make the fastest, most reliable, and most complete YouTube downloader out
there.
This project is 100% open source. Any contribution submitted for inclusion in `rustube` by you, shall have both the MIT
licence and the Apache-2.0 licence, and shall be licensed as MIT OR Apache-2.0, without any additional terms or
conditions.
### Licence
This project is licensed under the terms of the MIT licence or the Apache-2.0 licence, at your own choice.
[API documentation]: https://docs.rs/rustube/