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.


Guardare e scaricare video da Hulu o da BBC iPlayer anche dall’Italia

Aggiornamento 20/02/2015: le seguenti istruzioni scritte nel 2012 funzionavano anche per BBC iPlayer, cioè il sito principale di video on-demand della più importante emittente britannica. Col passare del tempo quanto scritto qui non è più valido, ma potete leggere il mio nuovo articolo su come scaricare i video da BBC iPlayer. Per quanto riguarda Hulu, al momento sembra che non ci siano aggiornamenti.

Hulu è un sito web molto famoso negli USA con il quale si possono vedere numerosi video di film e serie televisive di network come NBC, Fox e altri. Se volete alcuni esempi: The Simpsons, Law & order, Grey’s Anatomy, Fringe, Bones, ovviamente tutti in inglese e quasi tutti gratuitamente.

Il sito effettua delle restrizioni sugli accessi, ma di recente si è diffuso un metodo pratico per evitare questo tipo di problema. Inoltre oggi ho personalmente sperimentato come usare la stessa soluzione, originariamente pensata per un browser, anche per il download dei video.

Innanzitutto vediamo come vedere i video di Hulu senza essere negli Stati Uniti. Avrete bisogno di Firefox oppure Chrome e vi basterà installare l’estensione Media Hint. Si tratta di un piccolo componente aggiuntivo che usa un proxy per “illudere” Hulu (e alcuni altri siti, come Pandora) che ci troviamo negli USA, anche se non è vero.

Una piccola nota: dato che questa estensione crea alcuni problemi con Firefox Sync, vi consiglio di attivarla e disattivarla a seconda delle necessità, considerando anche il fatto che non occorre neppure riavviare il browser.ho

A questo punto vi spiego come scaricare i video da Hulu. Dopo aver fatto diversi tentativi (ci ho perso ore a verificare che Tor dava più problemi che altro, ad esempio) ho pensato che la cosa migliore è quella di riutilizzare il proxy di Media Hint e farne uso con un programma — rigorosamente open source — per scaricare da Hulu.

Il software in questione è get-flash-videos. Anche se funziona pure su Windows e Mac OS X, le istruzioni che vi do sono per Linux. Adattatele voi per le vostre esigenze e il vostro sistema operativo. Intanto ecco come installare i pacchetti necessari su Ubuntu e derivate:

sudo apt-get install get-flash-videos rtmpdump libdigest-hmac-perl libpacparser1

Il primo pacchetto è quello del programma vero e proprio, l’ultimo pacchetto serve invece per analizzare il proxy di MediaHint, gli altri servono per fare da supporto al plugin per Hulu, che si installa così:

get_flash_videos --add-plugin

Questo termina il processo di installazione. Chi si trova negli USA non deve fare altro e può iniziare a usare il programma, per tutti gli altri bisogna prima impostare il proxy, e dopo richiamare il software, per esempio così:

wget -q -N -O /tmp/default.pac ""
PRO="`pactester -p /tmp/default.pac -u | cut -d ' ' -f 2`"
export ALL_PROXY="http://${PRO}"
export all_proxy="$ALL_PROXY"
export http_proxy="$ALL_PROXY"

I primi comandi prendono l’indirizzo del proxy di Media Hint, poi i successivi lo impostano e l’ultimo avvia il download del video.

Se desiderate fare “un passo in più” vi potete salvare uno script con i comandi, se volete potete copiare quello che mi sono fatto io.

Maggiori informazioni sull’uso del software le potete trovare nella documentazione ufficiale. Buon download!

Aggiornamento 13/06/2013: ho cambiato le istruzioni, ora con un vero parser di file PAC non dovrebbero più esserci problemi legati al fatto che MediaHint cambia spesso i proxy!