unixpkg2 - get-iplayer/get_iplayer GitHub Wiki

Linux/BSD package installation additional information

(Return to Installation ToC)

(Return to Linux/BSD package installation)

  • Debian (from software.opensuse.org)

    • Note that the package name is "get-iplayer" (with hyphen), but you can still run the application as "get_iplayer" (with underscore).

  • Raspbian/Raspberry Pi OS (from software.opensuse.org)

    • IMPORTANT: Shortly after the release of v3.26, the repository previously at packages.hedgerows.org.uk was deleted by its maintainer. Before upgrading from 3.26 or lower, purge the old package and repository from your system:

        # purge get-iplayer
  sudo apt purge get-iplayer
  # remove unneeded dependencies installed with get-iplayer
  sudo apt autoremove
  # remove the packages.hedgerows.org.uk repository
  sudo rm /etc/apt/sources.list.d/packages.hedgerows.org.uk*
  # remove the repository signing key used for packages.hedgerows.org.uk
  # - for [email protected]
  sudo apt-key del 0F5BFDFE
  # - for jon's build-bot
  sudo apt-key del 13924333
  # update the packages list
  sudo apt update

    • You then have three options:

      1. Install and use another third-party repository that is now available. Installation instructions are provided at the repository site. Note that the package name is "get-iplayer" (with hyphen), but you can still run the application as "get_iplayer" (with underscore).

      2. Install the snap version (if available).

      3. Perform a manual installation, which is well-supported by Debian and derivative distros.

  • Slackware (from Slackbuilds)

    • In Slackware 14.1 or later, ensure that the linuxdoc-tools package (in the AP set) is installed in addition to any other dependencies noted in SlackBuild files. It is an unrecorded requirement for the perl-xml-libxml package. It will be present in a full Slackware installation, but it may not be installed by default in other variants or derived distros (e.g., Salix).

  • Ubuntu/Mint (and other Ubuntu-based distros) (from Launchpad PPA)

    • IMPORTANT: Shortly after the release of v3.26, the PPA formerly at launchpad.net/~jon-hedgerows/+archive/ubuntu/get-iplayer was deleted by its maintainer. Before upgrading from 3.26 or lower, purge the old package and repository from your system:

        # purge get-iplayer
  sudo apt purge get-iplayer
  # remove dependencies installed with get-iplayer
  sudo apt autoremove
  # remove the launchpad.net/~jon-hedgerows PPA and key
  sudo rm /etc/apt/sources.list.d/jon-hedgerows-ubuntu-get-iplayer*
  sudo rm /etc/apt/trusted.gpg.d/jon-hedgerows_ubuntu_get-iplayer.gpg
  # update the packages list
  sudo apt update

    • You then have three options:

      1. Install and use another third-party PPA that is now available. Installation instructions are provided at the PPA site. Note that the package name is "get-iplayer" (with hyphen), but you can still run the application as "get_iplayer" (with underscore).

      2. Install the snap version (if available).

      3. Perform a manual installation, which is well-supported by Ubuntu and derivative distros.

    • Android note: If you have been using UserLAnd + Ubuntu + PPA to run get_iplayer on Android, you will need to switch to a manual installation or to the alternate PPA since snap support is not available.

  • Distros with snap support (from snapcraft)

    • IMPORTANT: Before upgrading from a PPA version to the snap version on Ubuntu, purge the old package and repository from your system:

        # purge get-iplayer
  sudo apt purge get-iplayer
  # remove unneeded dependencies installed with get-iplayer
  sudo apt autoremove
  # remove the launchpad.net/~jon-hedgerows PPA and key (if used)
  sudo rm /etc/apt/sources.list.d/jon-hedgerows-ubuntu-get-iplayer*
  sudo rm /etc/apt/trusted.gpg.d/jon-hedgerows_ubuntu_get-iplayer.gpg
  # remove the launchpad.net/~m-grant-prg PPA and key (if used only for get_iplayer)
  sudo rm /etc/apt/sources.list.d/m-grant-prg-ubuntu-utils*
  sudo rm /etc/apt/trusted.gpg.d/m-grant-prg_ubuntu_utils.gpg
  # update the packages list
  sudo apt update

      For other distros, use whatever process is required to completely purge a previous release of get_iplayer from your system before installing the snap version.

    • Installation instructions for various distros can be found at the Snap Store. get_iplayer can also be installed from the Ubuntu Software/Snap Store desktop application (if available). Note that the snap name is "get-iplayer" (with hyphen), but you can still run the application as "get_iplayer" (with underscore). IMPORTANT: You may need to install from the "edge" channel to get the current version. As of v3.28, the get-player snap no longer appears to be actively maintained.

    • IMPORTANT: The default get_iplayer profile directory will be $HOME/snap/get-iplayer/common/.get_iplayer rather than $HOME/.get_iplayer ($HOME is set to the value of $SNAP_USER_COMMON in the snap environment). Immediately after upgrading from a PPA version to the snap version, you must move or copy the contents of your profile directory to the location used by the snap version:

        # run once to ensure snap version initialises profile directory
  get_iplayer
  # move/copy contents of profile directory
  mv ~/.get_iplayer/* ~/snap/get-iplayer/common/.get_iplayer
  # OR
  cp -r ~/.get_iplayer/* ~/snap/get-iplayer/common/.get_iplayer

    • If an "ERROR: Cannot read options file: /etc/get_iplayer/options" message appears when you run the snap version, remove the indicated directory (it is not required by get_iplayer):

        sudo rm -fr /etc/get_iplayer

    • get_iplayer will not be able to create files on removable devices mounted under /media, /run/media or /mnt unless the snap's "removable-media" interface is connected:

        sudo snap connect get-iplayer:removable-media

      You can also select "Read/write files on removable storage devices" in the permissions for get-iplayer in the Ubuntu Software/Snap Store desktop application (if available) after installation. If your removable device is mounted in another location, you may be able to use a bind mount to access it somewhere under your home directory.

    • To launch the Web PVR Manager: run get-iplayer.cgi --port=1935 from a command prompt and open http://127.0.0.1:1935 in your browser.