release320to329

get_iplayer 3.20 - 3.29 Release Notes

get_iplayer 3.23 - 2019-11-29

get_iplayer 3.22 - 2019-08-19

get_iplayer 3.21 - 2019-07-14

get_iplayer 3.20 - 2019-02-25

get_iplayer 3.23 Release Notes

Changes in 3.23

Adapted for BBC changes that caused "403 Forbidden" errors when attempting to download HLS streams (the default).
- The --hls-lq-audio option is now ignored and will be removed in the next release. 320k audio for TV programmes is no longer available, so the option has no effect.
- 320k/96k HLS streams for radio programmes are no longer available, except for 96k HLS streams for some World Service programmes. DASH streams are still available for those bit rates. Some older programmes may still have 320k/96k HLS streams available, but they should eventually disappear.
- If you use default settings for download quality (which should be the case for most users), you do not need to change anything. The best quality available will still be downloaded by default.
- If you don't use default settings, you may need to adjust your recording modes for radio programmes. The hafhigh and hafmed modes will still be accepted, but they likely will have no effect. Recording modes for TV programmes should not need changes.
Added CBeebies Radio to programme indexing
Radio button labels in Web PVR Manager are now clickable (@hintswen)
Fixed a bug that caused get_iplayer to fail with Perl 5.16 (@llewelld)
Fixed a bug that caused PVR searches for Proms programmes to download both TV and radio episodes even if --type=radio was specified.

Support Notes

Windows 7 and 8 are no longer formally supported. In practice this means that should get_iplayer or any of its dependencies become incompatible with Windows 7 or 8, no fix will be supplied. It also means that any Windows-related bug reports will only be evaluated on the latest version of Windows 10, since the developers will no longer have access to Windows 7 or 8. However, get_iplayer should continue to run on Windows 7 and 8 for the time being.

Installation

See: https://github.com/get-iplayer/get_iplayer/wiki/installation

Documentation

See: https://github.com/get-iplayer/get_iplayer/wiki

get_iplayer 3.22 Release Notes

Changes in 3.22

Fixed schedule page parsing used for cache updates. This was broken by BBC changes and manifested as a series of “WARNING: Got 0 programmes...” messages during cache updates. Your cache will not update without this fix. If you find that some programmes are still missing from your cache, use --cache-rebuild to perform a full rebuild.
get_iplayer now recognises previously-unknown programme versions (e.g., "legal") when the "default" pseudo-version is specified in the value of the --versionlist option.
The --pid-recursive-type option is now applied when only downloading auxiliary resources (e.g., --subtitles-only).
Fixed programme title extraction with --pid-recursive to prevent unwanted extra text being appended to title in episode listing (e.g., for Proms programmes).

Installation

See: https://github.com/get-iplayer/get_iplayer/wiki/installation

Documentation

See: https://github.com/get-iplayer/get_iplayer/wiki

get_iplayer 3.21 Release Notes

Changes in 3.21

Added --release-check option to check for new releases
- If used on the command line (get_iplayer --release-check) an immediate check is made.
- If added to preferences (get_iplayer --prefs-add --release-check) a weekly check is made. The modification time on the "release_check" file in your profile directory is used to determine when a check is due.
- Accesses release feeds from GitHub repositories.
- get_iplayer is NOT automatically updated with --release-check . It only prints a message notifying you that a new release is available.
Added --cuesheet and --cuesheet-only options to download track information in the form of a cue sheet (.cue file).
- Applies to radio programmes only. Only useful with radio programmes that publish track lists on BBC site.
- You cannot assume cue sheets to be accurate since track data is often wrong. You must correct cue sheets as needed if you use them to play back or edit downloaded programmes.
- get_iplayer makes no attempt to identify air breaks between tracks. You must set track end times manually if you use cue sheets to edit downloaded programmes.
- You will need to add a UTF-8 BOM (byte order mark) to cue sheets so that non-ASCII characters are displayed properly in some applications, e.g., foobar2000. This can be done with any capable text editor, or in the Notepad "Save" dialog with Encoding = "UTF-8 with BOM" (Windows 10) or Encoding = "UTF-8" (Windows 7).
--subs-embed now implies --subs-mono. If you use --subs-embed, you no longer need to use --subs-mono.
- Embedded subtitles are rendered in a single colour, so this change ensures that embedded subtitles have leading hyphens to denote changes of speaker.
- This change also ensures that the external SRT file is formatted the same as the embedded subtitles. If you wish to create an external SRT file with colour subtitles along with embedded subtitles, use --subtitles-only --no-subs-embed --no-subs-mono --overwrite to re-download colour subtitles and replace the SRT file.
Added --metadata=json option to create metadata file in JSON format (.json file). Content is the same as default XML-format metadata files (produced by --metadata without format value specified).
Added --pid-recursive-type option to limit recursive downloads to programmes of specified type (radio or tv) when series includes both radio and TV programmes. Option value is not reflected in listings from --pid-recursive-list, nor is it applied when only downloading auxiliary resources (e.g., --metadata-only). Requires --pid-recursive.
Added <sesortx> substitution parameter. See definition in Substitution Parameters. This parameter provides an additional option for constructing sortable file names with --file-prefix.
The --pid option can no longer be saved in the default options file, where it could break subsequent downloads. It can still be saved in presets and used with --pvr-queue.
The installer-supplied wrapper script that launches a standalone Web PVR Manager server has been renamed from get_iplayer.cgi to get_iplayer_cgi (macOS) and from get_iplayer.cgi.cmd to get_iplayer_cgi.cmd (Windows).
Implemented a workaround for a deficiency in Windows Perl that caused "Wide character in print" warnings.
Implemented a workaround to avoid Can't locate object method "subtitles_available" error when using --pid-recursive with --subtitles or --subtitles-only with mixed TV/radio series.
Fixed a bug that caused the channel name to be tagged as "BBC iPlayer" when downloading individual programmes with --pid.
Fixed a bug that caused downloads to fail when using default settings if the only available version of a radio programme was "podcastX" (where X = 2,3,...).

Installation

See: https://github.com/get-iplayer/get_iplayer/wiki/installation

Documentation

See: https://github.com/get-iplayer/get_iplayer/wiki

get_iplayer 3.20 Release Notes

Changes in 3.20

Fixed a bug in v3.19 that caused a "Can't use an undefined value as an ARRAY reference" error when using --pid-recursive or --pid-recursive-list with programmes that have no available episodes
Fixed a bug in v3.19 that prevented Windows users from viewing and editing PVR searches in the Web PVR Manager.
EDIT: If you find that BBC Scotland programmes of interest are missing from search results, force all available BBC Scotland programmes to be indexed and cached with (ignore any 404 errors):
```
  get_iplayer --refresh --refresh-include="BBC Scotland" --refresh-limit=30
```

v3.20 was released soon after v3.19, which was withdrawn. See the get_iplayer 3.19 release notes for other recent changes.