~asimpson/oscar

A CLI application to download full TV episodes from PBS.
e7422cbe — Adam Simpson 3 years ago
chore: add license
09c7276b — Adam Simpson 3 years ago
refactor: follow Clippy recommendations
0cee91fd — Adam Simpson 3 years ago
docs: :memo: update README.

refs

master
browse  log 

clone

read-only
https://git.sr.ht/~asimpson/oscar
read/write
git@git.sr.ht:~asimpson/oscar

You can also use your local clone with git send-email.

#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.