Table of Contents

Command Usage

* The full web based man page can be viewed here.
* For basic help run:

get_iplayer -h

* For Advanced and extended options run:

get_iplayer --long-help

Examples

Searching

Click Here for All Search Options

* List all tv programmes (either from BBC site or cached):

get_iplayer

* List all tv programme names matching “News”:

get_iplayer news

* List all Radio programme names matching “News”:

get_iplayer --type=radio news

* List all Live TV and Radio channels/programmes:

get_iplayer --type=livetv,liveradio

* List all tv programmes with long descriptions:

get_iplayer --long

* List all tv programmes showing only ‘pid’, ‘name’ and ‘episode’

get_iplayer --listformat="<pid>: <name> - <episode>"

* Search all tv programmes for the word ‘hello’ in the ‘episode’ and ‘channel’ fields

get_iplayer --fields=episode,channel hello

* List all tv programmes with categories containing the word ‘News’ and on channel ‘BBC One’

get_iplayer --channel="BBC One" --category=News

* List all tv programmes added to the cache since 24 hours ago:

get_iplayer --since=24

* List all available categories for BBC Radio and BBC TV programmes:

get_iplayer --list=categories --type=tv,radio

* List all available radio channels:

get_iplayer --list=channel --type=radio

* List all BBC TV programmes and BBC podcasts

get_iplayer --type=podcast,tv

* List all programmes with categories not containing the string ‘child’ on BBC One:

get_iplayer --exclude-category=child --channel="bbc one"

* List all programme metadata and available streaming modes for programme with index number 123:

get_iplayer --info 123

Recording

Click Here for All Recording Options

Essentially, you can just add ‘–get’ to any of the above searches to record the matching programmes.
* Record programme number 123 (see index list):

get_iplayer --get 123

* Record Radio programme number 10123 (see index list):

get_iplayer --get 10123

* Record programme number 123 and save in ‘/home/user/tv-files/':

get_iplayer --get 123 --output "/home/user/tv-files/"

* Record Radio programme number 10123 and tv programme number 324 (see index list):

get_iplayer --get 10123 324

* Record Podcasts matching ‘Moyles':

get_iplayer --type=podcast --get "Moyles"

* Record all tv programmes with ‘blue peter’ in the title/episode:

get_iplayer --get "blue peter"

* Record all tv programmes with ‘blue peter’ in the title/episode, and programme index 123:

get_iplayer --get "blue peter" 123

* Record all programmes with URL that contains a programme ID (pid) b002a23a (i.e. the URL of the programme page on BBC iplayer):

get_iplayer "http://blah.blah.blah/b002a23a.shtml"
get_iplayer --pid b002a23a

* Record a video from the BBC embedded media player such as Learning Zone, BBC Archive or the BBC News site (i.e. the URL of the page that contains the player):

get_iplayer "tv:http://news.bbc.co.uk/1/hi/uk_politics/8104086.stm"
get_iplayer --type=tv "http://news.bbc.co.uk/1/hi/uk_politics/8104086.stm"

* Record all programmes with ‘comedy’ in the title, episode or long description:

get_iplayer --long --get comedy

* Record all programmes with categories containing ‘music':

get_iplayer --get --category=music

* Using flvstreamer tool to get high or normal quality Flash version of a TV programme (–flvstreamer is not required of your options tell get_iplayer where flvstreamer is located)

get_iplayer --type=tv --get 123 --modes=flashstd
  --flvstreamer="/path/to/flvstreamer"

* Record a TV programme trying iphone, flashhigh and flashnormal modes in order until one succeeds. (use the –info option to see what modes are available for a programme).

get_iplayer --type=tv --get 123 --modes=iphone,flashhigh,flashstd
 --flvstreamer="/path/to/flvstreamer"

* Using flvstreamer tool to get high quality Flash version of a BBC Radio programme (–flvstreamer is not required of your options tell get_iplayer where flvstreamer is located). Note: Possible modes are (in order of quality): n95_3g, n95_wifi, flashlow, flashnormal, iphone, flashhigh, flashvhigh, flashhd. See this page for more details.

get_iplayer --type=radio --get 12345 --modes=flashaudio
 --flvstreamer="/path/to/flvstreamer"

* Record a radio programme trying iphone, flashaudio, flashaac then realaudio modes in order until one succeeds.

get_iplayer --type=radio --get 12345
 --modes=iphone,flashaudio,flashaac,realaudio
 --flvstreamer="/path/to/flvstreamer"

Live Recording

Click Here for All Search Options

Note: Please upgrade to flvstreamer 1.8 or later for reliable Live streaming.
* List LiveTV:

get_iplayer --type=livetv

* Record a Live BBC iPlayer TV programme (e.g. BBC2):

get_iplayer --type=livetv --get "BBC Two"
get_iplayer --type=tv "http://www.bbc.co.uk/iplayer/playlive/bbc_two"
get_iplayer --type=tv --pid="bbc_two"

* Record a High Quality Live BBC iPlayer Radio programme (e.g. BBC Radio 1):

get_iplayer --type=liveradio --get "Radio 1"
get_iplayer --type=radio "http://www.bbc.co.uk/iplayer/playlive/bbc_radio_one"
get_iplayer --type=radio --pid=bbc_radio_one

Searching the Future Programme Schedule

Click Here for All Search Options

It is possible to index, search and queue recordings for specific programmes that have not yet been made available. This is currently only available on BBC TV and Radio modes and only searches for up to 13 days in advance. Note that some of the programmes in the BBC schedules are never released on iPlayer and therefore will never get recorded even if you can find them in the search results. Note that the refreshing can take quite a bit longer with –refresh-future specified.
* Refresh the cache with future schedules (e.g. for tv). You must do this otherwise you will not be able to search for future programmes:

get_iplayer --type=tv --refresh-future --refresh

* Save the refreshing of future programmes into your default settings (a good idea if you want the above to be automatic):

get_iplayer --add-prefs --refresh-future

* To search for a programme additionally in the future just use any of the usual search commands but adding ‘–future':

get_iplayer 'Eastenders' --future

* You cannot record a programme in the future (!) but you can queue it in the PVR for recording when it becomes available (if at all). In this example the Index of the search results for a future episode of eastenders was ‘123’:

get_iplayer --pvrqueue --type=tv 123

Searching the Recording History

Click Here for All Search Options

The recording history is a text database of the programmes you have recording since you started using get_iplayer. It’s primary purpose is to prevent get_iplayer from downloading the same programme more than once. You can search the recordings history much like the normal programme types.
* Search for “Doctor Who” in the history

get_iplayer --history "Doctor Who"

* Show detailed programme metadata for all recorded programmes matching “Doctor Who” in the history

get_iplayer --history "Doctor Who" --info

* Download thumbnails for all recorded programmes matching “Doctor Who” in the history

get_iplayer --history "Doctor Who" --thumbnailonly

* Download thumbnails for all recorded programmes matching “Doctor Who” in the history and where the media file hasn’t been deleted.

get_iplayer --history "Doctor Who" --thumbnailonly --skipdeleted

Indexing and Caching Features

Click Here for All Config Options

* Refresh the tv programme cache (this happens after 4hrs automatically – see –expiry option):

get_iplayer --refresh

* Manually refresh the programme cache for all types:

get_iplayer --refresh --type=all

* Manually refresh the radio programme cache:

get_iplayer --refresh --type=radio

* Set the expiry of the caches (in seconds):

get_iplayer --add-prefs --expiry=3600

* Exclude adding matching channels to the programme cache (i.e. these channels won’t even be indexed and therefore indexing/refreshing will be faster):

get_iplayer --refresh-exclude="cbeebies,cbbc" --type=tv --refresh

* Check for Updates and Download new version of get_iplayer (also creates backup):
* Include these channels ONLY to the programme cache (i.e. these channels will only be indexed and therefore indexing/refreshing will be faster):

get_iplayer --refresh-include="bbc" --type=tv --refresh

Updating get_iplayer

Click Here for All Config Options

Updating on Linux, OS X, Unix, cygwin, etc
* If you installed by simply downloading the get_iplayer script then you can just run:

get_iplayer --update

* Optionally force updating the script and the plugins:

get_iplayer --update --plugins-update --force
get_iplayer --update

* If you installed using a package manager then please see the Install page for further details:
Updating on Windows (Installer method)
* Download the latest Installer and re-run it. You can then uninstall the get_iplayer component and then re-install that component. The same goes for each of the other components if you so wish.

Streaming

Click Here for All Output Options

* Stream a programme in mplayer, or xine while recording it to disk (does not yet work in win32, does not work for flash based streams. Works for iphone, flash, podcast and realaudio modes):

get_iplayer --stdout --get 123 | mplayer -cache 3072 -
get_iplayer --stdout --get 123 | xine stdin:/

* Stream a programme in mplayer/xine/vlc/ffplay while not recording it to disk:

get_iplayer --stream 123 --player="mplayer -cache 3072 -"
get_iplayer --stream 123 --player="vlc -"
get_iplayer --stream 123 --player="ffplay -"
get_iplayer --stream 123 | mplayer -cache 3072 -

Live Streaming

Click Here for All Output Options

Note: Please upgrade to flvstreamer 1.8 or later for reliable Live streaming.
* Stream a Live BBC iPlayer TV programme to mplayer while not recording it to disk (e.g. BBC 2):

get_iplayer --stream --type=livetv "BBC Two" --player="mplayer -cache 512 -"
get_iplayer --stream --type=tv "http://www.bbc.co.uk/iplayer/playlive/bbc_two"
  --player="mplayer -cache 512 -"
get_iplayer --stream --type=tv "http://www.bbc.co.uk/iplayer/playlive/bbc_two"
  | mplayer -cache 512 -
get_iplayer --stream --type=tv --pid="bbc_two" | mplayer -cache 512 -

* Stream a High Quality Live BBC iPlayer Radio programme to mplayer while not recording it to disk (e.g. BBC Radio 1):

get_iplayer --stream --type=liveradio "Radio 1" --player="mplayer -cache 64 -"
get_iplayer --stream --type=radio
  "http://www.bbc.co.uk/iplayer/playlive/bbc_radio_one" | mplayer -cache 64 -
get_iplayer --stream --pid='bbc_radio_one' | mplayer -cache 64 -

Using a Web Proxy

Click Here for All Recording Options

* If you are behind a web proxy you can use the following to specify it:

get_iplayer --proxy=http://[username:password@]<server>:<port>

* All modes other than iphone or http will not work through a web proxy. To make only the meta-data web requests go through the proxy add the –partial-proxy option. This will only work if your network allows direct access to the streaming port (e.g. port 1935).

Saving Settings

Click Here for All Config Options

Default user settings can be added, removed or changed as follows:
* Save or update proxy settings and verbose mode as user defaults (in ~/.get_iplayer/options or ‘%USERPROFILE%\.get_iplayer\options’ in ActivePerl/Windows):

get_iplayer --prefs-add --verbose --proxy=http://proxy.domain.com:3128

* Additionally save programme type settings (this will only update the specified options – existing options will be retained):

get_iplayer --prefs-add --type=radio,tv

* Remove a specific option from those saved (e.g. –proxy):

get_iplayer --prefs-del --proxy=http://proxy.domain.com:3128

* Show *all* saved default options:

get_iplayer --prefs-show

* Completely clear *all* saved default options:

get_iplayer --prefs-clear

* Options can also be saved in ‘/etc/get_iplayer/options’ on *nix/MaxOSX/cygwin platforms and %ALLUSERSPROFILE%\get_iplayer\options in Windows. The format is as follows:

<option key> <option value>

Option Presets and Shortcuts

Click Here for All Config Options

User defined groups of options can be added, removed or changed. They are referred to by the ‘preset name’ as follows:
* Save or update several options (–hide and –since) in the preset named ‘my_preset’ (in ~/.get_iplayer/presets/my_preset or ‘%USERPROFILE%\.get_iplayer\presets\my_preset’ in ActivePerl/Windows):

get_iplayer --preset=my_preset --prefs-add --hide --since=24

* Additionally save programme type for preset named ‘my_preset’ (this will only update the specified preset options – existing preset options will be retained):

get_iplayer --preset=my_preset --prefs-add --type=radio,tv

* Remove a specific option from those saved in the preset named ‘my_preset’ (e.g. –since=24):

get_iplayer --preset=my_preset --prefs-del --since=24

* Show *all* saved options in preset named ‘my_preset':

get_iplayer --preset=my_preset --prefs-show

* Completely clear *all* saved options in preset named ‘my_preset':

get_iplayer --preset=my_preset --prefs-clear

* Use the preset named ‘my_preset’ to search for items containing the name ‘News':

get_iplayer --preset=my_preset News
get_iplayer -z my_preset News

* Here is a more useful example. I would like to have a preset that shows me the BBC iPlayer TV programmes added to my cache in the last 24hrs, hide ones I’ve already downloaded, exclude some channels and exclude childrens’ and wales programme categories. So to add the preset I type:

get_iplayer --prefs-add --preset=last24 --type=tv --since=24
  --hide --versionlist=default --exclude-category=child,wales
  --exclude-channel=alba,cbbc,cbeebies,parliament

* Now, to run the preset at any time I simply type:

get_iplayer --preset=last24
or
get_iplayer -z last24

Subtitles

Click Here for All Recording Options

* Record programme number 123 with subtitles (if available) and optionally insert a
subtitle delay of 5 seconds:

get_iplayer --subtitles --suboffset 5000 --get 123

* (Re)download subtitles only (if available):

get_iplayer --subsonly --get 123

More Programme Information

Click Here for All Display Options

Programme Detailed Stream Information
* Display the Various stream URLs for programme index 123:

./get_iplayer --streaminfo 123

Full Program Information Display
* Display the programme metadata for index 123:

./get_iplayer --info 123

Metadata Files
* The programme metadata can be additionally downloaded using the –metadata=[TYPE] option. Where [TYPE] is one of xbmc, xbmc_movie, freevo, generic.
* Save all the metadata after a successful download into an xml file:

./get_iplayer --metadata=generic --get 123

* Save all the metadata ONLY for a specific search into an xml file (and don’t record the programme). This is useful if you forgot to get the metadata when recording.

./get_iplayer --metadata-only --metadata=generic 123

Thumbnails
* A programme thumbnail can be automatically downloaded using the –thumbnail option.

./get_iplayer --thumbnail --get 123

* Save all the thumbnail(s) ONLY for a specific search (and don’t record the programme). This is useful if you forgot to get the thumbnail when recording.

./get_iplayer --thumbnail-only 123

Update Your Entire Recording Collection with Thumbnails, Metadata and Subtitles
As long as your programmes remain in the directory they were originally recorded into you can retrospecitvely download the thumbnail, metadata or subtitles of the shows in your recordings history.
* Get all thumbnails for files that still exist (in this case for programmes matching ‘Doctor Who’):

./get_iplayer --thumbnail-only --history --skipdeleted "Doctor Who"

* Get all the metadata files (in generic format) for files that still exist:

./get_iplayer --metadata-only --metadata=generic --history --skipdeleted

* Get all subtitles for files that still exist (Note that you can only get subs if the programme is still available on iPlayer):

./get_iplayer --subs-only --history --skipdeleted

Filenames and Directories

Click Here for All Output Options

FIlenames
* Use a user defined filename-prefix format using substitution parameters:

--file-prefix="<name>-<episode>-<longname>-<version>-<pid>"

* Use a filename format using substitution parameters suited to XBMC, Boxee and MythTV:

--file-prefix="<nameshort>-<episodeshort>-<senum>-<pid>"

Valid Characters
Several options exist for controlling what characters are allowed in filenames.
* Allow use of spaces in filenames (by default these are converted to ‘_’).

--whitespace

* Use only filenames valid for DOS/Windows FAT filesystem.

--fatfilename

Recording to Specific Directories
* Use a specific directory for all programmes recorded:

--output="/home/user/recordings/"

* Override the above for all radio (or tv) programmes recorded:

--outputradio="/home/user/recordings-radio/"
--outputtv="/home/user/recordings-tv/"

Subdirectories
* Use a subdirectory for each programme name:

--subdir

* Use a user-defined subdirectory format using substitution parameters:

--subdir-format="<nameshort>-<seriesnum>"

Custom Commands

Click Here for All Output Options

* Run a custom user command after a successful recording using substitution parameters:

get_iplayer --get 123 --command 'echo "<index> <filename> <name>
 <episode> <desc> <available> <longname> <duration>
 <versions> <version> <thumbnail> <channel> <categories>
 <type> <pid>"'

* Using the command option to background transcode your recorded video to mp4 format:

get_iplayer --get 123 --command "mencoder -ovc lavc -lavcopts
 vcodec=mpeg4 -oac lavc -lavcopts abitrate=128
 -o <filename>.mp4 <filename> -quiet &"

PVR Usage

Click Here for All PVR Options

The PVR functionality allows you to record any number of iPlayer programmes
using any combination of search terms that you would normally run on the
command line. The PVR searches are saved in ~/.get_iplayer/pvr/.
You can Add, Delete and List the PVR searches. This feature allows you to
run multiple batch recordings from a scheduler such as Unix crond (and possibly
the Windows scheduler). A tutorial is on how to setup and use the PVR is here.

* Add a new PVR search for a specific programme (i.e. ‘series link’):

get_iplayer --pvr-add=Top_Gear --type=tv "Top Gear"

* Add a new PVR search (using more search options):

get_iplayer --pvr-add=bbc1_comedy_tv_progs --category=comedy --type=tv
 --output=/path/to/my/pvr/recordings/ --channel="BBC One"

* Add a new One-Off recording PVR search. This will effectively queue the programmes for recording and delete the PVR search after completion:

get_iplayer --pvr-queue --type tv 123 231 32 "Blue Peter"

* Add a new One-Off recording PVR search for a specific PID:

get_iplayer --pvr-queue --pid=tv:b01a2b3c

* List the PVR searches already added:

get_iplayer --pvr-list

* Remove a PVR search:

get_iplayer --pvr-del=Top_Gear

* Disable a PVR search:

get_iplayer --pvr-disable=Top_Gear

* Re-enable a PVR search:

get_iplayer --pvr-enable=Top_Gear

* Run the PVR (this really should be added to your scheduler such as cron):

get_iplayer --pvr

Scheduling the PVR

Click Here for All PVR Options

Linux / Unix / MacOSX

* Add this line to add to user’s crontab (use ‘crontab -e’ to edit) – this will run all of the PVR jobs every hour:

0 * * * * /path/to/get_iplayer --pvr 2>>/tmp/get_iplayer.log

* Optionally, to notify by email when programme(s) have been recorded, add this to the top of your crontab (this will catch the stdout from the cron job and send to the specified email address):

MAILTO=me@mydomain.com

* Or, run the PVR Scheduler from the command line. This will fire off the PVR every hour as long as the command is running:

get_iplayer --pvrscheduler 3600

Windows7, Windows XP and Vista

* On the latest installer there will be an entry in the Start menu to ‘Run PVR Scheduler Now’. This will start a command window which will fire off the PVR every 4 hours.
* Alternatively if you wish to use the Windows Scheduler see this guide for full instructions.

Substitution Parameters

* The following substitutions may be available to certain options such as –command and –fileprefix. To see a list of all available parameters for a specific programme use the –info option.

<index>         => index number
<name>          => programme short name
<seriesnum>     => Series number
<nameshort>     => programme name with series number stripped.
<episode>       => Episode info
<episodenum>    => Episode number
<episodeshort>  => programme episode with episode number stripped.
<senum>         => Series and Episode numbers in the s##e## format.
<desc>          => Long Description
<descshort>     => Short Description
<descmedium>    => Medium Description
<versions>      => comma separated list of versions
<version>       => selected version e.g 'signed'
<thumbnail>     => programme thumbnail url
<web>           => programme url
<channel>       => Programme channel
<categories>    => Categories
<type>          => Type: tv, podcast, or radio
<mode>          => Mode used to obtain programme
<filename>      => Filename of recorded file
<filepart>      => Filename of partially recorded file
<dir>           => Directory of file
<fileprefix>    => Filename Prefix of file
<symlink>       => Filename of any symlink file if specified
<ext>           => Filename Extension of file
<duration>      => duration in HH:MM:SS or seconds
<available>     => Date/Time made available or remaining
<dldate>        => Date when the file was obtained in YYYY-MM-DD format
<dltime>        => Time when the file was obtained in HH:MM:SS format
<timeadded>     => time when programme was added to cache (epoch format)
<expiry>        => time when programme will expire from web
<expiryrel>     => relative time when programme will expire from web
<firstbcast>    => time when programme was first broadcast
<firstbcastrel> => relative time when programme was first broadcast
<lastbcast>     => time when programme was last broadcast
<lastbcastrel>  => relative time when programme was last broadcast

External Programs:

Click Here for All External Program Options

* Several external programs can be used by get_iplayer. The required programs for each mode and type are listed here. The following options are used to specify the exact path so that get_iplayer knows where they are. If they are already in the PATH then there is no need to specify them:

--mplayer
--flvstreamer
--atomicparsley
--vlc
--id3v2
--lame
--ffmpeg

* e.g. to save the ffmpeg location to your default settings in Windows (you don’t need to do this if you use the get_iplayer installer):

get_iplayer --add-prefs --ffmpeg="C:\Program Files\get_iplayer\ffmpeg\bin\ffmpeg.exe"

* e.g. to save the ffmpeg location to your default settings in Linux/OS X (you don’t need to do this if the ffmpeg directory is in your $PATH):

get_iplayer --add-prefs --ffmpeg="/usr/bin/ffmpeg"

Notes:

* The first time you run the script it will access the BBC website XML feeds and
create an index of all programmes currently available.

* Sometimes you will not be able to record a programme listed due to BBC
not encoding it yet for H.264 iPhone format (usually happens within 24hrs of airing).

* Also BBC don’t seem to create an iPhone H.264 version for some programmes at all. If this is the case look into using the rtmp recording modes.

* Windows/ActiveState Perl does not support fifos/named pipes and therefore
any RealAudio radio recording will only be transcoded to mp3 after recording.
Also none of the –stdout options will work with RealAudio radio.

Todo

* These still need documenting:
–multimode
–email
–series
–tree
–terse
–thumbsize[cache]
–hide
–force
–overwrite

722 Comments

  • On January 15th, 2010, John Dinton said:

    Is it possible to download archived radio programmes? The url is
    http://www.bbc.co.uk/iplayer/console/b00k4bgq
    but if I search on b00k4bgq or
    –fields=pid b00k4bgq –type radio
    it says 0 Matching Programmes

    • On January 15th, 2010, John Dinton said:

      Sorry, I should have read the documentation above. If I use –url it works, although it has the same effect as –pid in that it records immediately.

    • On January 15th, 2010, flat said:

      I’ve been googling for an answer and I can’t seem to find one… :(

      I would like to record my very first TV programme from get_iplayer (get_iplayer –get 7) and it tells me:

      “No specified modes (iphone,flashhigh,flashstd,flashnormal) available for this programme with version ‘default’ (try using –modes=)
      ERROR: Failed to record ‘A History of Scotland: Series 2 – God’s Chosen People (b00nxkls)’ ”

      I tried typing something like:
      get_iplayer –get 7 –modes=iphone,flashhigh,flashnormal

      get_iplayer –type=tv –get 7 –modes=iphone,flashhigh,flashnormal

      And nothing works.. :((((
      The help file should be more practical. I’ve only started using get_iplayer so I have no idea what I’m doing wrong. Please help. Thank you.

      • On January 15th, 2010, flat said:

        Oh, BTW, I’m not using any proxy server, if that should matter.

        • On January 15th, 2010, linuxcentre said:

          You need to have a UK IP address.

          • On January 15th, 2010, linuxcentre said:

            Some radio and podcasts will work though.

        • On January 15th, 2010, flat said:

          Oh, rats! Well, thanks anyway. :)

          • On January 16th, 2010, John Dinton said:

            What are the rules on search strings? Sometimes to single out one episode I have tried to use a string further into the name, but a string 25 or more characters into the name does not seem to be found. For instance, tram will not find the latest Goon Show on BBC7, viruses will not find the latest Horizon, and gables will not find the latest Sherlock Holmes.

            • On January 16th, 2010, linuxcentre said:

              Please help me here – give us the command you are using and the prog you are trying to match.

              • On January 17th, 2010, John Dinton said:

                get_iplayer.cmd horizon –type tv
                finds 3 Matching Programmes (it was 4 when I first did it).
                295 is Horizon – 2009-2010: Why do Viruses Kill?
                get_iplayer.cmd viruses –type tv
                finds 0 Matching Programmes

                get_iplayer.cmd goon –type radio
                finds 1 Matching Programme
                12606: The Goon Show – The Last Tram from Clapham,
                get_iplayer.cmd tram –type radio
                finds 0 Matching Programmes

                get_iplayer.cmd sherlock –type radio
                finds 5 Matching Programmes including
                12225: Sherlock Holmes with Carleton Hobbs – The Three Gables,
                get_iplayer.cmd gables –type radio
                finds 0 Matching Programmes

                • On January 17th, 2010, linuxcentre said:

                  You are only matching the programme name – not the episode by default. The programme name, by default is delimited by the ‘ – ‘ characters. The listing format can be overridden with the –listformat option (see docs). If you wish to search in different fields try something like:

                  get_iplayer –fields=name,episode,desc
                  “search terms”

                  The Search terms can also be a regex like:

                  “^Sherlock.*Gables”

                  Google ‘Perl regex’ for help on that.

                  • On January 17th, 2010, John Dinton said:

                    Thanks for explaining that. To try to understand how to use Regex for a search would be overkill for what I wanted to do. Now I know what delimits the programme name I can use -l or –long to avoid having to worry whether my search string is in the programme or episode name. (It’s shorter than –fields episode.) The only reason I was searching for individual episodes of the radio programmes was that for both of them they had apparently downloaded successfully and then been saved with a file size of 0. In the end I grabbed them manually using the index.

              • On January 16th, 2010, BikerDon said:

                As per your last Sherlock Holmes example, possibly because ‘gables’ is in the episode name and not the program name…

                C:\Program Files\get_iplayer>get_iplayer –type=radio gables
                [snip]
                INFO: 0 Matching Programmes

                but

                C:\Program Files\get_iplayer>get_iplayer –type=radio –fields=episode gables
                [snip]
                Matches:
                10580: Crime Catch Up – Sherlock Holmes with Carleton Hobbs: The Three Gables,
                BBC 7, Crime,Drama,Radio
                12219: Sherlock Holmes with Carleton Hobbs – The Three Gables, BBC 7, Crime,Drama,Radio

                INFO: 2 Matching Programmes

                This works in the PVR GUI too.

                • On January 17th, 2010, John Dinton said:

                  What counts as the episode name? Is it everything after the first -? The Sherlock Holmes one is a good example because the programme has two different names, although the Crime Catch Up one is not found by searching on sherlock, so the first – may well be the limit of an unqualified search.

                • On January 17th, 2010, BikerDon said:

                  same works for the other two examples you gave too

                  • On January 17th, 2010, John Dinton said:

                    Searching on 2009 (as in Horizon – 2009-2010:) gives 0 Matching Programmes, so the rule seems to be that up to the first – is the programme name, and from the first – to the first , is the episode name. For pvr use the pid is probably the safest option.

                    I have found that if a search has only one result –pvrqueue or –pvr-queue substitutes the pid for the search string.

                    • On January 17th, 2010, linuxcentre said:

                      –pvr-queue always uses the pid in place of any matches because the results could change between when you queue up the matching results and when the PVR runs next. It’s the case for any number of matches – not just if there is only one.

                • On January 16th, 2010, BikerDon said:

                  When I recently installed Get_iPlayer I already had the wonderful VLC installed so deselected it from the Get_iPlayer installer.

                  I now try to point Get_iPlayer at it and fail miserably, I can’t see why for the life of me…

                  C:\Program Files\get_iplayer>get_iplayer –vlc “C:\Program Files\VideoLAN\VLC\vlc.exe”
                  [snip]

                  INFO: 0 Matching Programmes

                  C:\Program Files\get_iplayer>

                  • On January 17th, 2010, BikerDon said:

                    I thought at first it was the space in ‘Program Files’ but then tried adding the quotes, that failed too.

                    • On January 17th, 2010, linuxcentre said:

                      Do you really need get_iplayer to know where vlc is? It’s only ever used for the n95 v.low quality streams. The readon it’s bundled with get_iplayer installer is because of it’s use with Mozilla Firefox when using the Web PVR Manager. It needs to be associates with m3u playlists in the browser when prompted.

                      • On January 17th, 2010, BikerDon said:

                        Probably not but that avoids the challenge of finding out why it doesn’t work =o)

                  • On January 17th, 2010, John Dinton said:

                    There is no search string in your command. What happens if you type
                    get_iplayer –prefs-add –vlc
                    followed by the path?

                    • On January 17th, 2010, John Dinton said:

                      Another possibility I thought of was to update the file containing the locations of external programs manually, but I don’t know where it is. I was assuming it would be in the options file, but that only has the user-added options as shown by –prefs-show.

                      • On January 17th, 2010, linuxcentre said:

                        See above – it’s probably completely unnecessary to add vlc into the options.

                      • On January 17th, 2010, BikerDon said:

                        OK then here we go…

                        C:\Program Files\get_iplayer>get_iplayer –prefs-add –vlc “C:\Program Files\Vid
                        eoLAN\VLC\vlc.exe”
                        INFO: Added option ‘vlc’ = ‘ôC:\Program’
                        INFO: Changed option ‘search’ from ‘(Recordings’)’ to ‘(Files\VideoLAN\VLC\vlc.e
                        xeö)’
                        INFO: Options file C:\Users\BikerDon/.get_iplayer/options updated

                        C:\Program Files\get_iplayer>

                        Looks like that even with the quotes the space has delimited the vlc option parameter.

                        Is this an “oh sh*t!” moment ?

                        • On January 17th, 2010, linuxcentre said:

                          I don’t really care. It’s a windows-only bug – it’s vlc and it’s of little or no use.

                          • On January 17th, 2010, BikerDon said:

                            Touchy.

                            By the “oh sh*t!” moment I actually meant what has this done then…

                            INFO: Changed option ’search’ from ‘(Recordings’)’ to ‘(Files\VideoLAN\VLC\vlc.e
                            xeö)’

                            but it’s OK now I hope, I’ve found the options file and hopefully put it back to what it was before.

                            • On January 17th, 2010, linuxcentre said:

                              Or just delete that line with vlc on it :-)

                              • On January 17th, 2010, BikerDon said:

                                You really need to read what people post instead of jumping down their throat.

                                It changed another line as follows:

                                INFO: Changed option ’search’ from ‘(Recordings’)’ to ‘(Files\VideoLAN\VLC\vlc.exeö)’

                                Hence my initial worried comment

                            • On January 18th, 2010, linuxcentre said:

                              Hi, You are right – apologies. For some reason your adding of the option got misinterpreted by get_iplayer – did you copy and paste those double quotes or just type them in?

                              • On January 18th, 2010, BikerDon said:

                                No worries.

                                I typed the double-quotes in the command in attempt to span the space character as I know Unix/Linux treats a space as an ‘end of parameter’.

                                The usual way is to use quotes of some kind isn’t it? Perhaps I should have used single quotes. Double quotes normally makes it a string, thinking about it a string is not what’s required. Does get_iplayer treat them differently?

                              • On January 18th, 2010, Sinclair ZX81 said:

                                BTW, you can get past the blank in “C:\Program Files\…” with MS’s old fat32 hack “C:\PROGRA~1\…”

                                works in Vista,
                                -zx

                        • On January 18th, 2010, linuxcentre said:

                          I managed to reproduce the problem. I think you didn’t *TYPE* the command I suggested above. I suspect you copy and pasted it. This blog always mangles double quotes. Try typing it and see if you get the same error. Don’t even try copying and pasting from work or notepad. Type directly and use double quotes as you originally did.

                          • On January 19th, 2010, BikerDon said:

                            Aha! – the light has been switched on…

                            *TYPING* the command in worked a treat

                            C:\Program Files\get_iplayer>get_iplayer –prefs-add –vlc “C:\Program Files\VideoLAN\vlc.exe”
                            INFO: Added option ‘vlc’ = ‘C:\Program Files\VideoLAN\vlc.exe’
                            INFO: Options file C:\Users\BikerDon/.get_iplayer/options updated

                            C:\Program Files\get_iplayer>
                            C:\Program Files\get_iplayer>get_iplayer –prefs-show
                            Options in ‘C:\Users\BikerDon/.get_iplayer/options’
                            search = (Recordings’)
                            vlc = C:\Program Files\VideoLAN\vlc.exe
                            versionlist = default
                            output = I:\iPlayer-Recordings

                            Well done Sherlock =o)

                      • On January 17th, 2010, John Dinton said:

                        Would it be possible to show the version number of the latest version at the head of this page? I see there have been quite a few new versions since I last updated.

                        • On January 17th, 2010, linuxcentre said:

                          Or just run ‘get_iplayer -u’ – this check the version before updating.

                        • On January 17th, 2010, John Dinton said:

                          I have –raw as a user preference because for watching video I would rather use flvplayer than Quicktime. One radio programme has downloaded as flv and I want to convert it to mp3. Is there an easy way I can invoke the transcoding that would have occurred if I had not used –raw, or have I got to work out what the parameters and options of ffmpeg are?

                          • On January 17th, 2010, linuxcentre said:

                            Try ffmpeg -i infile.flv -vn -acodec copy outfile.mp3

                          • On January 18th, 2010, Richard said:

                            Hi, great tool.
                            Anyone know how to download this:-

                            http://www.bbc.co.uk/iplayer/b0072l8y/Monday/console/ ?

                            I have tried get_iplayer –type=radio –url=”http://www.bbc.co.uk/iplayer/b0072l8y/Monday/console/”

                            and

                            get_iplayer –type=radio –url”http://www.bbc.co.uk/iplayer/b0072l8y/Monday/console/”

                            • On January 18th, 2010, linuxcentre said:

                              I’m not quite sure if you are trying to record live radio or a Chris Hawkins episode?

                              If it is the latter then I recommend not using the pop-out console URL but instead just search and record:

                              get_iplayer –ty radio hawkins

                              Matches:
                              10516: Chris Hawkins – 12/01/2010, BBC 6 Music, Classic Pop & Rock,Guidance,Music,Radio,Rock & Indie
                              10517: Chris Hawkins – 13/01/10, BBC 6 Music, Classic Pop & Rock,Guidance,Music,Radio,Rock & Indie
                              10518: Chris Hawkins – 14/01/10, BBC 6 Music, Classic Pop & Rock,Guidance,Music,Radio,Rock & Indie
                              10519: Chris Hawkins – 15/01/10, BBC 6 Music, Classic Pop & Rock,Guidance,Music,Radio,Rock & Indie
                              10520: Chris Hawkins – 18/01/2010, BBC 6 Music, Classic Pop & Rock,Guidance,Music,Radio,Rock & Indie

                              And then record:

                              get_iplayer –get 10520

                              Using the URL is usually more hit and miss compared to using the indexed feeds which are much more accurate and consistent.

                            • On January 18th, 2010, Beer said:

                              Ah good old EastEnders… Now they messed up my PVR. A new program has been created called Eastenders E20. When I do a PVR for the individual episodes (not the omnibus) I do a search for “get_iplayer eastenders$” but now I also get this new and unwanted E20 episode. I have found that the episode name is “E20 Omnibus: Episodes 1-4″, but have not been able to exclude this. Have you got a suggestion?

                              • On January 18th, 2010, linuxcentre said:

                                Aha! You have uncovered a bug. The way I’d suggest filtering this would be:

                                get_iplayer eastenders –fields=name,episode –exclude=E20,omnibus

                                However until 2.63 is out (tonight) this will not work because –exclude incorrectly only ever applied to the name field. Try an update later.

                              • On January 19th, 2010, Dave said:

                                Phil – I sent you an email on this but my server has been playing up so thought I’d post to the blog:

                                I’ve been playing with the PVR Manager and streaming and noticed something weird with my setup. In my get_iplayer options
                                I currently have it set up to create subdirs for each download when cron
                                fires off my PVR. However, when I stream through the PVR Manager, I noticed
                                that the subdir still gets created even through get_iplayer pushes the
                                output to stdout rather than a file. The stream still works fine. I just
                                end up with a bunch of empty subdirs.

                                To fix this, I made a slight edit to the get_iplayer perl script. I saw that the
                                PVR manager uses –stream and that –stream is the same as –stdout
                                –nowrite. So…..

                                # Create dir if it does not exist
                                mkpath(“$prog->{dir}”) if (! -d “$prog->{dir}”) &

                                Became…

                                # Create dir if it does not exist
                                mkpath(“$prog->{dir}”) if (! -d “$prog->{dir}”) && (! $opt->{test}) && (!
                                $opt->{stdout}) &

                                Thought I’d let you know in case you want to incorporate this edit in a
                                release.

                                • On January 19th, 2010, linuxcentre said:

                                  Hi Dave, Yes I did get your email and have been pondering it for weeks. I suspect that fix will probably break when the user specifies metadata only or thumbnail only etc. Also, –stdout != –stream. It’s on my todo list. Thanks for the bug report and patch.

                                  • On January 19th, 2010, Dave said:

                                    Ah – never really played with metadata or thumbnail only. I’ll take a look at those to see what happens.

                                • On January 19th, 2010, steve said:

                                  Having trouble getting a prog in HD. This is the prog, http://www.bbc.co.uk/iplayer/episode/b00qbs17/hd/Hustle_Series_6_Episode_3/

                                  Anyone help please?

                                  • On January 19th, 2010, linuxcentre said:

                                    It works for me. IMHO this isn’t really the forum for asking about whether a specific programme fails to download. If it’s a general problem and this is just one example then fine. But if it’s just a one-off then just wait for a day, try again and failing that try the iPlayer web page and their forums. Always a good idea to make sure you have all the latest versions of flvstreamer and get_iplayer installed. Thanks.

                                    • On January 19th, 2010, steve said:

                                      The trouble I am having is mostly down to being new to this type of thing. I can get three eps to download in iphone quality, but am having trouble gettting just episode 3 in HD. Any help would be most welcome

                                      Thanks.

                                  • On January 19th, 2010, Richard said:

                                    get_iplayer -V

                                    Doesn’t display version,although it does exit!

                                    • On January 19th, 2010, linuxcentre said:

                                      Comments are now closed. Please use the forums on http://linuxcentre.net/forum/

                                      • 672 old comments are not displayed. Click to display all comments

                                      WordPress Themes