Rust client for the public YouTube / YouTube Music API (Innertube)
Go to file
ThetaDev 182826a3ac
All checks were successful
Release / Release (push) Successful in 3m3s
CI / Test (push) Successful in 4m9s
chore(release): release rustypipe v0.2.1
2024-07-01 23:37:02 +02:00
.forgejo/workflows ci: fix release changelog extraction 2024-06-27 14:00:20 +02:00
.vscode chore: vscode: enable rss feature by default 2024-06-14 16:16:05 +02:00
cli chore(release): release rustypipe-cli v0.1.1 2024-06-27 14:07:08 +02:00
codegen feat: make get_visitor_data() public 2024-06-16 02:18:04 +02:00
downloader chore(release): release rustypipe-downloader v0.1.1 2024-06-27 14:00:55 +02:00
notes docs: add logo 2024-06-27 02:18:04 +02:00
src fix: parsing audiobook type in European Portuguese 2024-06-27 03:20:00 +02:00
testfiles fix: parsing audiobook type in European Portuguese 2024-06-27 03:20:00 +02:00
tests test: fix tests 2024-06-27 05:16:57 +02:00
.editorconfig fix: add new attributed_text description 2022-09-24 18:41:27 +02:00
.gitignore chore: migrate insta snapshots to RON 2022-09-24 18:50:52 +02:00
.pre-commit-config.yaml chore: fix clippy lints 2023-09-16 23:34:34 +02:00
.woodpecker.yml chore: update woodpecker pipeline schema 2023-11-23 02:11:44 +01:00
Cargo.toml chore(release): release rustypipe v0.2.1 2024-07-01 23:37:02 +02:00
CHANGELOG.md chore(release): release rustypipe v0.2.1 2024-07-01 23:37:02 +02:00
cliff.toml test: fix asserts: client version parts, iOS client bitrate 2024-05-17 18:27:24 +02:00
Justfile chore(release): release rustypipe v0.2.0 2024-06-27 13:36:39 +02:00
LICENSE chore: add readme and license 2022-09-19 01:15:42 +02:00
README.md test: fix tests 2024-06-27 03:13:59 +02:00
renovate.json ci: renovate: disable lockfile maintenance 2024-06-27 05:47:47 +02:00

RustyPipe

Rust client for the public YouTube / YouTube Music API (Innertube), inspired by NewPipe.

Features

YouTube

  • Player (video/audio streams, subtitles)
  • VideoDetails (metadata, comments, recommended videos)
  • Playlist
  • Channel (videos, shorts, livestreams, playlists, info, search)
  • ChannelRSS
  • Search (with filters)
  • Search suggestions
  • Trending
  • URL resolver

YouTube Music

  • Playlist
  • Album
  • Artist
  • Search
  • Search suggestions
  • Radio
  • Track details (lyrics, recommendations)
  • Moods/Genres
  • Charts
  • New (albums, music videos)

Getting started

Cargo.toml

[dependencies]
rustypipe = "0.1.3"
tokio = { version = "1.20.0", features = ["macros", "rt-multi-thread"] }

Watch a video

use std::process::Command;

use rustypipe::{client::RustyPipe, param::StreamFilter};

#[tokio::main]
async fn main() {
    // Create a client
    let rp = RustyPipe::new();
    // Fetch the player
    let player = rp.query().player("pPvd8UxmSbQ").await.unwrap();
    // Select the best streams
    let (video, audio) = player.select_video_audio_stream(&StreamFilter::default());

    // Open mpv player
    let mut args = vec![video.expect("no video stream").url.to_owned()];
    if let Some(audio) = audio {
        args.push(format!("--audio-file={}", audio.url));
    }
    Command::new("mpv").args(args).output().unwrap();
}

Get a playlist

use rustypipe::client::RustyPipe

#[tokio::main]
async fn main() {
    // Create a client
    let rp = RustyPipe::new();
    // Get the playlist
    let playlist = rp
        .query()
        .playlist("PL2_OBreMn7FrsiSW0VDZjdq0xqUKkZYHT")
        .await
        .unwrap();
    // Get all items (maximum: 1000)
    playlist.videos.extend_limit(rp.query(), 1000).await.unwrap();

    println!("Name: {}", playlist.name);
    println!("Author: {}", playlist.channel.unwrap().name);
    println!("Last update: {}", playlist.last_update.unwrap());

    playlist
        .videos
        .items
        .iter()
        .for_each(|v| println!("[{}] {} ({}s)", v.id, v.name, v.length));
}

Output:

Name: Homelab
Author: Jeff Geerling
Last update: 2023-05-04
[cVWF3u-y-Zg] I put a computer in my computer (720s)
[ecdm3oA-QdQ] 6-in-1: Build a 6-node Ceph cluster on this Mini ITX Motherboard (783s)
[xvE4HNJZeIg] Scrapyard Server: Fastest all-SSD NAS! (733s)
[RvnG-ywF6_s] Nanosecond clock sync with a Raspberry Pi (836s)
[R2S2RMNv7OU] I made the Petabyte Raspberry Pi even faster! (572s)
[FG--PtrDmw4] Hiding Macs in my Rack! (515s)
...

Get a channel

use rustypipe::client::RustyPipe

#[tokio::main]
async fn main() {
    // Create a client
    let rp = RustyPipe::new();
    // Get the channel
    let channel = rp
        .query()
        .channel_videos("UCl2mFZoRqjw_ELax4Yisf6w")
        .await
        .unwrap();

    println!("Name: {}", channel.name);
    println!("Description: {}", channel.description);
    println!("Subscribers: {}", channel.subscriber_count.unwrap());

    channel
        .content
        .items
        .iter()
        .for_each(|v| println!("[{}] {} ({}s)", v.id, v.name, v.length.unwrap()));
}

Output:

Name: Louis Rossmann
Description: I discuss random things of interest to me. (...)
Subscribers: 1780000
[qBHgJx_rb8E] Introducing Rossmann senior, a genuine fossil 😃 (122s)
[TmV8eAtXc3s] Am I wrong about CompTIA? (592s)
[CjOJJc1qzdY] How FUTO projects loosen Google's grip on your life! (588s)
[0A10JtkkL9A] a private moment between a man and his kitten (522s)
[zbHq5_1Cd5U] Is Texas mandating auto repair shops use OEM parts? SB1083 analysis & breakdown; tldr, no. (645s)
[6Fv8bd9ICb4] Who owns this? (199s)
...

Development

Requirements:

Tasks

Testing

  • just test Run unit+integration tests
  • just unittest Run unit tests
  • just testyt Run YouTube integration tests
  • just testintl Run YouTube integration tests for all supported languages (this takes a long time and is therefore not run in CI)
  • YT_LANG=de just testyt Run YouTube integration tests for a specific language

Tools

  • just testfiles Download missing testfiles for unit tests
  • just report2yaml Convert RustyPipe reports into a more readable yaml format (requires yq)