tagging

get_iplayer Metadata Tagging

Usage

Options

Command Line	Option File	Description
--no-artwork	noartwork (0/1)	Do not embed thumbnail image in output file. All other metadata values will be written.
--no-tag	notag (0/1)	Do not tag downloaded programmes
--tag-cnid	tag_cnid (0/1)	Use AtomicParsley --cnID option (if supported) to add catalog ID used for combining HD and SD versions in iTunes
--tag-fulltitle	tag_fulltitle (0/1)	Use complete title (including series) instead of shorter episode title
--tag-hdvideo	tag_hdvideo (0/1)	AtomicParsley accepts --hdvideo option for HD video flag
--tag-id3sync	tag_id3sync (0/1)	Save ID3 tags for MP3 files in synchronised form. Provides workaround for corruption of thumbnail images in Windows. Has no effect unless using MP3::Tag Perl module.
--tag-isodate	tag_isodate (0/1)	Use ISO8601 dates (YYYY-MM-DD) in album/show names and track title
--tag-longdesc	tag_longdesc (0/1)	AtomicParsley accepts --longdesc option for long description text
--tag-longdescription	tag_longdescription (0/1)	AtomicParsley accepts --longDescription option for long description text
--tag-longepisode	tag_longepisode (0/1)	Use <episode> instead of for track title
--tag-longtitle	tag_longtitle (0/1)	Prepend <series> (if available) to track title. Ignored with --tag-fulltitle.
--tag-podcast	tag_podcast (0/1)	Tag downloaded radio and tv programmes as iTunes podcasts
--tag-podcast-radio	tag_podcast_radio (0/1)	Tag only downloaded radio programmes as iTunes podcasts
--tag-podcast-tv	tag_podcast_tv (0/1)	Tag only downloaded tv programmes as iTunes podcasts
--tag-shortname	tag_shortname (0/1)	Use <nameshort> instead of <name> for album/show title
--tag-utf8	tag_utf8 (0/1)	AtomicParsley accepts UTF-8 input

AtomicParsley Variants

The options related to AtomicParsley are provided to support variations in different versions that emerged after primary development ceased at version 0.9.0.

Content Encoding

The get_iplayer metadata is assumed to be encoded as UTF-8 and is then re-encoded as necessary for the different tagging applications. This doesn't always hold true, so substitution characters may sometimes appear in the tags, particularly lyrics or longDescription.

Tag Scheme

The table below describes the scheme used to convert get_iplayer metadata into tags for downloaded programmes. The tag names were selected to match AtomicParsley parameter names. Each tag is mapped, where possible, to the corresponding get_iplayer substitution parameter, AtomicParsley arg, MP4 atom, id3v2 param, and ID3 frame. The list of iTunes fields indicate where each tag will appear in the iTunes Get Info dialog. Conversion rules specific to particular fields are indicated in the footnotes. If you wish to experiment with variations, the conversion of get_iplayer metadata to tag values is encapsulated in the Tagger::tags_from_metadata subroutine.

Tag Name	Substitution Param1	AtomicParsley arg	MP4 atom	id3v2 Param	ID3 Frame	iTunes Field
stik2	<ext>	--stik	stik			Options:Media Kind
advisory3	<guidance>	--advisory	rtng			Summary:Advisory
copyright4	<dldate>	--copyright	cprt	--TCOP	TCOP	Summary:Copyright
title	<episode>5	--title	©nam	--TIT2	TIT2	Info:Name
artist	<channel>	--artist	©ART	--TPE1	TPE1	Info:Artist
albumArtist	BBC <type>6	--albumArtist	aART	--TPE2	TPE2	Info:Album Artist
album	<name>	--album	©alb	--TALB	TALB	Info:Album
grouping	<categories>	--grouping	©grp	--TIT1	TIT1	Info:Grouping
composer	BBC iPlayer	--composer	©wrt	--TCOM	TCOM	Info:Composer
comment	<descshort>	--comment	©cmt	--COMM	COMM	Info:Comments
genre7	<categories>	--genre	©gen	--TCON	TCON	Info:Genre
year	<firstbcast>8	--year	©day	--TYER	TYER	Info:Year
tracknum	<episodenum>	--tracknum	trkn	--TRCK	TRCK	Info:Track Number
disk	<seriesnum>	--disk	disk	--TPOS	TPOS	Info:Disc Number
lyrics	<desc>9	--lyrics	©lyr	--USLT	USLT	Lyrics
description	<descshort>	--description	desc		TIT315	Video:Description
longDescription	<desc>	--longdesc10 OR --longDescription11	ldes		TDES15	(Hidden):Long Description
hdvideo12	<mode>	--hdvideo13	hdvd			(Browser):HD Icon
TVShowName	<name>	--TVShowName	tvsh			Video:Show
TVEpisode	<senum>14	--TVEpisode	tven			Video:Episode ID
TVSeasonNum	<seriesnum>	--TVSeasonNum	tvsh			Video:Season Number
TVEpisodeNum	<episodenum>	--TVEpisodeNum	tves			Video:Episode Number
TVNetwork	<channel>	--TVNetwork	tvnn			(Hidden):TV Network
artwork	<thumbfile>	--artwork	covr		APIC	Artwork
podcastFlag15	true	--podcastFlag	pcst		PCST	Options:Media Kind
category15	<categories>16	--category	catg		TCAT	(Hidden):Podcast Category
keyword15	<categories>	--keyword	keyw		TKWD	(Hidden):Podcast Keywords
podcastGUID15	<player>	--podcastGUID	egid		TGID	(Hidden):Podcast GUID
				--TDAT	TDAT17
				--TIME	TIME17
					TDRL18

1. Full list of substitution parameters may be found here.
2. TV Show if MP4/M4V, Movie if MP4/M4V and <categories> contains "Film", Normal otherwise
3. explicit if <guidance> non-empty, remove otherwise
4. Year taken from <dldate>, e.g.: (C) 2011 British Broadcasting Corporation, all rights reserved
5. <title> used if --tag-fulltitle given
6. BBC TV, BBC Radio, BBC Podcast
7. First item in <categories> used unless it is one of: ("Films", "Sign Zone", "Audio Described", "Northern Ireland", "Scotland", "Wales", "England"), in which case second item is used. If <categories> is empty, set to get_iplayer
8. If <firstbcast> is not valid date, current date is used
9. <player> and <web> appended if present
10. --tag-longdesc required for compatible AtomicParsley version
11. --tag-longdescription required for compatible AtomicParsley version
12. true if <mode> contains "hd", false otherwise
13. --tag-hdvideo required for compatible AtomicParsley version
14. If <senum> empty, <pid> is used
15. --tag-podcast required if <type> != "podcast"
16. Uses same rules as genre [6]
17. Used with TYER to record full date
18. Podcast release date for iTunes