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 (Ubuntu, Fedora, OpenBSD and others), macOS (10.10+), Windows (7/8/10).

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
  • get_iplayer 3.27 or higher is required with Mojolicious 9.0+.
• XML::LibXML - Subtitles formatting and HTML parsing for page scraping
• CGI - Web PVR Manager (included with Perl 5.20 and earlier)

Perl modules used on Windows only:

• Win32 - desktop access
• Win32::Unicode - Unicode text in tags

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 streams 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.