rustypipe-downloader

Crates.iorustypipe-downloader
lib.rsrustypipe-downloader
version0.2.4
sourcesrc
created_at2024-08-18 01:30:05.247791
updated_at2024-11-10 14:07:32.412487
descriptionDownloader extension for RustyPipe
homepage
repositoryhttps://codeberg.org/ThetaDev/rustypipe
max_upload_size
id1342214
size69,218
ThetaDev (Theta-Dev)

documentation

README

RustyPipe Downloader

Current crates.io version License CI status

The downloader is a companion crate for RustyPipe that allows for easy and fast downloading of video and audio files.

Features

  • Fast download of streams, bypassing YouTube's throttling
  • Join video and audio streams using ffmpeg
  • Indicatif support to show download progress bars (enable indicatif feature to use)
  • Tag audio files with title, album, artist, date, description and album cover (enable audiotag feature to use)
  • Album covers are automatically cropped using smartcrop to ensure they are square

How to use

For the downloader to work, you need to have ffmpeg installed on your system. If your ffmpeg binary is located at a non-standard path, you can configure the location using [DownloaderBuilder::ffmpeg].

At first you have to instantiate and configure the downloader using either [Downloader::new] or the [DownloaderBuilder].

Then you can build a new download query with a video ID, stream filter and destination path and finally download the video.

use rustypipe::param::StreamFilter;
use rustypipe_downloader::DownloaderBuilder;

let dl = DownloaderBuilder::new()
    .audio_tag()
    .crop_cover()
    .build();

let filter_audio = StreamFilter::new().no_video();
dl.id("eRsGyueVLvQ").stream_filter(filter_audio).to_file("audio.opus").download().await;

let filter_video = StreamFilter::new().video_max_res(720);
dl.id("eRsGyueVLvQ").stream_filter(filter_video).to_file("video.mp4").download().await;
Commit count: 0

cargo fmt