beebget

Synopsis

beebget is a command-line tool for downloading BBC radio programs that are available via iPlayer to OGG/Vorbis format. It works in a subscription-based manner, similar to podcast clients. Each time it is run, new episodes of your subscribed programs are automatically downloaded.

Requirements

Beebget should (in principle) work on any UNIX-like system with the following software:

python (>=2.5)
mplayer
oggenc

Download

beebget-0.1

Howto

Download and unpack beebget, probably to a location in $PATH. To subscribe to some programs, first list available services:

beebget --list-services

Then list the available programs for your chosen service:

beebget --list-programs serviceid

The serviceid is the short identifier shown in square brackets in the services list (e.g. radio4). To subscribe to a program, run

beebget --add-sub programid

Again, the programid is the part in square brackets from the program list (e.g. b006qnwb). Repeat for each program you are interested in. Now, to see what beebget wants to do, run:

beebget --status

This will output a list of programs and/or episodes, and the status of each. Some of the important status tags are:

Get: this episode will be downloaded to the shown path
Skip: episode will be skipped because it's already downloaded (or you skipped it)
NoEp: this program currently has no episodes available

If you're happy with what beebget wants to do, run:

beebget --download-all

Otherwise, you can get more information on each episode, and interactively select those you want to download, with:

beebget --interactive

The file download path can be configured in beebget's config file, by default at ~/.beebget/config.

Usage

   Usage: beebget [options]

   Options:
   -h, --help            show this help message and exit
   -A, --download-all    download new episodes of subscribed programs
   -I, --interactive     interactively download new episodes
   -s, --status          display status of subscribed programs
   --add-subs=PROGID     subscribe to program PROGID
   --list-subs           list subscribed programs
   --list-services       list available services
   --list-programs=SERVICE
                         list programs currently available on SERVICE
   --list-episodes=PROGID
                         list available episodes of program PROGID
   --config=FILE         path to configuration file
   -D, --debug           increase debug level
   --drop-cache          drop url cache
   -f, --force           don't prompt
   -q, --quiet           minimal output
   -V, --version         print version