get_iplayer installation guides


Install guides are provided on a 'best effort' basis only!

Installation instructions may change. I do not have access to all these systems to test installations so if you see something wrong, start a support thread in the forum.

Package maintainers are encouraged to submit instructions/changes either via the forums, GitHub or via email.

Before you begin: Linux/Unix packages are maintained by volunteers and may not be updated for some time after a new release of get_iplayer, thus the version of get_iplayer packaged for your system may be obsolete. You can find the version number of the latest get_iplayer release here. If the version packaged for your system is older than the latest release, it is likely that some functionality is broken. After following the instructions below, you may wish to uninstall the get_iplayer package and use the manual installation instructions to install the latest get_iplayer CLI and Web PVR Manager.

Raspbian / Raspberry Pi

These instructions are for both Raspbian wheezy and Raspbian jessie.

get-iplayer Package

Raspbian users are recommended to use the get_iplayer repository version (see below), even though the Debian get-iplayer package is incorporated in Raspbian repositories. If you must use the Debian package, refer to the installation instructions for Debian. Note that the version of AtomicParsley packaged with Raspbian (but not the version packaged here) frequently fails with files downloaded with get_iplayer.

get_iplayer Repository Installation

  1. Add the repository

    Paste these lines into a terminal window:

    echo "deb wheezy/" | sudo tee /etc/apt/sources.list.d/
    echo "deb-src wheezy/" | sudo tee -a /etc/apt/sources.list.d/
  2. Install the repository signing key, and update the package index:

    sudo apt-key adv --keyserver --recv 0F5BFDFE
    sudo apt-get update
  3. Install the get-iplayer package

    sudo apt-get install get-iplayer

That's it! You are now ready to run the command line interface with:

    get_iplayer [...]

(There are instructions for removing the repository at

Web PVR Manager (WPM)

The WPM is installed as part of the get-iplayer package.

  1. Launch the WPM in a terminal window with this command:

  2. Once the WPM is running, connect to it by opening this URL in your browser:

  3. After the WPM has opened in your browser, click the Refresh Cache button. A new tab or window will open that shows the cache being refreshed. Leave that tab or window open to have the cache refreshed automatically every hour. You can also manually refresh the cache at any time.

  4. Stop the WPM by typing Ctrl-C.