#video #pbs #cli-applications #cli

app oscar

A CLI application to download videos from PBS. Ideally run in cron or another scheduler.

5 releases

0.1.20 Aug 3, 2020
0.1.6 Aug 2, 2020
0.1.3 Dec 18, 2019
0.1.2 Dec 13, 2019
0.1.0 Dec 6, 2019

#3 in #pbs

MIT/Apache

21KB
258 lines

Oscar

Build Status

A CLI application to download full TV episodes from PBS. Ideally run in cron or another scheduler.

Example

@hourly oscar -so /mnt/nas/videos/

Installation

Pre-built binaries

Pre-built binaries are available via Github releases (which are built by TravisCI).

Cargo

cargo install oscar

From source

Requires Rust and Cargo to be installed on the host system.

To build: cargo build --release

Subcommands

list: View available shows in "slug" format, e.g. sesame-street.

FYI oscar defaults to downloading Sesame Street episodes.

Options

-d --dry-run: run without actually downloading any files.

-s --silent: Do not log anything.

-o --output: Where to save episodes, defaults to /tmp/.

-S --show-slug: What show to download. Get the slug by running oscar list.

Misc

Please note that each episode at ~720p quality is around 500MB. If you are on a metered or a slow connection this may be a problem.

Every episode that is downloaded gets logged by appending its ID to a text file ~/.oscar_history. This file is checked every time oscar runs to validate if an episode is new or not.

Currently new episodes cycle in on Friday at 1am EST.

Dependencies

~26–39MB
~788K SLoC