release330to339 - get-iplayer/get_iplayer GitHub Wiki
get_iplayer 3.36 - 2025-05-04
get_iplayer 3.35 - 2024-01-14
get_iplayer 3.34 - 2023-10-31
get_iplayer 3.33 - 2023-10-12
get_iplayer 3.32 - 2023-10-11
get_iplayer 3.31 - 2023-01-21
get_iplayer 3.30 - 2022-05-28
- Fix: BBC One national schedule no longer exists on bbc.co.uk (thanks @JohnVeness)
- Fix: Using 'episode' as part of --fields omits Doctor Who episode "Rogue" from search results
- Fix: Thumbnails are 192x108 if download via search term, 1920x1080 if download via pid
- Fix: Get_iplayer Throws Minor Error Due to BBC Discontinuing Radio 4 LW Schedules (thanks @nowster)
- Enh: Added
--pid-recursive-channel
,--pid-recursive-exclude-channel
,--pid-recursive-exclude
,--pid-recursive-search
options for additional filtering of--pid-recursive
episode lists. These may prove useful in winnowing episode lists for anthology series. Check filtering before download with--pid-recursive-list
.
The BBC announced that from Spring 2025, non-UK listenters will no longer be able to access BBC Sounds:
https://www.bbc.co.uk/sounds/help/questions/listening-outside-the-uk/outside-uk-changes
They will instead be directed to a new site (https://www.bbc.com/audio) that will only provide audio-on-demand streams for BBC podcasts, rather than the (nearly) full complement of AOD BBC radio programmes currently available as 96k and 48k streams from outside the UK.
It is not yet known if get_iplayer will be able to access the podcast streams on the new site once the switchover is complete. It is also not yet known if get_iplayer will be able to index or access radio programmes not packaged as podcasts from outside the UK after the switchover.
See: https://github.com/get-iplayer/get_iplayer/wiki/installation
See: https://github.com/get-iplayer/get_iplayer/wiki
- Fixed a bug introduced in v3.32 that caused tagging failures with a "Wide character" error when
--tag-only-filename
contained non-ASCII characters. - Adapted for changes to iPlayer site that caused unwanted items to be downloaded with
--pid-recursive
when the "More like this" listings for CBBC/CBeebies programmes contained links to individual episodes rather than to series. - Corrected a typo in option specs that caused a "duplicate specification" warning when Getopt::Long Perl module >= 2.55.
See: https://github.com/get-iplayer/get_iplayer/wiki/installation
See: https://github.com/get-iplayer/get_iplayer/wiki
- Fixed a bug introduced in v3.32 that caused download failures with
--versions=default
.
See: https://github.com/get-iplayer/get_iplayer/wiki/installation
See: https://github.com/get-iplayer/get_iplayer/wiki
get_iplayer 3.32 was withdrawn shortly after release. See its release notes below for details of other recent changes.
- Web PVR: Fixed a bug introduced in v3.32 that broke display formatting of the PVR list.
- macOS: Fixed a bug in the installer that could prevent Web PVR from launching.
See: https://github.com/get-iplayer/get_iplayer/wiki/installation
See: https://github.com/get-iplayer/get_iplayer/wiki
- Windows: Fixed a download failure when the
--output
option value on the command line contained typographer's quotes (curly quotes, "smart" quotes). Windows users are advised to avoid specifying typographer's quotes (or any non-ASCII characters) on the command line with--output{-tv,-radio}
,--file-prefix
, and--subdir-format
. Use substitution parameters and let get_iplayer handle encoding/decoding. Be especially careful when copying text from BBC web sites. - Fixed a download failure due to a regular expression parse error when the programme episode title contained an invalid metacharacter sequence (e.g., "**") and
--no-sanitise
was specified. - Fixed a bug that caused signed versions of certain programmes to be downloaded even though default versions were available.
- Fixed a bug that caused a failure to download a thumbnail image for a small number of programmes that only have images available in PNG format.
- Repaired series/brand downloading with
--pid-recursive
for CBeebies and CBBC programmes. It was broken by changes to the iPlayer web site. - Some programmes now have a separate "combined" version available that contains both audio description and signing. For example, you can use
--versions=combined,audiodescribed
to prefer the "combined" version (if available) over the version that contains only audio description. Use--info
to check available versions for a programme. - The
--no-purge
and--trim-history
options may no longer be entered on the command line. Any associated entries remaining in settings, presets, or PVR searches are already ignored and will now generate a non-fatal warning in verbose mode. - The
--modes
,--tv-mode
,--radio-mode
, and--fps25
options may no longer be used on the command line. Use--quality
,--tv-quality
,--radio-quality
, or--tv-lower-bitrate
instead. Attempting to use the old options will result in a fatal warning. Associated entries already in settings, presets, or PVR searches are not affected, and the settings keys remain the same (modes
,tvmode
,radiomode
,fps25
). Note that the column headers in the PVR List page of the Web PVR Manager show the settings keys and thus reflect the old option names. - You can no longer enter old, invalid values ("hvfhd", "dvfhigh", "hafstd", "dashlow", etc.) for
--quality
,--tv-quality
, or--radio-quality
. Attempting to use the old values will generate a fatal warning that also displays the list of valid values. Associated entries already in settings, presets, or PVR searches do not need to be updated. They will be converted at run time. - Added a
<seriessort>
substitution parameter, which is set to<series>
if present, otherwise to<firstbcastyear>
. It is intended for use with--subdir-format
to ensure that a series-level directory can be created when a multi-level hierarchy is specified. - Added a
<releaseyear>
substitution parameter, which is the year a programme was originally released, if available - otherwise set to<firstbcastyear>
. The two items are often the same for TV and radio episodes, but may be different for films and archive programmes, e.g., Radio 4 Extra shows. - The episode ID tag (tven atom) is now always set to the programme PID. PID was formerly the backup value.
- Web PVR: Added a 1920x1080 option for streaming downloaded programmes.
See: https://github.com/get-iplayer/get_iplayer/wiki/installation
See: https://github.com/get-iplayer/get_iplayer/wiki
- Windows: Fixed a problem that could prevent the Web PVR Manager from launching in Windows Terminal/Windows 11. The PVR Service Manager is now launched in a new window, after which the Web PVR Manager window will close.
- Fixed a problem that could prevent cache refresh from working if a cache file was corrupted such that it contained future values in the
<timeadded>
field. - Metadata files are no longer automatically overwritten on every download (with
--metadata
or--metadata-only
). The--overwrite
option is now required to replace metadata files, as with other auxiliary files. - get_iplayer now writes distinct values for 720p and 1080p downloads in the
hdvd
MP4 atom where supported by recent versions of AtomicParsley. Some applications (e.g., Subler and Apple's TV app) can utilise the value of thehdvd
atom when displaying file properties.
See: https://github.com/get-iplayer/get_iplayer/wiki/installation
See: https://github.com/get-iplayer/get_iplayer/wiki
- Fixed a bug that produced audio-only downloads for some programmes when FHD quality was requested but no 1080p video was available.
- Progress display for FHD downloads only now iterates towards a closer approximation of final file size. FHD file size estimates shown with
--info
remain very inaccurate.
See: https://github.com/get-iplayer/get_iplayer/wiki/installation