# get-iplayer/get_iplayer

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

Repository: https://github.com/get-iplayer/get_iplayer
Canonical: https://ross.abutalabs.com/products/get_iplayer
Homepage: https://github.com/get-iplayer/get_iplayer/wiki
Language: Perl
License: GPL-3.0
License Family: copyleft
Last push: 2025-05-04T16:40:47+00:00

## Health v2 (maintenance only)
Score: 31/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 19, release rhythm 8, longevity 100
- inputs: {"age_days": 5654, "days_push": 486, "days_rel": 486, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2538, forks 250 (observed 2026-08-28T04:06:59.237574+00:00)

## What it is
A Perl-based command-line tool that indexes and downloads TV and radio programmes from BBC iPlayer and BBC Sounds. It supports regex search, programme caching, batch downloads, and PVR-style scheduled recording via cron or Task Scheduler.

## Use cases
- download bbc iPlayer programmes to mp4
- download radio programmes from BBC Sounds
- search iPlayer catch-up listings by programme name
- automatically record favourite BBC shows with cron
- download a programme directly from its iPlayer URL or PID
- filter iPlayer search results by channel

## When to choose
- you want to download whole episodes of BBC linear-service programmes from the last 30 days
- you need a scriptable, cross-platform CLI downloader with PVR scheduling
- you want regex search and index caching for iPlayer/Sounds content

## When to avoid
- you need live stream recording from BBC channels
- you want to download news/sport clips, podcasts, box sets, or web-only content via search (some possible only via direct PID/URL)
- you need a GUI-based downloader

## Facets
- artifact type: cli-tool
- maturity: active
- function: web-scraping, cli, video-processing, audio-processing, search-engine
- domain: media, developer-tools
- platform: windows, cli, cross-platform
- tags: bbc-iplayer, bbc-sounds, downloader, pvr, perl, catch-up-tv, radio, ffmpeg, command-line, automation, linux, macos

## Member repositories
- get-iplayer/get_iplayer (main) score 31

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:59.237574+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:25:11.420829+00:00, confidence not recorded.
  - readme: https://github.com/get-iplayer/get_iplayer (fetched 2026-08-28T04:06:59.237574+00:00, sha 60f53287d1a7)
  - homepage: https://github.com/get-iplayer/get_iplayer/wiki (fetched 2026-08-29T10:07:14.295293+00:00, sha b54d0523149b)
- Data as of 2026-08-30T08:39:29.467469+00:00.