get_iplayer

get-iplayer

A utility for downloading TV and radio programmes from BBC iPlayer.

Runs as get_iplayer|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 8 fields

Search the programme index, or record by index number. Unlisted options such as proxies, output directories and PVR presets are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui get-iplayer

Search or record BBC programmesExample values, fixed in this page — nothing here reaches a terminal

Basic

Search terms or index numbers*

string

Programme type

string

Channel

string

Long descriptions

--long

TasksEach one presets the form for one job

Search programmes

termstypechannellong

Record by index

termsgettv_qualitysubtitles

ParametersOnly these flags are editable in the form

Programme type

Comma-separated types, for example tv,radio. TV is the default.
string

--typetvradiotv,radio

Channel

string

--channel

Long descriptions

boolean

--long

Record the listed index numbers

Put the index numbers from a previous search in the terms field.
boolean

--get

Download subtitles

boolean

--subtitles

TV quality order

string

--tv-qualityhd,sd,web,mobileweb

Programme ID

string

--pid

Search terms or index numbers

Regular expression, such as .* for everything, or index numbers when recording.
string · positional 0 · repeatable

SourcesEvery flag above is checked against these

readme

get_iplayer --long ".*" get_iplayer --type=radio ".*" get_iplayer --type tv,radio "doctor who" get_iplayer --channel="BBC One" ".*" get_iplayer --get 208 --tv-quality=hd,sd,web,mobile get_iplayer --get 208 --subtitles get_iplayer --pid=b01sc0wf

help2026-10-27

github.com

Before it fills your prompt, Otty checks the installed get_iplayer against its version. A form that does not match your version is not offered.