If you have ever wanted to save a BBC programme to watch on a train, a flight, or a quiet evening with no connection, you have probably run into the limits of streaming. That is exactly the gap getiplayer fills. The tool behind it, get_iplayer, is a free command-line program that searches BBC iPlayer and BBC Sounds, then records the programmes you choose onto your own computer as ordinary files. You end up with video and audio you can play offline, on your own devices, in your own time. This guide explains what getiplayer is, how it works, and who it suits.
What get_iplayer actually does
At its heart, get_iplayer is a downloader for BBC content. You give it the name of a TV programme or a radio show, and it finds that programme in the BBC catalogue, fetches the stream, and saves it to your hard drive. TV programmes are saved as MP4 video files, and radio programmes are saved as M4A audio files by default. Once a download finishes, the file is yours to keep on that machine and play with whatever media player you already use.
There is no app window and no library screen. Everything happens in a terminal on Windows, Mac, or Linux, where you type short commands and the tool does the rest. That plain design has barely changed in years, because it works. You search, you pick a result, you record it. If you want a little more control, you can filter by channel or category, choose a quality level, grab subtitles, or save a search so the tool records new episodes on its own.
A tool with a long track record
get_iplayer is not some overnight project. It has been doing this job for well over a decade, and it is maintained by a community of volunteers on GitHub, where the code is open source for anyone to read. The current release line is the 3.x series, and the tool gets updated when the BBC changes something behind the scenes that the downloader depends on.
That history matters more than it might sound. BBC feeds and stream formats shift from time to time, and a downloader that nobody maintains usually stops working within a year or two. Because get_iplayer has an active community and a public home, fixes tend to arrive, and the tool prints a warning when your copy is out of date and a newer one is available. Longevity like that is rare in free software, and it is a big reason the getiplayer name keeps coming up whenever people talk about recording iPlayer programmes.
How it works under the hood
You do not need to understand the machinery to use getiplayer, but a quick tour helps everything else on this site make sense. The process has three stages.
- The cache. get_iplayer keeps a local index, a kind of catalogue, of the programmes currently available on iPlayer and Sounds. It builds that index from BBC feeds. When the index gets stale, the tool refreshes it, and you can force an update at any time with the
--refreshoption. - The search. When you type a programme name, the tool matches it against the local index and shows you the results, each with its own index number. You can look closer at any programme with
--longfor longer descriptions or--infofor full details. - The recording. When you download, get_iplayer fetches the programme stream and hands it to ffmpeg, a well known media tool, which assembles the finished MP4 or M4A file. It can also embed the programme thumbnail and metadata into the file with the
--thumboption.
That middle stage explains a lot of everyday behaviour. If a search finds nothing, the programme may have left iPlayer, or your cache may be out of date. If a download finishes but no file appears, ffmpeg is usually the missing piece. The fixes guide linked below walks through those cases one by one.
What you can record with it
The getiplayer tool covers both halves of the BBC’s on-demand world. For television, it searches BBC iPlayer, where you will find drama, comedy, documentaries, films, and children’s programmes from across the BBC channels. For radio, it searches BBC Sounds, which carries shows from the national and local stations, plus music programmes and spoken word series.
You can narrow any search with the --type option, choosing --type=tv or --type=radio, and there are also livetv and liveradio types in the mix. Filters like --channel and --category help when a name matches dozens of programmes. Radio fans get one extra trick: radio downloads are AAC audio in an M4A file by default, and you can switch on --aactomp3 if you would rather have an MP3.
What get_iplayer is not
A few honest boundaries are worth setting early. get_iplayer is not a streaming service, so it cannot give you anything that is not already on iPlayer or Sounds. Programmes sit on those services for a limited window, often around 30 days after broadcast, though it varies, and once a programme expires, no tool can record it. The getiplayer cache only ever lists what is available right now.
It is also not a graphical app. If you dislike typing commands, the first ten minutes will feel unfamiliar, though most people find the basic search and download commands become second nature quickly. And it is not a way around the BBC’s rules: iPlayer is restricted to the UK, UK viewers need a TV licence to use it, and recordings are for personal use under the BBC’s terms.
Who getiplayer suits best
The tool shines for a few kinds of people. Commuters and travellers use it to load up on programmes before a journey with patchy signal. Radio listeners use it to keep favourite Sounds shows as audio files they can play anywhere. Methodical viewers use the built-in PVR feature to record every new episode of a series automatically, so nothing slips away before its iPlayer window closes.
It also suits anyone who simply likes owning their media files in open formats. An MP4 or M4A file plays on almost anything, needs no special app, and will still open years from now. If that sounds like you, the next step is getting the tool installed, which the guide below covers for Windows, Mac, and Linux.
A typical getiplayer session
To make it concrete, here is what using the tool actually looks like on an ordinary evening. You open a terminal and refresh the cache. You search for a series you have been meaning to catch up on, read the results, and spot the episode you want. You run the download with --get, watch the progress for a minute or two, and end with an MP4 sitting in your folder. Later, offline, you play it on the train. That unglamorous little loop is the whole experience, and it is why people stick with getiplayer for years.
Conclusion
get_iplayer is a small, free, community-maintained tool with a single job: turning BBC iPlayer and BBC Sounds streams into files you can keep and play offline. It searches a local programme cache, records through ffmpeg, and saves television as MP4 and radio as M4A. There is no interface to learn beyond a handful of commands, and the tool has kept working for well over a decade because people keep looking after it. If you are in the UK with a TV licence and you want your favourite programmes as proper files, getiplayer is the established way to do it.
Read next: