Skip to content
Mike Ralphson edited this page Jun 15, 2021 · 42 revisions

Nitro logo
BBC API Utilities / Open-Nitro project / Open iBL project

Nodejs utilities to extract PID data from the BBC's Nitro, iBL (iPlayer Business Layer) and legacy /programmes feeds, by category, with the benefit of 30-day programme availability.

Includes tools to dump BBC category codes, format codes, masterbrand (channel) ids, linear service ids, partner ids, rebuild the get_iplayer download history from existing files, and to ignore programmes (add them to the get_iplayer download history without actually downloading them) by episode, series or brand PID.

A web interface is also available. The RSS adaptor here aims to replace the official BBC RSS feeds which were discontinued in October 2014.

An 'SDK' is provided to ease Nitro client development. This powers Nitro9, a tool to build an offline database from iPlayer for research purposes.

FAQ

Radio formats and genres Updated 2016-12-20

TV formats and genres

MediaSet values

Channel Identifiers

Nitro Partner Ids Updated 2018-06-17

New! Denton Guidance Codes

New! Version Types

New! Live TV streams

Updated! ImageChef Recipes

iBL categories

Usage: node nitro

  -h, --help              display this help
  -b, --index_base        get_iplayer index base, defaults to 10000
  -c, --channel=ARG       Filter by channel id
  -d, --domain=ARG        Set domain = radio,tv or both
  -f, --format=ARG+       Filter by format id
  -g, --genre=ARG+        Filter by genre id. all to reset
  -i, --imminent          Set availability to pending (default is available)
  -s, --search=ARG        Search metadata. Can use title: or synopses: prefix
  -t, --payment_type=ARG  Set payment_type to free*,bbcstore,uscsvod
  -p, --pid=ARG+          Query by individual pid(s), ignores options above
  -a, --all               Show programme regardless of presence in download_history
  -m, --mediaset          Dump mediaset information, most useful with -p
  -o, --output            output in get_iplayer cache format
  -u, --upcoming          Show programme schedule information not history
Usage: ./populate_download_history.js pathspec

Usage: ./ignore.js [--quick|-q] pid [pid...]