get_iplayer PVR Docker image for Raspberry Pi
This is a Docker image based on Raspbian (armhf) that hosts the get_iplayer PVR. It automatically keeps itself up-to-date with the latest version of get_iplayer from the packages.hedgerows.org.uk repository.
The PVR recording feature runs hourly. The get_iplayer version is updated daily using apt-get.
Image configuration
The PVR can be accessed by default on port 1935/tcp
. Set the environment variable PORT
to override.
Downloaded TV & radio files will be placed in the /output
bind mount.
Environment variables PUID
and PGID
can be set to dictate the owner and group of downloaded files (useful if you're putting these files in a shared folder).
If you're running behind a reverse proxy set the environment variable BASEURL
to the full proxy URL.
Example invocation
This makes the PVR available on port 1935, and makes downloaded files owned by the current user:
docker run -d -e PUID=`id -u` -e PGID=`id -g` -p 1935:1935 -v /destination/on/host:/output amathieson/rpi-get-iplayer-web-pvr:latest
Replace /destination/on/host
with the path of a folder on the host machine where you would like the downloaded files to be placed.
get_iplayer configuration
get_iplayer's configuration and cache will be written to the .get_iplayer
subfolder under the /output
bind mount. You can set get_iplayer options in the file /destination/on/host/.get_iplayer/options
.
Refer to the file options.sample for examples.
Migrating an existing get_iplayer installation
-
Copy your existing
.get_iplayer
folder over to/destination/on/host/.get_iplayer
. -
If you have a
.get_iplayer/options
file, open it in a text editor and remove anyoutput
,outputradio
and/oroutputtv
statements. -
Open the file
.get_iplayer/download_history
in a text editor, search for "/old/destination/folder/" and globally replace with "/output/
".
Licences
Contains a compiled version of su-exec, licensed under the MIT licence (https://github.com/ncopa/su-exec/).