Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Support] binhex - get_iplayer

Featured Replies

21 hours ago, binhex said:

OK ended up reworking the script quite a bit, so audio (radio) support is now in, if you want to use it then pull down the new image and then add a new 'variable' to your container named 'AUDIO_SHOWS_NAME' to specify the name of the show, and if you want to use the show PID then add variable 'AUDIO_SHOWS_PID' (new users will have these already created).

Thanks :) Added the new Variables and will test it out!

  • Replies 173
  • Views 43.1k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • atomicparsley path now hard set in the latest image, please pull down image.   all fixed up in the latest image please pull down, thanks for the screenshot.

  • OK ended up reworking the script quite a bit, so audio (radio) support is now in, if you want to use it then pull down the new image and then add a new 'variable' to your container named 'AUDIO_SHOWS_

  • most of the shows I search for show as not found in the logs, despite existing in Iplayer and working via the windows version. PID is supported by get-iplayer so I thought Id try that. Is it not suppo

Posted Images

I spent quite a while trying to figure out how to fix my issue of not being able to find where get_iplayer via CLI is storing the files.

 

Without specifying any specific output location when running the command, it seems that it just stores it in the docker vDisk which is not accessible to SMB or root on the GUI. There does seem to be an open issue on Github about this very problem from May 20th 2021...yet other people seem to manage to use it just fine, so unless everyone is used to specifying output or it just isn't automatically added to the preferences when you first start the Docker.

 

Likewise, the atomicparsley location is also not known when using the command line, despite this being in the options file in the config location, so it has to be specified as part of the command in order for it to be able to tag the MP4 files. FFMPEG works just fine however, despite the path to that also being in the options file.

 

EDIT: I tried to update the preferences with the output location, but it saves the options file in 

/home/nobody/.get_iplayer/options

which I have no idea where that is or if it exists.

 

So I'm guessing that the options file in the binhex-get-iplayer folder is not the one actually in use by get_iplayer itself.

 

According to the generic get_iplayer wiki, the user preferences directory can be changed at runtime with --profile-dir, but this isn't saved in your options file, so you should instead use the environment variable. Is there any change this can be remidied?

Edited by Sergeant_Stevie

  • Author
12 hours ago, Sergeant_Stevie said:

I spent quite a while trying to figure out how to fix my issue of not being able to find where get_iplayer via CLI is storing the files.


By default this image will save incomplete and completed to /data/incomplete and /data/completed respectively.

 

Quote

According to the generic get_iplayer wiki, the user preferences directory can be changed at runtime with --profile-dir


Indeed, and this is set for you to point at /config via the start.sh script which is included in the image, so you should find options file there, along with other get_iplayer related files and logs.

51 minutes ago, binhex said:

By default this image will save incomplete and completed to /data/incomplete and /data/completed respectively.

I must admit this was not the case for me. Those folders were created at the location I pointed /data to when I first installed the docker last year, but they're not being used by the current more recently updated docker. I've only just started using the docker version, but I haven't changed anything (except what I wrote yesterday).

 

So, some time between December 24 and now something changed with my docker that made it revert to using the vDisk.

 

52 minutes ago, binhex said:

Indeed, and this is set for you to point at /config via the start.sh script which is included in the image, so you should find options file there, along with other get_iplayer related files and logs.

Which again is strange because I can clearly see that there is an options file in appdata/binhex-get-iplayer which is where /config is pointing to, but for some reason it isn't being used. Although it is strange that it knows where FFMPEG is but not Atomic Parsley.

 

I guess I can try deleting the Docker image entirely and setting it up again and see if it works 🤷🏻.

  • Author
15 minutes ago, Sergeant_Stevie said:

I must admit this was not the case for me. Those folders were created at the location I pointed /data to when I first installed the docker last year, but they're not being used by the current more recently updated docker. I've only just started using the docker version, but I haven't changed anything (except what I wrote yesterday).

 

So, some time between December 24 and now something changed with my docker that made it revert to using the vDisk.

 

Which again is strange because I can clearly see that there is an options file in appdata/binhex-get-iplayer which is where /config is pointing to, but for some reason it isn't being used. Although it is strange that it knows where FFMPEG is but not Atomic Parsley.

 

I guess I can try deleting the Docker image entirely and setting it up again and see if it works 🤷🏻.

do the steps in gather command execution:- https://github.com/binhex/documentation/blob/master/docker/faq/help.md#gather-command-execution
 

So I've checked under advanced view and I do not have a DEBUG variable, I added one but the log doesn't contain much in the way of "DEBUG" information, only 3 entries for "DEBG" and nothing else gets written to the log even after downloading a program from iPlayer (via CLI, not by entering a PID/Show to the container config).

 

I tried starting from scratch again, including deleting the binhex-get-iplayer folder in appdata, but it seems to do the same thing as before and there is no options file in the newly created folder.

 

Attached the two files as requested.

binhex-get-iplayer command execution.txt supervisord.log

Edited by Sergeant_Stevie

  • Author
7 minutes ago, Sergeant_Stevie said:

So I've checked under advanced view and I do not have a DEBUG variable, I added one but the log doesn't contain much in the way of "DEBUG" information, only 3 entries for "DEBG" and nothing else gets written to the log even after downloading a program from iPlayer (via CLI, not by entering a PID/Show to the container config).

 

I tried starting from scratch again, including deleting the binhex-get-iplayer folder in appdata, but it seems to do the same thing as before and there is no options file in the newly created folder.

 

Attached the two files as requested.

binhex-get-iplayer command execution.txt 876 B · 0 downloads supervisord.log 2.29 kB · 0 downloads

it appears you aren't supplying any show names or pids and thus the script is exiting out, as it has nothing to do, from your log:-

[crit] Video/Audio show name or PID is not defined.
[crit] Please specify the show name via env var 'VIDEO_SHOWS_NAME' and/or 'AUDIO_SHOWS_NAME'.
[crit] Alternatively, specify the show PID via env var 'VIDEO_SHOWS_PID' and/or 'AUDIO_SHOWS_PID'.
[crit] Exiting script...

So you need to supply a pid or name in order for get_iplayer to start and run.

I prefer doing things manually via CLI as I can specify the quality (e.g. fhd) and also see if some shows are only available in other formats (e.g. sometimes a TV show is only available Audio Described despite all others in the series being "original") as it throws an error if that happens.

 

If I put a single PID in and let it download, is it going to apply the same settings to the console commands? Or does the incomplete/complete behaviour only apply to the script that checks every x hours?

  • 2 weeks later...
On 4/3/2025 at 3:08 PM, binhex said:

OK ended up reworking the script quite a bit, so audio (radio) support is now in, if you want to use it then pull down the new image and then add a new 'variable' to your container named 'AUDIO_SHOWS_NAME' to specify the name of the show, and if you want to use the show PID then add variable 'AUDIO_SHOWS_PID' (new users will have these already created).

Works a treat, thanks very much!

Sorry, this might be a stupid question. As I understand your distribution, the script runs a build of get_iplayer on top of an Arch Linux base. What's the benefit of that as a Unraid user compared to other containers?

21 minutes ago, TOMillr-old said:

Sorry, this might be a stupid question. As I understand your distribution, the script runs a build of get_iplayer on top of an Arch Linux base. What's the benefit of that as a Unraid user compared to other containers?

eas and use of management...

in truth a slack ware build script exist to install on slackware linux...

https://git.slackbuilds.org/slackbuilds/plain/multimedia/get_iplayer/get_iplayer.SlackBuild?id=eb85a970b450c5b90741c3455562ad632e5880e6

 

and there are many docker variants out there.

https://github.com/thespad/docker-get_iplayer

https://github.com/Marginal/docker-get_iplayer

https://hub.docker.com/r/barwell/get-iplayer

 

binhex here has borught them to the Unraid CA and maintains them here.

its easier to manage and run dockers on unraid then install direct to the host which can open the unraid system up to CVEs.

17 hours ago, bmartino1 said:

and there are many docker variants out there.

That's why I'm asking. Is there some crucial differences between the different get_iplayer containers I should be aware of?

 

Can I use the binhex version with a DNS proxy inside the container and put the dns information in the compose file?

5 hours ago, TOMillr-old said:

That's why I'm asking. Is there some crucial differences between the different get_iplayer containers I should be aware of?

 

Can I use the binhex version with a DNS proxy inside the container and put the dns information in the compose file?

not really user personal preference if you want to run docker compose, then run docker compose...

CA templates dockers are easier to maintain and update. Compose gives you some extra option not see in unraid template.

 

the template essential helps construct a docker run line... how you run manage and use any docker is on you.

  • 2 months later...

Is there anyway that I can create a txt file (csv file?) of requested shows rather than add them to the SHOWS Variable, at the moment I cannot really see what shows I have already asked to be monitored as only a few characters are visible,

I can always copy and paste into a text editor or spreadsheet then edit and repast but it's not very "elegant"

Nice app though

  • 3 months later...

I've just installed the application - thanks for building it. I prefer to have my downloads go somewhere other than /data/completed and as far as I can tell, this is set in start.sh and changing this get overwritten every time the application is editted. Is there any other way to override this, or is it a case of remembering to edit the shell script as and when I add a new program to download?

  • Author
43 minutes ago, ChrisAmes said:

I've just installed the application - thanks for building it. I prefer to have my downloads go somewhere other than /data/completed and as far as I can tell, this is set in start.sh and changing this get overwritten every time the application is editted. Is there any other way to override this, or is it a case of remembering to edit the shell script as and when I add a new program to download?

i can look into changing this so you can define the path yourself.

19 minutes ago, binhex said:

i can look into changing this so you can define the path yourself.

That would be really helpful, thank you

  • Author
3 hours ago, ChrisAmes said:

That would be really helpful, thank you

This is now done, please pull the latest image and if you want to specify the incomplete and completed folders then create a new 'variable' with 'key' name INCOMPLETE_DOWNLOADS_PATH and COMPLETED_DOWNLOADS_PATH and set the value to the path you want to use.

On 10/24/2025 at 8:25 PM, binhex said:

This is now done, please pull the latest image and if you want to specify the incomplete and completed folders then create a new 'variable' with 'key' name INCOMPLETE_DOWNLOADS_PATH and COMPLETED_DOWNLOADS_PATH and set the value to the path you want to use.

Grabbed the update and working perfectly. Many thanks for the quick update.

Hi all,

I hope you can point me somewhere where I can find help.

I installed the container and I tunnelled it to the UK using NordVPN. When trying to download any content, I get the warning of VPN being blocked.

But it works perfectly if I use the get_iplayer local installation on my laptop. I am careful I use the same server (uk2084.nordvpn.com is the last I tested), to ensure I am accessing the BBC systems using the same public IP.

Am I missing any config? Apologies if this has been answered but I believe it hasn't!

Thank you!

Not sure if anyone else had this issue, but after an update my installation was downloading to '/', not '/data' anymore, even after setting the download and incomplete directories to /data/... . Easily fixed by running docker exec -it binhex-get-iplayer get_iplayer --prefs-add --output=/data

  • Author
16 hours ago, annies said:

Not sure if anyone else had this issue, but after an update my installation was downloading to '/', not '/data' anymore, even after setting the download and incomplete directories to /data/... . Easily fixed by running docker exec -it binhex-get-iplayer get_iplayer --prefs-add --output=/data

thats interesting!, there are fallback defaults which match the previous values if no env var value is given, can you screenshot container/<left click>/edit and post here

  • 2 months later...

I prefer hd over fhd quality and normally set this in the options file, but the quality preferences hardcoded into this container's script always take precedence. Could you expose the quality selection as an environment variable like you have other arguments/parameters?

Ideally the filename output format would be similarly exposed.

Also, not a big deal, but the script variable ATOMIC_PARSELY_FILEPATH contains a misspelling.

Thanks!

  • 1 month later...

Just started using this, working well so far, thank you. Is there a way to embed subtitles in to the file please?

Also, is there a choice between MP4 and mkv? Thanks

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.