.TH GET_IPLAYER "1" "September 2016" "Phil Lewis" "get_iplayer Manual" .SH NAME get_iplayer \- Stream Recording tool and PVR for BBC iPlayer, BBC Podcasts and more .SH SYNOPSIS \fBget_iplayer\fR [] [ ...] .PP \fBget_iplayer\fR \fB\-\-get\fR [] ... .br \fBget_iplayer\fR \fB\-\-type\fR= [] .PP \fBget_iplayer\fR [\fB\-\-type\fR= ] .PP \fBget_iplayer\fR \fB\-\-stream\fR [] | mplayer \fB\-cache\fR 3072 \- .PP \fBget_iplayer\fR \fB\-\-stream\fR [] \fB\-\-type\fR= | mplayer \fB\-cache\fR 3072 \- .PP \fBget_iplayer\fR \fB\-\-stream\fR [] \fB\-\-type\fR=livetv,liveradio \fB\-\-player\fR="mplayer \-cache 128 \-" .PP \fBget_iplayer\fR \fB\-\-refresh\fR .SH DESCRIPTION \fBget_iplayer\fR lists, searches and records BBC iPlayer TV/Radio, BBC Podcast programmes. Other 3rd\-Party plugins may be available. .PP \fBget_iplayer\fR 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 .PP If given no arguments, \fBget_iplayer\fR updates and displays the list of currently available programmes. Each available programme has a numerical identifier, \fBpid\fR. \fBget_iplayer\fR utilises the \fBrtmpdump\fR tool to record BBC iPlayer programmes from RTMP flash streams at various qualities. .PP In PVR mode, \fBget_iplayer\fR can be called from cron to record programmes to a schedule. .SH "OPTIONS" .SS "Search Options:" .TP \fB\-\-available\-since Limit search to programmes that have become available in the last N hours .TP \fB\-\-before Limit search to programmes added to the cache before N hours ago .TP \fB\-\-channel Narrow search to matched channel(s) (regex or comma separated values) .TP \fB\-\-exclude Narrow search to exclude matched programme names (regex or comma separated values) .TP \fB\-\-exclude\-channel Narrow search to exclude matched channel(s) (regex or comma separated values) .TP \fB\-\-expires\-before Limit search to programmes that will expire in the next N hours .TP \fB\-\-fields ,,.. Searches only in the specified comma separated fields .TP \fB\-\-future Additionally search future programme schedule if it has been indexed (refresh cache with: \-\-refresh \-\-refresh\-future). .TP \fB\-\-history Search/show recordings history .TP \fB\-\-long, \-l Additionally search in programme descriptions and episode names (same as \-\-fields=name,episode,desc ) .TP \fB\-\-search GetOpt compliant way of specifying search args .TP \fB\-\-since Limit search to programmes added to the cache in the last N hours .TP \fB\-\-type Only search in these types of programmes: liveradio,livetv,localfiles,podcast,radio,tv,all (tv is default) .SS "Display Options:" .TP \fB\-\-conditions Shows GPLv3 conditions .TP \fB\-\-debug Debug output .TP \fB\-\-dump\-options Dumps all options with their internal option key names .TP \fB\-\-help, \-h Intermediate help text .TP \fB\-\-helpbasic, \-\-usage Basic help text .TP \fB\-\-helplong Advanced help text .TP \fB\-\-hide Hide previously recorded programmes .TP \fB\-\-info, \-i Show full programme metadata and availability of modes and subtitles (max 40 matches) .TP \fB\-\-listformat Display programme data based on a user\-defined format string (such as , etc) .TP \fB\-\-long, \-l Show long programme info .TP \fB\-\-manpage Create man page based on current help text .TP \fB\-\-nocopyright Don't display copyright header .TP \fB\-\-page Page number to display for multipage output .TP \fB\-\-pagesize Number of matches displayed on a page for multipage output .TP \fB\-\-quiet, \-q Reduce logging output .TP \fB\-\-show\-cache\-age Displays the age of the selected programme caches then exit .TP \fB\-\-show\-options Shows options which are set and where they are defined .TP \fB\-\-silent No logging output except PVR download report. Cannot be saved in preferences or PVR searches. .TP \fB\-\-sort Field to use to sort displayed matches .TP \fB\-\-sortreverse Reverse order of sorted matches .TP \fB\-\-streaminfo Returns all of the media stream urls of the programme(s) .TP \fB\-\-verbose, \-v Verbose .TP \fB\-\-warranty Displays warranty section of GPLv3 .TP \fB\-V Show get_iplayer version and exit. .SS "Recording Options:" .TP \fB\-\-attempts Number of attempts to make or resume a failed connection. \-\-attempts is applied per\-stream, per\-mode. TV modes typically have two streams available. .TP \fB\-\-exclude\-supplier Comma\-delimited list of media stream suppliers to skip. Possible values: level3,akamai,limelight,bidi .TP \fB\-\-force Ignore programme history (unsets \-\-hide option also). Forces a script update if used with \-u .TP \fB\-\-get, \-g Start recording matching programmes. Search terms required unless \-\-pid specified. Use \-\-search=.* to force download of all available programmes. .TP \fB\-\-hash Show recording progress as hashes .TP \fB\-\-include\-supplier Comma\-delimited list of media stream suppliers to use if not included by default. Possible values: level3,akamai,limelight,bidi .TP \fB\-\-metadata\-only Create specified metadata info file without any recording or streaming (can also be used with thumbnail option). .TP \fB\-\-modes ,,... Recording modes. See \-\-tvmode and \-\-radiomode (with \-\-long\-help) for available modes and defaults. Shortcuts: tvworst,tvworse,tvgood,tvvgood,tvbetter,tvbest,radioworst,radioworse,radiogood,radiovgood,radiobetter,radiobest (default=default for programme type). .TP \fB\-\-no\-proxy Ignore \-\-proxy setting in preferences .TP \fB\-\-overwrite Overwrite recordings if they already exist .TP \fB\-\-partial\-proxy Only uses web proxy where absolutely required (try this extra option if your proxy fails). If specified, value of http_proxy environment variable (if any) in parent process is retained and passed to child processes. .TP \fB\-\-pid Record an arbitrary PID that does not necessarily appear in the index. .TP \fB\-\-pid\-recursive Record all related episodes if value of \-\-pid is a series or brand PID. Requires \-\-pid. .TP \fB\-\-pid\-recursive\-noclips When used with \-\-pid and \-\-pid\-recursive, skip all associated programme clips if the value of \-\-pid is a brand PID. Requires \-\-pid and \-\-pid\-recursive. .TP \fB\-\-proxy, \-p Web proxy URL e.g. 'http://USERNAME:PASSWORD@SERVER:PORT' or 'http://SERVER:PORT'. Sets http_proxy environment variable for child processes (e.g., ffmpeg) unless \-\-partial\-proxy is specified. .TP \fB\-\-radiomode ,,... Radio recording modes (overrides \-\-modes): dashhigh,dashstd,dashmed,dashlow,flashaachigh,flashaacstd,flashaaclow,hafhigh,hafstd,hafmed,haflow,hlsaacstd,hlsaaclow. Shortcuts: worst,worse,good,vgood,better,best,dash,flashaac,haf,hlsaac (default=dashhigh,hafhigh,dashstd,hafstd,hlsaacstd,dashmed,hafmed,dashlow,haflow,hlsaaclow). .TP \fB\-\-raw Don't transcode or change the recording/stream in any way (i.e. RTMP\->FLV, HLS\->MPEG\-TS) .TP \fB\-\-start Recording/streaming start offset (actual start may be several seconds earlier for HLS and DASH streams) .TP \fB\-\-stop Recording/streaming stop offset (actual stop may be several seconds later for HLS and DASH streams) .TP \fB\-\-suboffset Offset the subtitle timestamps by the specified number of milliseconds .TP \fB\-\-subsfmt Subtitles format. One of: default, compact. Default: 'default' .TP \fB\-\-subsraw Additionally save the raw subtitles file .TP \fB\-\-subtitles Download subtitles into srt/SubRip format if available and supported .TP \fB\-\-subtitles\-only Only download the subtitles, not the programme .TP \fB\-\-subtitles\-required Do not download TV programme if subtitles are not available. .TP \fB\-\-tag\-only Only update the programme metadata tag and not download the programme (can also be used with \-\-history) .TP \fB\-\-tag\-only\-filename Add metadata tags to specified file (ignored unless used with \-\-tag\-only) .TP \fB\-\-test, \-t Test only \- no recording (will show programme type) .TP \fB\-\-thumb Download Thumbnail image if available .TP \fB\-\-thumbnail\-only Only Download Thumbnail image if available, not the programme .TP \fB\-\-tvmode ,,... TV recording modes (overrides \-\-modes): flashhd,flashvhigh,flashhigh,flashstd,flashnormal,flashlow,hlshd,hlsvhigh,hlshigh,hlsstd,hlslow,hvfhd,hvfsd,hvfvhigh,hvfhigh,hvfstd,hvflow. Shortcuts: worst,worse,vgood,better,best,flash,hls,hvf (default=hvfhd,hlshd,hvfsd,hvfvhigh,hlsvhigh,hvfhigh,hlshigh,hvfstd,hlsstd,hvflow,hlslow). .TP \fB\-\-url "" Record the embedded media player in the specified URL. Use with \-\-type=. .TP \fB\-\-versions Version of programme to record. List is processed from left to right and first version found is downloaded. Example: '\-\-versions=audiodescribed,default' will prefer audiodescribed programmes if available. .SS "Output Options:" .TP \fB\-\-command, \-c Run user command after successful recording using args such as , etc .TP \fB\-\-file\-prefix The filename prefix (excluding dir and extension) using formatting fields. e.g. '\-\-' .TP \fB\-\-metadata Create metadata info file after recording. Valid types are: xbmc (or kodi), xbmc_movie (or kodi_movie), freevo, generic .TP \fB\-\-output, \-o Recording output directory .TP \fB\-\-outputradio Output directory for radio recordings (overrides \-\-output) .TP \fB\-\-outputtv Output directory for tv recordings (overrides \-\-output) .TP \fB\-\-subdir, \-s Put Recorded files into Programme name subdirectory .TP \fB\-\-subdir\-format The format to be used for the subdirectory naming using formatting fields. e.g. '\-' .TP \fB\-\-thumbsize Default thumbnail size/index to use for the current recording and metadata. index: 1\-11 or width: 86,150,178,512,528,640,832,1024,1280,1600,1920 .TP \fB\-\-thumbsizecache Default thumbnail size/index to use when building cache. index: 1\-11 or width: 86,150,178,512,528,640,832,1024,1280,1600,1920 .TP \fB\-\-whitespace, \-w Keep whitespace in file and directory names. Default behaviour is to replace whitespace with underscores. .SS "PVR Options:" .TP \fB\-\-comment Adds a comment to a PVR search .TP \fB\-\-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 .TP \fB\-\-pvr\-add Save the named PVR search with the specified search terms. Search terms required. Use \-\-search=.* to force download of all available programmes. Synonyms: \-\-pvradd .TP \fB\-\-pvr\-del Remove the named search from the PVR searches. Synonyms: \-\-pvrdel .TP \fB\-\-pvr\-disable Disable (not delete) a named PVR search. Synonyms: \-\-pvrdisable .TP \fB\-\-pvr\-enable Enable a previously disabled named PVR search. Synonyms: \-\-pvrenable .TP \fB\-\-pvr\-exclude Exclude the PVR searches to run by search name (regex or comma separated values). Synonyms: \-\-pvrexclude .TP \fB\-\-pvr\-list Show the PVR search list. Synonyms: \-\-pvrlist .TP \fB\-\-pvr\-queue Add currently matched programmes to queue for later one\-off recording using the \-\-pvr option. Search terms required unless \-\-pid specified. Synonyms: \-\-pvrqueue .TP \fB\-\-pvr\-scheduler Runs the PVR using all saved PVR searches every . Synonyms: \-\-pvrscheduler .TP \fB\-\-pvr\-single Runs a named PVR search. Synonyms: \-\-pvrsingle .SS "Config Options:" .TP \fB\-\-cache\-reset Reset cache to retain only latest update and discard previous contents. .TP \fB\-\-expiry, \-e Cache expiry in seconds (default 4hrs) .TP \fB\-\-limit\-matches Limits the number of matching results for any search (and for every PVR search) .TP \fB\-\-nopurge Don't ask to delete programmes recorded over 30 days ago .TP \fB\-\-prefs\-add Add/Change specified saved user or preset options .TP \fB\-\-prefs\-clear Remove *ALL* saved user or preset options .TP \fB\-\-prefs\-del Remove specified saved user or preset options .TP \fB\-\-prefs\-show Show saved user or preset options .TP \fB\-\-preset, \-z Use specified user options preset .TP \fB\-\-preset\-list Show all valid presets .TP \fB\-\-profile\-dir Override the user profile directory/folder .TP \fB\-\-refresh, \-\-flush, \-f Refresh cache .TP \fB\-\-refresh\-exclude Exclude matched channel(s) when refreshing cache (regex or comma separated values). Overrides \-\-refresh\-include\-groups[\-{tv,radio}] status for specified channel(s) .TP \fB\-\-refresh\-exclude\-groups Exclude channel groups when refreshing radio or tv cache (comma\-separated values). Valid values: 'national', 'regional', 'local' .TP \fB\-\-refresh\-exclude\-groups\-radio Exclude channel groups when refreshing radio cache (comma\-separated values). Valid values: 'national', 'regional', 'local' .TP \fB\-\-refresh\-exclude\-groups\-tv Exclude channel groups when refreshing tv cache (comma\-separated values). Valid values: 'national', 'regional', 'local' .TP \fB\-\-refresh\-future Obtain future programme schedule when refreshing cache .TP \fB\-\-refresh\-include Include matched channel(s) when refreshing cache (regex or comma separated values). Overrides \-\-refresh\-exclude\-groups[\-{tv,radio}] status for specified channel(s) .TP \fB\-\-refresh\-include\-groups Include channel groups when refreshing radio or tv cache (comma\-separated values). Valid values: 'national', 'regional', 'local' .TP \fB\-\-refresh\-include\-groups\-radio Include channel groups when refreshing radio cache (comma\-separated values). Valid values: 'national', 'regional', 'local' .TP \fB\-\-refresh\-include\-groups\-tv Include channel groups when refreshing tv cache (comma\-separated values). Valid values: 'national', 'regional', 'local' .TP \fB\-\-skipdeleted Skip the download of metadata/thumbs/subs if the media file no longer exists. Use with \-\-history & \-\-metadataonly/subsonly/thumbonly. .TP \fB\-\-webrequest Specify all options as a urlencoded string of "name=val&name=val&..." .SS "External Program Options:" .TP \fB\-\-atomicparsley Location of AtomicParsley binary .TP \fB\-\-ffmpeg Location of ffmpeg binary. .TP \fB\-\-ffmpeg\-obsolete Indicates you are using an obsolete version of ffmpeg (<0.7) that does not support the \-loglevel or \-stats options, so \-\-quiet, \-\-verbose and \-\-debug will not be applied to ffmpeg. .SS "Tagging Options:" .TP \fB\-\-no\-artwork Do not embed thumbnail image in output file. Also removes existing artwork. All other metadata values will be written. .TP \fB\-\-no\-tag Do not tag downloaded programmes .TP \fB\-\-tag\-format\-show Format template for programme name in metadata (use substitution parameters). Default: none .TP \fB\-\-tag\-format\-title Format template for episode title in metadata (use substitution parameters). Default: none .TP \fB\-\-tag\-isodate Use ISO8601 dates (YYYY\-MM\-DD) in album/show names and track titles .TP \fB\-\-tag\-podcast Tag downloaded radio and tv programmes as iTunes podcasts (requires MP3::Tag module for AAC/MP3 files) .TP \fB\-\-tag\-podcast\-radio Tag only downloaded radio programmes as iTunes podcasts (requires MP3::Tag module for AAC/MP3 files) .TP \fB\-\-tag\-podcast\-tv Tag only downloaded tv programmes as iTunes podcasts .TP \fB\-\-tag\-utf8 Use UTF\-8 encoding for non\-ASCII characters in AtomicParsley parameter values (Linux/Unix/OS X only). Use only if auto\-detect fails. .SS "Misc Options:" .TP \fB\-\-encoding\-console\-in Character encoding for standard input (currently unused). Encoding name must be known to Perl Encode module. Default (only if auto\-detect fails): Linux/Unix/OSX = UTF\-8, Windows = cp850 .TP \fB\-\-encoding\-console\-out Character encoding used to encode search results and other output. Encoding name must be known to Perl Encode module. Default (only if auto\-detect fails): Linux/Unix/OSX = UTF\-8, Windows = cp850 .TP \fB\-\-encoding\-locale Character encoding used to decode command\-line arguments. Encoding name must be known to Perl Encode module. Default (only if auto\-detect fails): Linux/Unix/OSX = UTF\-8, Windows = cp1252 .TP \fB\-\-encoding\-locale\-fs Character encoding used to encode file and directory names. Encoding name must be known to Perl Encode module. Default (only if auto\-detect fails): Linux/Unix/OSX = UTF\-8, Windows = cp1252 .TP \fB\-\-index\-concurrent Perform fork()\-based concurrent (i.e., faster) indexing when web scraping TV schedules only. Requires \-\-ybbcy and Parallel::ForkManager Perl module. Not supported on Windows. .TP \fB\-\-index\-maxconn Maximum number of forks (connections) to use for concurrent indexing. Requires \-\-index\-concurrent. Default: 4 Max: 10 .TP \fB\-\-no\-scrape\-versions Do not scrape episode web pages as extra measure to find audiodescribed/signed versions. .TP \fB\-\-trim\-history <# days to retain> Remove download history entries older than number of days specified in option value. Cannot specify 0 \- use 'all' to completely delete download history .TP \fB\-\-ybbcy Use alternate programme indexing and metadata retrieval if the BBC removes its XML data sources. TV programme indexing will be extremely slow. Some metadata will be missing or incorrect. .SS "Deprecated Options:" .TP \fB\-\-aactomp3 Transcode AAC audio to MP3 with ffmpeg (CBR appropriate for mode unless \-\-mp3vbr is specified). Applied only to radio programmes. (Synonyms: \-\-mp3) .TP \fB\-\-avi Output video in AVI container instead of MP4. There is no metadata tagging support for AVI output. .TP \fB\-\-category Narrow search to matched categories (regex or comma separated values). Supported only for podcasts (not tv or radio programmes). .TP \fB\-\-check\-duration Print message showing recorded duration, expected duration and difference between them. Ignored when recording live streams. .TP \fB\-\-email
Email HTML index of matching programmes to specified address .TP \fB\-\-email\-password Email password .TP \fB\-\-email\-port Email port number (default: appropriate port for \-\-email\-security) .TP \fB\-\-email\-security Email security TLS, SSL (default: none) .TP \fB\-\-email\-sender
Optional email sender address .TP \fB\-\-email\-smtp SMTP server IP address to use to send email (default: localhost) .TP \fB\-\-email\-user Email username .TP \fB\-\-exclude\-category Narrow search to exclude matched categories (regex or comma separated values). Supported only for podcasts (not tv or radio programmes). .TP \fB\-\-fatfilename Remove FAT forbidden characters in file and directory names. Always applied on Windows. Overrides \-\-punctuation. .TP \fB\-\-ffmpeg\-liveradio\-opts Add custom options to ffmpeg re\-muxing for liveradio .TP \fB\-\-ffmpeg\-livetv\-opts Add custom options to ffmpeg re\-muxing for livetv .TP \fB\-\-ffmpeg\-radio\-opts Add custom options to ffmpeg re\-muxing for radio .TP \fB\-\-ffmpeg\-tv\-opts Add custom options to ffmpeg re\-muxing for tv .TP \fB\-\-fxd Create Freevo FXD XML of matching programmes in specified file .TP \fB\-\-hfsfilename Remove colons in file and directory names. Prevents OS X Finder displaying colon as forward slash. Always applied on OS X. Overrides \-\-punctuation. .TP \fB\-\-hls\-ffmpeg Use ffmpeg instead of built\-in HLS downloader. Ignored for downloading on\-demand radio programmes, which use DASH downloader. 320k on\-demand radio programmes cannot be streamed with \-\-hls\-ffmpeg. .TP \fB\-\-hls\-ffmpeg\-encode Make ffmpeg HLS downloader re\-encode streams. For old versions of ffmpeg (<2.5). May record slower than real time and may not be able to stream higher\-quality media. .TP \fB\-\-hls\-liveradio\-opts Add custom options to ffmpeg HLS download re\-muxing for liveradio .TP \fB\-\-hls\-livetv\-opts Add custom options to ffmpeg HLS download encoding for livetv .TP \fB\-\-hls\-radio\-opts Add custom options to ffmpeg HLS download re\-muxing for radio .TP \fB\-\-hls\-tv\-opts Add custom options to ffmpeg HLS download re\-muxing for tv .TP \fB\-\-html Create basic HTML index of matching programmes in specified file .TP \fB\-\-id3v2 Location of id3v2 or id3tag binary .TP \fB\-\-isodate Use ISO8601 dates (YYYY\-MM\-DD) in filenames and subdirectory paths. Default: true .TP \fB\-\-keep\-all Keep whitespace, all possible punctuation and non\-ASCII characters in file and directory names. Shortcut for: \-\-whitespace \-\-non\-ascii \-\-punctuation. .TP \fB\-\-list Show a list of available categories/channels for the selected type and exit .TP \fB\-\-listplugins Display a list of currently available plugins or programme types .TP \fB\-\-liveradio\-intl Force use of hard\-coded international streams for HLS live radio. Ignored for World Service .TP \fB\-\-liveradio\-uk Force use of hard\-coded UK streams for HLS live radio (overrides \-\-liveradio\-intl). Ignored for World Service .TP \fB\-\-liveradiomode ,,.. Live Radio recording modes (overrides \-\-modes): hafhigh,hafstd,hafmed,haflow,shoutcastmp3std,shoutcastaachigh (R3 only, UK only). Shortcuts: worst,worse,good,vgood,better,best,haf,shoutcast. (default=hafhigh,hafstd,hafmed,haflow) .TP \fB\-\-livetvmode ,,... Live TV recording modes (overrides \-\-modes): hvfhd,hvfsd,hvfvhigh,hvfhigh,hvfstd,hvflow. Shortcuts: worst,worse,good,vgood,better,best,hvf. (default=hvfhd,hvfsd,hvfvhigh,hvfhigh,hvfstd,hvflow) .TP \fB\-\-localfilesdirs [,dir,] Directories/Folders to scan for new files .TP \fB\-\-mediaselector Identifier of mediaselector API to use when searching for media streams. One of: 4,5 Default: 5 .TP \fB\-\-mkv Output video in MKV container instead of MP4. There is no metadata tagging support for MKV output. .TP \fB\-\-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). Applied only to radio programmes. .TP \fB\-\-multimode Allow the recording of more than one mode for the same programme \- WARNING: will record all specified/default modes!! .TP \fB\-\-mythtv Create Mythtv streams XML of matching programmes in specified file .TP \fB\-\-non\-ascii, \-\-na Keep non\-ASCII characters in file and directory names. Default behaviour is to remove all non\-ASCII characters. .TP \fB\-\-nowrite, \-n No writing of file to disk (use with \-x to prevent a copy being stored on disk) .TP \fB\-\-outputliveradio Output directory for live radio recordings (overrides \-\-output) .TP \fB\-\-outputlivetv Output directory for live tv recordings (overrides \-\-output) .TP \fB\-\-outputlocalfiles Output directory for localfiles recordings (overrides \-\-output) .TP \fB\-\-outputpodcast Output directory for podcast recordings (overrides \-\-output) .TP \fB\-\-player ' ' Use specified command to directly play the stream .TP \fB\-\-punctuation, \-\-pu Keep punctuation characters and symbols in file and directory names, with ellipsis always replaced by underscore. Default behaviour is to remove all punctuation and symbols except underscore, hyphen and full stop. Overridden by \-\-fatfilename and \-\-hfsfilename. .TP \fB\-\-refresh\-abortonerror Abort cache refresh for programme type if data for any channel fails to download. Use \-\-refresh\-exclude to temporarily skip failing channels. .TP \fB\-\-refresh\-limit Minimum number of days of programmes to cache (max: 30) .TP \fB\-\-refresh\-limit\-radio Number of days of radio programmes to cache. Makes cache updates VERY slow. Default: 7 Min: 1 Max: 30 .TP \fB\-\-refresh\-limit\-tv Number of days of TV programmes to cache. Makes cache updates VERY slow. Default: 7 Min: 1 Max: 30 .TP \fB\-\-rtmp\-radio\-opts Add custom options to rtmpdump for radio .TP \fB\-\-rtmp\-tv\-opts Add custom options to rtmpdump for tv .TP \fB\-\-rtmpdump Location of rtmpdump binary. Synonyms: \-\-flvstreamer .TP \fB\-\-rtmpport Override the RTMP port (e.g. 443) .TP \fB\-\-series Display programme series names only with number of episodes .TP \fB\-\-shoutcast\-liveradio\-opts Add custom options to ffmpeg Shoutcast download re\-muxing for liveradio .TP \fB\-\-stdout, \-x Additionally stream to STDOUT (so you can pipe output to a player) .TP \fB\-\-stream Stream to STDOUT (so you can pipe output to a player) .TP \fB\-\-swfurl URL of Flash player used by rtmpdump for verification. Only use if default Flash player URL is not working. .TP \fB\-\-symlink Create symlink to once we have the header of the recording .TP \fB\-\-tag\-cnid Use AtomicParsley \-\-cnID argument (if supported) to add catalog ID used for combining HD and SD versions in iTunes .TP \fB\-\-tag\-fulltitle Prepend album/show title to track title .TP \fB\-\-tag\-hdvideo AtomicParsley accepts \-\-hdvideo argument for HD video flag .TP \fB\-\-tag\-id3sync Save ID3 tags for MP3 files in synchronised form. Provides workaround for corruption of thumbnail images in Windows. Has no effect unless using MP3::Tag Perl module. .TP \fB\-\-tag\-longdesc AtomicParsley accepts \-\-longdesc argument for long description text .TP \fB\-\-tag\-longdescription AtomicParsley accepts \-\-longDescription argument for long description text .TP \fB\-\-tag\-longepisode Use (incl. episode number) instead of for track title .TP \fB\-\-tag\-longtitle Prepend (if available) to track title. Ignored with \-\-tag\-fulltitle. .TP \fB\-\-tag\-shortname Use instead of for album/show title .TP \fB\-\-terse Only show terse programme info (does not affect searching) .TP \fB\-\-thumb\-ext Thumbnail filename extension to use .TP \fB\-\-tree Display Programme listings in a tree view .TP \fB\-\-xml\-alpha Create freevo/Mythtv menu sorted alphabetically by programme name .TP \fB\-\-xml\-channels Create freevo/Mythtv menu of channels \-> programme names \-> episodes .TP \fB\-\-xml\-names Create freevo/Mythtv menu of programme names \-> episodes .SH AUTHOR get_iplayer was written by Phil Lewis and is now maintained by the contributors at http://www.infradead.org/get_iplayer/html/get_iplayer.html .PP This manual page was originally written by Jonathan Wiltshire for the Debian project (but may be used by others). .SH COPYRIGHT NOTICE get_iplayer v2.97, 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.