Provided by: get-iplayer_2.83-1_all 
NAME
get_iplayer - Stream Recording tool and PVR for BBC iPlayer, BBC Podcasts and more
SYNOPSIS
get_iplayer [<options>] [<regex|index> ...]
get_iplayer --get [<options>] <regex|index> ...
get_iplayer <url> --type=<type> [<options>]
get_iplayer <pid|url> [--type=<type> <options>]
get_iplayer --stream [<options>] <regex|index> | mplayer -cache 3072 -
get_iplayer --stream [<options>] --type=<type> <pid|url> | mplayer -cache 3072 -
get_iplayer --stream [<options>] --type=livetv,liveradio <regex|index> --player="mplayer
-cache 128 -"
get_iplayer --refresh
DESCRIPTION
get_iplayer lists, searches and records BBC iPlayer TV/Radio, BBC Podcast programmes.
Other 3rd-Party plugins may be available.
get_iplayer has three modes: recording a complete programme for later playback, streaming
a programme directly to a playback application, such as mplayer; and as a Personal Video
Recorder (PVR), subscribing to search terms and recording programmes automatically. It can
also stream or record live BBC iPlayer output
If given no arguments, get_iplayer updates and displays the list of currently available
programmes. Each available programme has a numerical identifier, pid. get_iplayer
utilises the rtmpdump tool to record BBC iPlayer programmes from RTMP flash streams at
various qualities.
In PVR mode, get_iplayer can be called from cron to record programmes to a schedule.
OPTIONS
Search Options:
--before
Limit search to programmes added to the cache before N hours ago
--category <string>
Narrow search to matched categories (regex or comma separated values)
--channel <string>
Narrow search to matched channel(s) (regex or comma separated values)
--exclude <string>
Narrow search to exclude matched programme names (regex or comma separated values)
--exclude-category <string>
Narrow search to exclude matched categories (regex or comma separated values)
--exclude-channel <string>
Narrow search to exclude matched channel(s) (regex or comma separated values)
--fields <field1>,<field2>,..
Searches only in the specified comma separated fields
--future
Search future programme schedule if it has been indexed (refresh cache with:
--refresh --refresh-future).
--history
Search/show recordings history
--long, -l
Additionally search in programme descriptions and episode names (same as
--fields=name,episode,desc )
--search <search term>
GetOpt compliant way of specifying search args
--since
Limit search to programmes added to the cache in the last N hours
--type <type>
Only search in these types of programmes: livetv,tv,liveradio,radio,all (tv is
default)
--versions <versions>
Version of programme to search or record. List is processed from left to right and
first version found is downloaded. Example: '--versions
signed,audiodescribed,default' will prefer signed and audiodescribed programmes if
available. Default: 'default'
Display Options:
--conditions
Shows GPLv3 conditions
--debug
Debug output
--dump-options
Dumps all options with their internal option key names
--help, -h
Intermediate help text
--helpbasic, --usage
Basic help text
--helplong
Advanced help text
--hide Hide previously recorded programmes
--info, -i
Show full programme metadata and availability of modes and subtitles (max 50
matches)
--list <categories|channel>
Show a list of available categories/channels for the selected type and exit
--listformat <format>
Display programme data based on a user-defined format string (such as <pid>, <name>
etc)
--listplugins
Display a list of currently available plugins or programme types
--long, -l
Show long programme info
--manpage <file>
Create man page based on current help text
--nocopyright
Don't display copyright header
--page <number>
Page number to display for multipage output
--pagesize <number>
Number of matches displayed on a page for multipage output
--quiet, -q
No logging output
--series
Display Programme series names only with number of episodes
--show-cache-age
Displays the age of the selected programme caches then exit
--show-options
Shows options which are set and where they are defined
--sort <fieldname>
Field to use to sort displayed matches
--sortreverse
Reverse order of sorted matches
--streaminfo
Returns all of the media stream urls of the programme(s)
--terse
Only show terse programme info (does not affect searching)
--tree Display Programme listings in a tree view
--verbose, -v
Verbose
--warranty
Displays warranty section of GPLv3
-V Show get_iplayer version and exit.
Recording Options:
--aactomp3
Transcode AAC audio to MP3 with ffmpeg/avconv (CBR 128k unless --mp3vbr is
specified)
--attempts <number>
Number of attempts to make or resume a failed connection
--bandwidth
In radio realaudio mode specify the link bandwidth in bps for rtsp streaming
(default 512000)
--ffmpeg-liveradio-opts <options>
Add custom options to ffmpeg re-muxing for liveradio
--ffmpeg-livetv-opts <options>
Add custom options to ffmpeg re-muxing for livetv
--ffmpeg-radio-opts <options>
Add custom options to ffmpeg re-muxing for radio
--ffmpeg-tv-opts <options>
Add custom options to ffmpeg re-muxing for tv
--force
Ignore programme history (unsets --hide option also). Forces a script update if
used with -u
--get, -g
Start recording matching programmes. Search terms required unless --pid specified.
Use --search=.* to force download of all available programmes.
--hash Show recording progress as hashes
--liveradiomode <mode>,<mode>,..
Live Radio recording modes: flashaachigh,flashaacstd,flashaudio,flashaaclow,wma.
Shortcuts: default,good,better(=default),best,rtmp,flash,flashaac.
('default'=flashaachigh,flashaacstd,flashaaclow,wma)
--livetvmode <mode>,<mode>,...
Live TV recording modes:
flashhd,flashvhigh,flashhigh,flashstd,flashnormal,flashlow. Shortcuts:
default,good,better(=default),best,rtmp,flash.
('default'=flashvhigh,flashhigh,flashstd,flashnormal,flashlow)
--metadata-only
Create specified metadata info file without any recording or streaming (can also be
used with thumbnail option).
--mmsnothread
Disable parallel threaded recording for mms
--modes <mode>,<mode>,...
Recording modes. See --tvmode and --radiomode for available modes and defaults.
Shortcuts: default,good,better(=default),best. Use --modes=best to select highest
quality available (incl. HD TV).
--mp3vbr
Set LAME VBR mode to N (0 to 9) for AAC transcoding. 0 = target bitrate 245 Kbit/s,
9 = target bitrate 65 Kbit/s (requires --aactomp3)
--multimode
Allow the recording of more than one mode for the same programme - WARNING: will
record all specified/default modes!!
--overwrite
Overwrite recordings if they already exist
--partial-proxy
Only uses web proxy where absolutely required (try this extra option if your proxy
fails)
--pid <pid>
Record an arbitrary pid that does not necessarily appear in the index.
--pid-recursive
When used with --pid record all the embedded pids if the pid is a series or brand
pid.
--proxy, -p <url>
Web proxy URL e.g. 'http://USERNAME:PASSWORD@SERVER:PORT' or 'http://SERVER:PORT'
--radiomode <mode>,<mode>,...
Radio recording modes: flashaachigh,flashaacstd,flashaudio,flashaaclow,wma.
Shortcuts: default,good,better(=default),best,rtmp,flash,flashaac.
('default'=flashaachigh,flashaacstd,flashaudio,flashaaclow,wma)
--raw Don't transcode or change the recording/stream in any way (i.e. radio/realaudio,
rtmp/flv)
--rtmp-liveradio-opts <options>
Add custom options to rtmpdump for liveradio
--rtmp-livetv-opts <options>
Add custom options to rtmpdump for livetv
--rtmp-radio-opts <options>
Add custom options to rtmpdump for radio
--rtmp-tv-opts <options>
Add custom options to rtmpdump for tv
--rtmpport <port>
Override the RTMP port (e.g. 443)
--start <secs|hh:mm:ss>
Recording/streaming start offset (rtmp and realaudio only)
--stop <secs|hh:mm:ss>
Recording/streaming stop offset (can be used to limit live rtmp recording length)
rtmp and realaudio only
--suboffset <offset>
Offset the subtitle timestamps by the specified number of milliseconds
--subsraw
Additionally save the raw subtitles file
--subtitles
Download subtitles into srt/SubRip format if available and supported
--subtitles-only
Only download the subtitles, not the programme
--tag-only
Only update the programme tag and not download the programme (can also be used with
--history)
--test, -t
Test only - no recording (will show programme type)
--thumb
Download Thumbnail image if available
--thumbnail-only
Only Download Thumbnail image if available, not the programme
--tvmode <mode>,<mode>,...
TV recording modes: flashhd,flashvhigh,flashhigh,flashstd,flashnormal,flashlow.
Shortcuts: default,good,better(=default),best,rtmp,flash. (Use 'best' for HD TV.
'default'=flashvhigh,flashhigh,flashstd,flashnormal,flashlow)
--url "<url>"
Record the embedded media player in the specified URL. Use with --type=<type>.
--wav In radio realaudio mode output as wav and don't transcode to mp3
Output Options:
--command, -c <command>
Run user command after successful recording using args such as <pid>, <name> etc
--email <address>
Email HTML index of matching programmes to specified address
--email-password <password>
Email password
--email-port <port number>
Email port number (default: appropriate port for --email-security)
--email-security <TLS|SSL>
Email security TLS, SSL (default: none)
--email-sender <address>
Optional email sender address
--email-smtp <hostname>
SMTP server IP address to use to send email (default: localhost)
--email-user <username>
Email username
--fatfilename
Omit characters forbidden by FAT filesystems from filenames but keep whitespace
--file-prefix <format>
The filename prefix (excluding dir and extension) using formatting fields. e.g.
'<name>-<episode>-<pid>'
--fxd <file>
Create Freevo FXD XML of matching programmes in specified file
--html <file>
Create basic HTML index of matching programmes in specified file
--isodate
Use ISO8601 dates (YYYY-MM-DD) in filenames
--metadata <type>
Create metadata info file after recording. Valid types are: xbmc, xbmc_movie,
freevo, generic
--mkv Output video in MKV container instead of MP4. Currently no tagging supported from
get_iplayer for MKV output
--mythtv <file>
Create Mythtv streams XML of matching programmes in specified file
--nowrite, -n
No writing of file to disk (use with -x to prevent a copy being stored on disk)
--output, -o <dir>
Recording output directory
--outputliveradio <dir>
Output directory for live radio recordings
--outputlivetv <dir>
Output directory for live tv recordings
--outputlocalfiles <dir>
Output directory for localfiles recordings
--outputpodcast <dir>
Output directory for podcast recordings
--outputradio <dir>
Output directory for radio recordings
--outputtv <dir>
Output directory for tv recordings
--player '<command> <options>'
Use specified command to directly play the stream
--stdout, -x
Additionally stream to STDOUT (so you can pipe output to a player)
--stream
Stream to STDOUT (so you can pipe output to a player)
--subdir, -s
Put Recorded files into Programme name subdirectory
--subdir-format <format>
The format to be used for the subdirectory naming using formatting fields. e.g.
'<nameshort>-<seriesnum>'
--symlink <file>
Create symlink to <file> once we have the header of the recording
--thumb-ext <ext>
Thumbnail filename extension to use
--thumbsize <index|width>
Default thumbnail size/index to use for the current recording and metadata (see
--info for thumbnailN: to get size/index)
--thumbsizecache <index|width>
Default thumbnail size/index to use when building cache and index (see --info for
thumbnailN: to get size/index)
--whitespace, -w
Keep whitespace (and escape chars) in filenames
--xml-alpha
Create freevo/Mythtv menu sorted alphabetically by programme name
--xml-channels
Create freevo/Mythtv menu of channels -> programme names -> episodes
--xml-names
Create freevo/Mythtv menu of programme names -> episodes
PVR Options:
--comment <string>
Adds a comment to a PVR search
--pvr [pvr search name]
Runs the PVR using all saved PVR searches (intended to be run every hour from cron
etc). The list can be limited by adding a regex to the command. Synonyms: --pvrrun,
--pvr-run
--pvr-add <search name>
Save the named PVR search with the specified search terms. Search terms required.
Use --search=.* to force download of all available programmes. Synonyms: --pvradd
--pvr-del <search name>
Remove the named search from the PVR searches. Synonyms: --pvrdel
--pvr-disable <search name>
Disable (not delete) a named PVR search. Synonyms: --pvrdisable
--pvr-enable <search name>
Enable a previously disabled named PVR search. Synonyms: --pvrenable
--pvr-exclude <string>
Exclude the PVR searches to run by search name (regex or comma separated values).
Synonyms: --pvrexclude
--pvr-list
Show the PVR search list. Synonyms: --pvrlist
--pvr-queue
Add currently matched programmes to queue for later one-off recording using the
--pvr option. Search terms required unless --pid specified. Use --search=.* to
force download of all available programmes. Synonyms: --pvrqueue
--pvr-scheduler <seconds>
Runs the PVR using all saved PVR searches every <seconds>. Synonyms: --pvrscheduler
--pvr-single <search name>
Runs a named PVR search. Synonyms: --pvrsingle
Config Options:
--expiry, -e <secs>
Cache expiry in seconds (default 4hrs)
--limit-matches <number>
Limits the number of matching results for any search (and for every PVR search)
--localfilesdirs <dir>[,dir,]
Directories/Folders to scan for new files
--nopurge
Don't ask to delete programmes recorded over 30 days ago
--packagemanager <string>
Tell the updater that we were installed using a package manager and don't update
(use either: apt,rpm,deb,yum,disable)
--plugins-update
Update get_iplayer plugins to the latest
--prefs-add
Add/Change specified saved user or preset options
--prefs-clear
Remove *ALL* saved user or preset options
--prefs-del
Remove specified saved user or preset options
--prefs-show
Show saved user or preset options
--preset, -z <name>
Use specified user options preset
--preset-list
Show all valid presets
--profile-dir <dir>
Override the user profile directory/folder
--refresh, --flush, -f
Refresh cache
--refresh-exclude <string>
Exclude matched channel(s) when refreshing cache (regex or comma separated values)
--refresh-future
Obtain future programme schedule when refreshing cache (between 7-14 days)
--refresh-include <string>
Include matched channel(s) when refreshing cache (regex or comma separated values)
--skipdeleted
Skip the download of metadata/thumbs/subs if the media file no longer exists. Use
with --history & --metadataonly/subsonly/thumbonly.
--update, -u
Update get_iplayer if a newer one exists
--webrequest <urlencoded string>
Specify all options as a urlencoded string of "name=val&name=val&..."
External Program Options:
--atomicparsley <path>
Location of AtomicParsley tagger binary
--ffmpeg <path>
Location of ffmpeg or avconv binary. Synonyms: --avconv
--id3v2 <path>
Location of id3v2 or id3tag binary
--lame <path>
Location of lame binary
--mplayer <path>
Location of mplayer binary
--rtmpdump <path>
Location of rtmpdump binary. Synonyms: --flvstreamer
--vlc <path>
Location of vlc or cvlc binary
Tagging Options:
--no-artwork
Do not embed thumbnail image in output file. All other metadata values will be
written.
--no-tag
Do not tag downloaded programmes
--tag-cnid
Use AtomicParsley --cnID argument (if supported) to add catalog ID used for
combining HD and SD versions in iTunes
--tag-fulltitle
Use complete title (including series) instead of shorter episode title
--tag-hdvideo
AtomicParsley supports --hdvideo argument for HD video flag
--tag-longdesc
AtomicParsley supports --longdesc argument for long description text
--tag-longdescription
AtomicParsley supports --longDescription argument for long description text
--tag-podcast
Tag downloaded radio and tv programmes as iTunes podcasts (requires MP3::Tag module
for AAC/MP3 files)
--tag-podcast-radio
Tag only downloaded radio programmes as iTunes podcasts (requires MP3::Tag module
for AAC/MP3 files)
--tag-podcast-tv
Tag only downloaded tv programmes as iTunes podcasts
--tag-utf8
AtomicParsley accepts UTF-8 input
AUTHOR
get_iplayer was written by Phil Lewis <iplayer2 (at sign) linuxcentre.net> and is now
maintained by the contributors at
http://www.infradead.org/get_iplayer/html/get_iplayer.html
This manual page was originally written by Jonathan Wiltshire <jmw@debian.org> for the
Debian project (but may be used by others).
COPYRIGHT NOTICE
get_iplayer v2.83, Copyright (C) 2008-2010 Phil Lewis
This program comes with ABSOLUTELY NO WARRANTY; for details use --warranty.
This is free software, and you are welcome to redistribute it under certain
conditions; use --conditions for details.