yaydl
yet another youtube (and more) down loader
% yaydl "https://www.youtube.com/watch?v=jNQXAC9IVRw"
How? What? Why?
% yaydl --help
Features
- Can download videos.
- Can optionally keep only the audio part of them.
- Could convert the resulting file to something else (requires the
ffmpegbinary). - Comes as a single binary (once compiled) - take it everywhere on your thumbdrive, no Python cruft required.
Currently supported sites
- porndoe.com · vidoza.net · vimeo.com · vivo.sx · voe.sx · watchmdh.to · xhamster.com · youtube.com
There is an easy way to add more supported sites, see below for details.
Non-features
The list of features is deliberately kept short:
- No output quality choice.
yaydlassumes that you have a large hard drive and your internet connection is good enough, or else you would stream, not download. - No complex filters. This is a downloading tool.
- No image file support. Videos only.
How to install
From the source code
Install Rust (e.g. with rustup), then:
using Fossil:
% fossil clone https://code.rosaelefanten.org/yaydl
% cd yaydl
% cargo build --release
using Git:
% git clone https://github.com/dertuxmalwieder/yaydl
% cd yaydl
% cargo build --release
From Cargo
% cargo install yaydl
From your package manager
pkgsrc (with pkg_add):
% pkg_add yaydl
pkgsrc (with pkgin):
% pkgin install yaydl
Other package managers:
- Nobody has provided any other packages for
yaydlyet. You can help!
How to use the web driver (very beta, at your own risk!)
For some video sites, yaydl needs to be able to parse a JavaScript on them. For this, it needs to be able to spawn a headless web browser. It requires Google Chrome, Microsoft Edge or Mozilla Firefox to be installed and running on your system.
- Install and run ChromeDriver (if you use Chrome), the typically named Microsoft Edge WebDriver (if you use Edge) or geckodriver (if you use Firefox) for your platform.
- Tell
yaydlthat you have a web driver running:yaydl --webdriver. (The drivers usually run on port 4444 or 9515, please consult their documentation if you are not sure.) Hint: If you need this feature regularly, you can also use the environment variableYAYDL_WEBDRIVER_PORTto set the port number for all further requests. - In theory, it should be possible to use more sites with
yaydlnow. :-)
How to contribute code
- Read and agree to the Code of
ConductMerit. - Implicitly agree to the LICENSE. Nobody reads those. I don't either.
- Find out if anyone has filed a GitHub Issue or even sent a Pull Request yet. Act accordingly.
- Send me a patch, either via e-mail (
yaydl at tuxproject dot de), on the IRC or as a GitHub Pull Request. Note that GitHub only provides a mirror, so you'd double my work if you choose the latter. :-)
If you do that well (and regularly) enough, I'll probably grant you commit access to the upstream Fossil repository.
Add support for new sites
- Implement
definitions::SiteDefinitionashandlers/..rs - Push the new handler to the inventory:
inventory::submit! { &YourSiteHandler as &dyn SiteDefinition } - Add the new module to
handlers.rs. - Optionally, add new requirements to
Cargo.toml. - Send me a patch, preferably with an example. (I cannot know all sites.)
Minimal example that does nothing
(&'a self, url: &'a str, webdriver_port: u16, onlyaudio: bool) -> Result {
// Return the direct download URL of the video (or its audio version) here.
// Exception: If is_playlist() is true, return the playlist URL here instead.
Ok("".to_string())
}
fn find_video_file_extension<'a>(&'a self, url: &'a str, webdriver_port: u16, onlyaudio: bool) -> Result {
// Return the designated file extension of the video (or audio) file here.
Ok("mp4".to_string())
}
fn display_name<'a>(&'a self) -> String {
// For cosmetics, this is the display name of this handler.
"NoopExample"
}
fn web_driver_required<'a>(&'a self) -> bool {
// Return true here, if the implementation requires a web driver to be running.
false
}
}
// Push the site definition to the list of known handlers:
inventory::submit! {
&NoopExampleHandler as &dyn SiteDefinition
}">
// handlers/noop.rs use anyhow::Result; use crate::definitions::SiteDefinition; struct NoopExampleHandler; impl SiteDefinition for NoopExampleHandler { // Parameters sent to the handler by yaydl: // - url: The video page's URL. // - webdriver_port: The port that runs the WebDriver client. // Defaults to 0 if there is no WebDriver configured. // - onlyaudio: true if only the audio part of the video should be // kept, else false. fn can_handle_url<'a>(&'a self, url: &'a str, webdriver_port: u16) -> bool { // Return true here ifcan be covered by this handler. // Note that yaydl will skip all other handlers then. true } fn does_video_exist<'a>(&'a self, url: &'a str, webdriver_port: u16) -> Result<bool> { // Return true here, if the video exists. Ok(false) } fn is_playlist<'a>(&'a self, url: &'a str, webdriver_port: u16) -> Result<bool> { // Return true here, if the download link is a playlist. Ok(false) } fn find_video_title<'a>(&'a self, url: &'a str, webdriver_port: u16) -> Result<String> { // Return the video title fromhere. Ok("".to_string()) } fn find_video_direct_url<'a>(&'a self, url: &'a str, webdriver_port: u16, onlyaudio: bool) -> Result<String> { // Return the direct download URL of the video (or its audio version) here. // Exception: If is_playlist() is true, return the playlist URL here instead. Ok("".to_string()) } fn find_video_file_extension<'a>(&'a self, url: &'a str, webdriver_port: u16, onlyaudio: bool) -> Result<String> { // Return the designated file extension of the video (or audio) file here. Ok("mp4".to_string()) } fn display_name<'a>(&'a self) -> String { // For cosmetics, this is the display name of this handler. "NoopExample" } fn web_driver_required<'a>(&'a self) -> bool { // Return true here, if the implementation requires a web driver to be running. false } } // Push the site definition to the list of known handlers: inventory::submit! { &NoopExampleHandler as &dyn SiteDefinition }
Fix some bugs or add new features
- Do so.
- Send me a patch.
Donations
Writing this software and keeping it available is eating some of the time which most people would spend with their friends. Naturally, I absolutely accept financial compensation.
- PayPal: GebtmireuerGeld
- Liberapay: Cthulhux
Thank you.
Contact
- Twitter: @tux0r
- Forum: DonationCoder.com
- IRC:
irc.oftc.net/yaydl - Matrix: @tux0r:matrix.org
28 Jan 2, 2023
8 May 24, 2022
2 Mar 28, 2022
3 May 9, 2023
121 Dec 20, 2022
2 Apr 27, 2022
1.3k Dec 30, 2022
7 Oct 3, 2022
11 Oct 17, 2022
32 Oct 6, 2023
1.6k Jan 7, 2023
7.1k Jan 8, 2023
409 Oct 23, 2022
24 Dec 1, 2022
1.7k Jan 9, 2023
2 Sep 19, 2022
17 Nov 8, 2022
39 Nov 26, 2022
12 Sep 24, 2022