How to download BBC iPlayer videos and radio programmes

Abstract (Italiano): Scrivo questo articolo in inglese perché (ovviamente) la registrazione dei video della BBC interessa maggiormente le persone che parlano inglese. Se lasciate un commento, gentilmente fatelo in inglese.

Abstract (English): I’m writing this post in English because (obviously) recording BBC videos is mostly of interest for those who speak English. Also, a small note for native speakers, especially British people: I’m Italian and I’m mostly used to write using American spelling. For this reason, the post may contain mistakes or American words which may seem unusual. I’m sorry for that. If you find errors (apart from AE spelling) let me know in the comments.

Update (30 April 2017): Version 4.0 of the script is out, which is mostly rewritten from scratch and leverages youtube-dl instead of ffmpeg. I’ve updated this post accordingly.


I already wrote about downloading videos from the BBC and Hulu websites (in Italian), however it was about two years ago. Websites change and so does software, hence the suggested method of using get_flash_videos does not work anymore.

I also wrote a generic article about downloading videos from websites (in Italian, too) that contains many different use cases and examples. One of my readers asked for clarification about recording iPlayer videos, so I tried again myself. I was able to apply some of the techniques of my post, together with a couple of clever tricks to find the maximum quality.

Since the process is a bit involved, I wrote a small software which automates all the steps and tells you how to start the recording immediately. This program is actually a so called user script, i.e. a piece of software that runs directly into your browser.

This article explains how to download and install the script. Then it shows you how to use it and what you need to do to record BBC iPlayer videos. Before we start, you need to be able to trick the BBC website into thinking you are living in the UK. If you are actually living there, skip the next section.

Pretending to be in the UK

The BBC iPlayer service is officially available only in the United Kingdom. The website will check your IP address and refuse access if you are trying to watch content from another country. To fix this problem, you need to use a technique to access the site through a server in the UK.

Usually the best tool for the job is a VPN service. VPNs are used to establish secure connections to private networks over the Internet, but may also be used to avoid geographical restrictions of websites.

There are many different VPN services. Most of them are paid (although cheap), while some are free. Among the best options, you can:

  • use VPNGate by choosing a node in the UK
  • use CyberGhost with free UK servers
  • use VPNOneClick
  • get a cheap lifetime deal for a professional VPN, such as:

Please keep in mind that recently the BBC has started being more aggressive at blocking VPN providers. Always verify if your VPN provider works with the BBC (most of them have free trials available).

Luckily, I also wrote a Python script for easily using VPNGate by specifying only the desired country which works perfectly on any Linux distribution, including Ubuntu, Mint, Fedora, OpenSuse and Mageia. You can check it out here.

You may also try VPN OneClick, which lists UK among the servers. Regardless of what VPN service you choose, once it is activated, you are ready to go on and start recording videos from iPlayer.

Script installation

To run the user script in your browser, you need to install an extension that is compatible with Greasemonkey (version 3) scripts. The following are recommended:

Currently the script does not work with Greasemonkey 4 on Firefox 57 or later. Please do not use Greasemonkey 4.

After this step, you can click the following link to open the script page on Greasyfork. On the page that shows up, click on the Install this script button to complete the procedure.

BBC iPlayer video download

You are now ready to start downloading.

Recording videos

The next time you open a video page on iPlayer, you’ll see that the script adds a box under it with some instructions and a command line. The following pictures shows an example with this video.

Example of the output of the script

The command line displayed in the gray box is a one-liner you can use together with youtube-dl. This is a software used to convert and record video files, which can be installed on any of the common Linux distributions such as Ubuntu. More informations are available on the official website.

Despite its name, it does not work only for YouTube, it works for many other websites as well. My script uses it because it can download DASH streams served through a MPD file easily. The program can download some BBC videos without the need of my script, however the latter:

  • works on many pages where youtube-dl doesn’t recognize the stream URL
  • provides you with converted SRT subtitles on the fly, thanks to its internal converter

Remember that you will still need ffmpeg installed on your system. Check out its official website here.

To start the download:

  • carefully copy the entire content of the gray box (and nothing else)
  • paste it into a terminal window
  • press Enter and wait until the process is over

Keep in mind that this will create a lot of temporary files, but they will get removed automatically at the end.

It is also possible to download the videos on Windows or macOS. On Windows you just need to create a new file called download.bat (with Notepad, or any other editor) in the same directory of youtube-dl.exe and copy-paste the command line into it. After that, you click the bat file and it should start downloading.

However, please note that I do not offer any assistance for Windows or macOS here on the blog. If in doubt, please use Linux, or find an expert to help you with your OS. You can find the installation instructions of youtube-dl by clicking here.

Recording radio programmes

Starting from version 3.2, the script supports radio programmes such as those provided by BBC School Radio. The process is exactly the same as recording a video, including the command line. The files are in M4A format as provided by the BBC (no conversion is performed).


The script I developed allows to automate all the necessary steps required to ensure the highest possible quality during the downloading. In particular, the script does the following:

  • find the configuration of the player for mobile phones
  • get the list of DASH manifests for different bitrates
  • look for the best available bitrate for desktop computers
  • show the command line to the user

Performing the process manually is time consuming, error-prone and tedious if done multiple times. In this way it should be much easier for those who just want to record a couple of videos to watch them with a modern TV, on the train or keep them in a personal library.

Moreover, starting from version 3.0 the script shows you a download link to the original subtitles in TTML format (which is not very widespread). In addition, it performs an automatic conversion to the commonly used SRT format for your convenience.

Happy downloading! 🙂

Did you like the article?

Writing software and tutorials like this takes time. If you found the provided information useful, and you liked the post, you may buy me a coffee by clicking on the button. 🙂 If you do so, please leave a message on the donation page telling me it’s for this script.


190 pensieri su “How to download BBC iPlayer videos and radio programmes

  1. Rocky Dennis, please can you check the latest version of the script? It fixes some issues on radio programmes.

    a2006, you cannot download from abroad. Fix your IP address first.

  2. Hello Andrea, thank you so much for your wonderful script. Can you help me please? I have two problems:
    First with the radio, I am having issues with the format. I have no problems downloading but they show as text file on my mac. Which is not a problem because I change by adding “.m4a” and then the system recognises them as music file. However iTunes refuses the play it. In fact only VLC seems to be able to play the file regardless of the suffix. Actually even VLC struggles a little because unlike an ordinary file there’s always a short wait before playing the file or when I skip back or forward

    My other issue is with the videos. With the previous version I could simultaneously downloaded many episodes of the same show. Now I cannot anymore because I receive the file as simply “name of the show”, without the episode name like before. I’m not sure it makes sense. Is this normal? I now have to download files one by one because otherwise the cancel each other. Well I think that’s what it’s doing. I hope it makes sense. I’m sorry I’m not very technical.

    I’m so sorry, I hope this message makes sense. I hope you can help. Thank you so much for what you do! ❤

  3. Hi Iris. I try to answer you so maybe I save Andrea some time 🙂

    Regarding the audio files, I just downloaded one and seen the format is mpeg-4 audio. I tried to add different extensions and the one that seemed to work best and be more compatible is mp4. That way both VLC and iTunes read it with no issues.

    When downloading the video files the only thing you need to do to avoid them overwriting each other is to change the name at the end of the script link, when you paste it into the terminal. The very last bit will name your file, just change it with numbers or something to identify the file. Remember that the name cannot contain spaces so you need to use underscore _ or other symbols to separate the words.

    Hope this is helpful, let me know
    And thank you Andrea for your great work!

  4. Iris, please check Matteo’s answer as well because it is very well written (thank you, Matteo!).

    Regarding the extension, can you provide a URL so I can try with the same episodes as you are saving? The name of audio and video files is made from a “title” piece of metadata embedded on the content itself. There might be some way to get it a bit more precise, but again can you provide a URL? 🙂

  5. Hi Andrea, I’ve been using some of your scripts for quite some time and I thank you very much. I’m currently struggling with iplayer: I have successfully used VPNsecure from Italy to pretend to be in the UK, however, recently the iplayer website is no longer showing the scripts and it shows that I am not in the UK, but websites like they see me in the UK. Is there anything I can do to fix this? Thanks againg for you great work.

  6. The BBC constantly tries to detect VPN users. You should reach out to VPNSecure regarding the issue. Given that they also include SmartDNS in the package, they should be able to help you check that your SmartDNS configuration is correct.

  7. From yesterday, the subtitle is not displaying under the code box any more. how it can be fixed soon, thanks.

  8. Maurizio, here’s an official response from the customer service at VPNSecure:

    Unfortunately, we’re currently facing issues with iPlayer. It seems they have blocked our IP’s.

    Hopefully we will have this resolved during next week.

    Imnew, currently I cannot test the BBC website.

  9. Hi Imnew. I’m in UK and I use Andrea’s script. I just tried it on a random page and everything is working fine for me. Can you send me the URL of the video you’re trying to download so I can have a look at it?

  10. I am in the UK and have just downloaded a iplayer program. All went well with downloading the video and the audio files but then a very short .temp.MP4 file was generated followed by an error message saying “headers could not be generated” and “codec error”. I have ffmpeg loaded but do I have something else missing. Ubuntu 16.04 LTS

  11. Great Script – thanks so much!
    I’ve had a problem this week with the “To download this video, press Play and skip the trailer.” thing. there is no trailer to skip, just the 2-3 second BBC logo or swans etc. If there is a trailer then it works fine…..Any ideas, or am I missing something?

  12. ChrisC, sorry but your comment ended up in the spam queue. Could you provide the URL of the problematic video? Thank you.

  13. Hello Lazza,
    Have you managed to fix the issue with the “To download this video, press Play and skip the trailer.”?

  14. The BBC iPlayer website now requires you to login to view a video so the script no longer works. The frame where the script is supposed to display a command now just shows the words ‘To download this undefined, press Play and skip the trailer’.

  15. I have published version 4.1.

    Here’s an excerpt of a reply I left in the relevant thread on GreasyFork:

    Videos with a trailer should be working after logging in. Those without a trailer should be working even without login.

    Note: I am now providing a plain youtube-dl command line for iPlayer episodes. Nowadays the support for BBC iPlayer by said tool is pretty good, rendering my script a bit less useful and maybe obsolete.

    The script continues to work as a neat subtitle converter and it should work on some pages where youtube-dl can’t really provide a solution. However, nowadays the needs of most people should be covered by youtube-dl directly.

  16. Your version 4.1 has solved the issue of “play and skip the trailer”.
    Great job
    Bunch of thanks

  17. Hello, I’m in Italy and after installing the script 4.1 it seems not work. Warning message appear: “BBC iPlayer only works in the UK”. Does the script still work or I’m wrong?
    Thank you!

  18. It works but, as clearly stated in the article, it is up to you to use appropriate measure to ensure the BBC website thinks you are in the UK.

  19. Thanks for reply. So I need to use a VPN? What’s changed about the previous version ‘cause I downloaded many progmammes without using a VPN? Keep up your good work!

  20. Yes. 🙂

    Not much changed, there have always been only a small amount of videos that were accessible outside the UK.

  21. Well, the script no longer appears in firefox and in chrome for me. The player shows the message “the content cannot be played, etc.” So I changed my IP to … Singapore (strange!). The player started to work, but the script is gone. Any suggestions? Thanks!

  22. I am not sure I understand. You switched to a VPN node in Singapore and the videos started playing? Is the script installed and active?

  23. Seems that the script no longer works with FF since v56.0. In FF 57.0 (64-Bit) I even can’t install the script. As FF has changed a lot of things – may be the script must be changed too?
    It works fine until FF 55.0.3 (32-Bit) and it works in Chrome (Version 62.0.3202.94 64-Bit)
    Anyway – thanx a lot again for your work!!!

  24. Very good, thanks. I have updated my post to reflect what I already wrote for my other scripts (related to Italian TVs).

  25. The script works, despite a minor bug with the “quality level” dropdown. However, your IP address is not in the UK. This is something you would have to fix for yourself.

  26. Thank you Lazza. The window with the script disappeared, and I was surprised. I does work.

  27. Hello Lazza, Thank you so much for your script. It’s the only way I’ve been able to download BBC iPlayer Radio programmes. Recently, they have started using a differently formatted player page, on which the script does not seem to work. If you can find the time could you take a look and see if it’s possible to fix? I would be incredilby grateful. Many thanks! Example URL for new format:

  28. It should be working now. Please keep in mind that the script is becoming less relevant as youtube-dl supports more and more BBC sections, so you could also use it directly. 🙂

  29. Hello, Lazza,

    Thank you again for your script!

    However I find that sometimes it doesn’t require a UK’s IP to download a video. For example:
    That’s video plays fine with my russian IP, however your script didn’t show me download link. So I had to write it myself, like:

    youtube-dl -f bestvideo+bestaudio "" -o Interview

    It’s downloaded the audio and video separately, but this is not a big problem.

    So, maybe you can change your script to sometimes it show links from any country when it is available?


  30. It would’ve been easier to just feed youtube-dl with the page URL rather than the M3U8 stream itself. Currently the program supports almost all BBC videos so the purpose of my script is greatly reduced.

    At the moment I do not plan to perform additional modifications.

    Regarding the separation of video and audio, it’s probably something to do with your installation of ffmpeg. You should check that everything is correct.

  31. Hello Lazza!

    Maybe I’m wrong but seems that BBC has replaced iPlayer service with BBC Sounds!!
    I cannot see the downlading code anymore. Can you should check by yourself?

    Thank you!

    Here’s the announce:

    Ok here’s an example. I want to download this:

    The iPlayer icon has been replaced by “Listen Now” button. Clicking on it you’ll be redirected to the new BBC Sounds page for the audio streaming. No downloading code appear!!
    Pasted the direct link into yt-dl windows gui it returned me Error 😦

    By the way your script works well with the old iPlayer, like the video example:

    Thanks for looking into this.

  32. This is a script for downloading from iPlayer, moreover it was made in times when trying to save those programmes was quite hard and there was no easy way. Considering the fact that nowadays almost everything (including that new BBC Sounds section) is downloadable using youtube-dl, I do not plan to add new features or to support new sections.

Lascia un commento

Inserisci i tuoi dati qui sotto o clicca su un'icona per effettuare l'accesso:

Logo di

Stai commentando usando il tuo account Chiudi sessione /  Modifica )

Google photo

Stai commentando usando il tuo account Google. Chiudi sessione /  Modifica )

Foto Twitter

Stai commentando usando il tuo account Twitter. Chiudi sessione /  Modifica )

Foto di Facebook

Stai commentando usando il tuo account Facebook. Chiudi sessione /  Modifica )

Connessione a %s...

Questo sito utilizza Akismet per ridurre lo spam. Scopri come vengono elaborati i dati derivati dai commenti.