bbc-radio-tracklisting-downloader 0.0.2

Usage examples

Run bbc_tracklist.py from the command line.

Required arguments are an action: one of tag, text or both and a BBC programme id, the 8 characters that are found at the end of iPlayer URLs such as:http://www.bbc.co.uk/iplayer/episode/<programme id>/<programme name> or programme information URLs such as: http://www.bbc.co.uk/programmes/<programme id>, e.g. b03d0wk8

text will save the tracklisting to a text file, tag will tag an audio file and (unsurprisingly) both will perform both of these actions.

Optional arguments are --directory DIRECTORY and --fileprefix FILEPREFIX. The --fileprefix is the filename prefix: e.g. for some_bbc_audio.mp3, the filename prefix is some_bbc_audio.

If either of these are omitted, output will be to the current path. If no filename is specified, any audio file you want tagging should be named as the pid. Any text file generated without a filename will be called pid.txt.

First, if tag or both actions are chosen, the script tries to tag an M4A file, then an MP3. If it fails to find (or write to) an appropriate audio file, it falls back to creating a text file.

The script generates an output formatted as:

Programme title
Programme first broadcast date

Artist
Title
Record label

***

Installation requirements

• Tested on Python 2.7.3 on Windows (Windows 7 64-bit) and Linux (Raspbian and Ubuntu 12.04). (I suspect it doesn’t work with Python versions earlier than this due to improvements in Python’s HTMLParser introduced in 2.7.3.)

• Not compatible with Python 3.4 as yet. This code shouldn’t be hard to port, but beets is not yet Python 3 compatible.

• Requires beets, requests and lxml.

Known issue (don’t think there’s an easy fix)

• Printing tracklisting in Windows doesn’t play nicely with non-ASCII characters; these are ignored. (Printing occurs if directory and fileprefix are invalid.) You can try running cmd /u in a command prompt if you find this an issue (not tested).