This is a smallish (100MB) Docker image that hosts the get_iplayer PVR. It automatically keeps itself up-to-date with the latest version of get_iplayer.
The PVR recording feature runs hourly. The get_iplayer version is updated daily.
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.
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 marginal/get_iplayer: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'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, including how to setup to send a Slack notification after a download.
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 any output
, outputradio
and/or outputtv
statements.
Open the file .get_iplayer/download_history
in a text editor, search for "/old/destination/folder/" and globally replace with "/output/
".