installation

get_iplayer Installation

(Return to ToC)

Table of Contents

• Linux/BSD
  • Package installation
  • Manual installation
• macOS
• Windows
• Source code
• Requirements
  • Perl
  • External programs

Source code

The source code for the latest get_iplayer release can be downloaded as a tarball or zip archive from:

https://github.com/get-iplayer/get_iplayer/releases/latest

Requirements

get_iplayer runs on Linux/BSD (numerous distros supported), macOS (10.10+) and Windows (7/8/10 - XP/Vista not supported).

Perl

• Perl 5.16+ is required

Perl modules (with dependencies) required for get_iplayer:

• LWP - HTTP access to BBC servers
• LWP::Protocol::https - HTTPS support for LWP
• Mojolicious - Web toolkit
• XML::LibXML - Subtitles formatting and HTML parsing for page scraping
• CGI - Web PVR Manager (included with Perl 5.20 and earlier)
• JSON::PP - JSON parsing (included with Perl 5.14 and later)

Users of Perl 5.20 and earlier do not need to install the CGI module separately.

Users of Perl 5.14 and later do not need to install the JSON::PP module separately.

External programs

get_iplayer employs external programs to convert and tag media files:

• AtomicParsley - Metadata tagging for MP4 and M4A files.
• ffmpeg - Converts MPEG-DASH and MPEG-TS files to MP4 and M4A.

get_iplayer will run without these external programs, but downloaded files will be left in their raw streaming formats and metadata tags will not be created.

Web server deployment not supported

NOTE: Web server deployment is not supported for get_iplayer or Web PVR Manager. You may be able to deploy them in your environment, but such installations are not supported by the developers.