Notices: This section not yet converted to new layout. Download stats are rolling back out.

This is not the latest version of getiplayer (Install) available.

getiplayer (Install)


Package test results are passing.

Private CDN cached downloads available for licensed customers. Never experience 404 breakages again! Learn more...

This package was approved as a trusted package on 11/29/2017.

get_iplayer: BBC iPlayer Indexing Tool and PVR


  • Downloads TV and radio programmes from BBC iPlayer
  • Allows multiple programmes to be downloaded using a single command
  • Indexing of most available iPlayer catch-up programmes (not BBC Three, Red Button or iPlayer Exclusive)
  • Caching of index with automatic updating
  • Regex search on programme name
  • Regex search on programme description and episode title
  • Filter search results by channel
  • Direct download via programme ID or URL
  • PVR capability (may be used with cron or Task Scheduler)
  • HTTP proxy support
  • Perl 5.10.1+ required, plus LWP, LWP::Protocol::https, XML::LibXML and Mojolicious modules
  • Requires ffmpeg for conversion to MP4 and AtomicParsley for metadata tagging
  • Runs on Linux/BSD (Ubuntu, Fedora, OpenBSD and others), macOS (10.10+), Windows (7/8/10 - XP/Vista not supported)


  • get_iplayer can only search for programmes that were broadcast on BBC linear services within the previous 30 days, even if some are available for more than 30 days on the iPlayer site. Any programmes that are still available after 30 days must be located on the iPlayer site and downloaded directly via PID or URL.
  • get_iplayer does not support downloading news/sport videos, other embedded media, archive sites, special collections, educational material, programme clips or any content other than whole episodes of programmes broadcast on BBC linear services within the previous 30 days, plus episodes of BBC Three programmes posted within the same period. It may be possible to download other content directly via PID or URL, but such use is not supported.

To install getiplayer (Install), run the following command from the command line or from PowerShell:

C:\> choco install getiplayer --version 3.07

To upgrade getiplayer (Install), run the following command from the command line or from PowerShell:

C:\> choco upgrade getiplayer --version 3.07


  • tools\chocolateyinstall.ps1 Show
    $ErrorActionPreference = 'Stop';
    $packageName= 'getiplayer'
    $toolsDir   = "$(Split-Path -parent $MyInvocation.MyCommand.Definition)"
    $url        = ''
    $packageArgs = @{
      packageName   = $packageName
      unzipLocation = $toolsDir
      fileType      = 'exe'
      url           = $url
      url64bit      = $url64
      softwareName  = 'getiplayer*'
      checksum      = 'ceb3318fd681fefb32d18ee4d9ea27f559fe7b53'
      checksumType  = 'sha1'
      checksum64    = ''
      checksumType64= 'sha256'
    Install-ChocolateyPackage @packageArgs
  • tools\chocolateyuninstall.ps1 Show
    $ErrorActionPreference = 'Stop';
    $packageName = 'getiplayer'
    $softwareName = 'get_iplayer*'
    $installerType = 'EXE' 
    $validExitCodes = @(0, 3010, 1605, 1614, 1641)
    if ($installerType -ne 'MSI') {
      $silentArgs = '/S'
      $validExitCodes = @(0)
    $uninstalled = $false
    [array]$key = Get-UninstallRegistryKey -SoftwareName $softwareName
    if ($key.Count -eq 1) {
      $key | % { 
        $file = "$($_.UninstallString)"
        if ($installerType -eq 'MSI') {
          $silentArgs = "$($_.PSChildName) $silentArgs"
          $file = ''
        Uninstall-ChocolateyPackage -PackageName $packageName `
                                    -FileType $installerType `
                                    -SilentArgs "$silentArgs" `
                                    -ValidExitCodes $validExitCodes `
                                    -File "$file"
    } elseif ($key.Count -eq 0) {
      Write-Warning "$packageName has already been uninstalled by other means."
    } elseif ($key.Count -gt 1) {
      Write-Warning "$key.Count matches found!"
      Write-Warning "To prevent accidental data loss, no programs will be uninstalled."
      Write-Warning "Please alert package maintainer the following keys were matched:"
      $key | % {Write-Warning "- $_.DisplayName"}

Virus Scan Results

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.


This package has no dependencies.

Package Maintainer(s)

Software Author(s)

  • A. S. Budden
  • Alexey Tourbin
  • Andrew Elwell
  • Andy Bircumshaw
  • Bill Boughton
  • Caius Durling
  • Chris Reed
  • BBR
  • Crispin Flowerday
  • David Woodhouse
  • Edward Betts
  • HenderHobbit
  • Ian Praxil
  • James
  • James Laver
  • James Ross
  • James Teh
  • John Henderson
  • Jon Davies
  • Jonathan Harris
  • Jonathan Larmour
  • Jonathan Wiltshire
  • Matthew Boyle
  • Mike Crowe
  • Mike Fleetwood
  • Murray
  • Peter Oliver
  • Phil Cole
  • Ralf Baechle
  • Sharon Kimble
  • Shevek
  • Steven Luo
  • Stuart Henderson
  • Vangelis forthnet
  • Vangelis66
  • Will Elwood
  • dinkypumpkin
  • fs ck
  • fsck
  • linuxcentrenet
  • notnac
  • willemw12


2008-2010 Phil Lewis


Release Notes

get_iplayer 3.07 Release Notes

Changes in 3.07

  • get_iplayer no longer dumps the entire contents of your cache when invoked without a search argument. If you wish to list the entire contents of your cache, you must now explicitly specify a wildcard search: get_iplayer ".*" - note the quotes. The Web PVR Manager does that by default. Also remember to use --refresh for ad hoc cache updates.
  • getiplayer no longer automatically attempts to add higher-quality audio to "hls" mode downloads (functionality introduced in v3.03). Some output files were being produced with audio and video out of sync. getiplayer should never produce output worse that what is offered by iPlayer, so that functionality is now optional. Use the new --hls-hq-audio option to enable it, and heed the warning that you may need to edit your output files to sync audio and video. The --no-hq-audio option is now ignored and will be removed in the next release. If you added it to your preferences, remove it now with get_iplayer --prefs-del --no-hq-audio. (@notnac)
  • Added --audio-only option to download only the audio stream for a TV programme. It is intended to enable users with visual impairments to skip downloading the video stream for programmes with audio description, but it can be used for any programme. It does not work with "hls" modes, however, so do not try to use it with --tvmode=hlshd, for example. Use of --audio-only also enables --force so that you can re-download a different audio track for a previously-downloaded TV programme. That will also produce an additional entry in your download history for the audio file. Audio-only downloads produce .m4a files.
  • Subtitles are now trimmed according to --start and --stop, if specified. The actual subtitles start and/or stop times are calculated to the nearest chunk boundary in the HLS or DASH stream. The value of --suboffset is still applied. This trimming is not supported for --subtitles-only. You can use --subtitles-only to re-download the full subtitles for a programme if desired. (@notnac)
  • Reinstated the --no-sanitise option to minimise the sanitising of output file names. With this option, the characters \"*:<>?| are removed on Windows and : is removed on macOS. All other characters are retained. Use of --no-sanitise also enables --whitespace. get_iplayer may fail with --no-sanitise if iPlayer metadata used to construct file names is incorrectly encoded. (@notnac)
  • The time that a programme is considered available for download is now determined by the end time of its scheduled broadcast slot, if possible. This should make it less likely to see "No media streams" errors when a PVR search attempts to download a programme while it is still being transmitted. This will only affect cache entries created after you install v3.07. (@notnac)
  • Reverted to text-only progress display, with data sizes now shown with SI prefixes instead of binary prefixes.
  • [Windows] During installation, you now have the option to create desktop shortcuts (for all users)
  • [Windows] The installer no longer attempts to perform an item-by-item cleanup of previous installations. Instead, it looks for an uninstaller registered by an older edition of the installer and, if found, executes it to remove the previous version before proceeding with installation of the new version. You have the opportunity to cancel before the previous version is removed.
  • [Windows] Because of the change in how the installer cleans up old versions, there is an edge case to be aware of. If all of the conditions below apply to you:

    • You installed get_iplayer before v2.95 (July 2016)
    • You selected a custom output directory in the installer
    • You never uninstalled get_iplayer
    • You never upgraded to v2.95 - v3.06

    then you will likely need to add your custom output directory to your preferences after installing v3.07 or higher, e.g., get_iplayer --prefs-add --output=D:\get_iplayer

  • Fixed a bug that caused getiplayer to exit (and skip metadata tagging) when corrupt subtitles were provided by the BBC. Corrupt subtitles will now generate an error message, but getiplayer will not exit. As an extra precaution, subtitles download now occurs after tagging is complete.
  • Fixed a bug that prevented previously-unknown programme versions from being used when --versionlist contained "default". (@notnac)
  • Fixed a bug that caused slashes in programme names to be retained, thus creating unnecessary subdirectories in output file paths with --subdir. Slashes are now replaced with underscores. (@notnac)
  • Fixed a bug that caused some streams to be omitted for some World Service programmes. (@notnac)
  • [Fedora] Fixed a bug in parsing iPlayer download links for URI handler. (@mavit)


See: get_iplayer wiki

More Information

See: get_iplayer wiki

Version History

Version Downloads Last updated Status
getiplayer (Install) 3.20 191 Tuesday, February 26, 2019 approved
getiplayer (Install) 3.18 140 Thursday, January 3, 2019 approved
getiplayer (Install) 3.16 312 Friday, July 6, 2018 approved
getiplayer (Install) 3.15 98 Thursday, July 5, 2018 approved
getiplayer (Install) 3.14 213 Wednesday, May 9, 2018 approved
getiplayer (Install) 3.13 225 Tuesday, March 27, 2018 approved
getiplayer (Install) 3.12 267 Monday, January 15, 2018 approved
getiplayer (Install) 3.10 186 Friday, January 12, 2018 approved
getiplayer (Install) 3.09 283 Tuesday, January 2, 2018 approved
Show More

Discussion for the getiplayer (Install) Package

Ground rules:

  • This discussion is only about getiplayer (Install) and the getiplayer (Install) package. If you have feedback for Chocolatey, please contact the google group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or getiplayer (Install), or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.

comments powered by Disqus uses cookies to enhance the user experience of the site.