Tag downloaded files using Mutagen

Add tags to MP3/MP4/OGG files after download.

By default, this extension will:

Remove existing tags
Write the Title tag, stripping the album from the beginning of the Title if necessary
Write the Album tag
Write the Artist tag (with the same string as the Album tag)
Write the Genre (to “Podcast”, configurable)
Write the publish date

Also available are writing the Subtitle tag and the Comments tag (both with the subtitle field), but the subtitle is often so long that it may cause problems with certain audio players, such as Rockbox players. These are disabled by default.

This extension can optionally embed coverart - art can either be the channel artwork or episode-specific artwork already embedded in the file. By default, the episode artwork will be preferred if it is present - if not, the channel artwork will be used.

Note that episode-specific artwork in MP4 files is currently not implemented.

The artwork can optionally be normalized to the desired size and file type. By default, it will write Baseline (Non-Progressive) JPEGs with the larger side scaled to 500px and the aspect ratio maintained.

This extension can optionally remove all tags instead of doing any of the above. This is disabled by default.

Dependencies

This extension requires python modules mutagen and pillow.

setting	value	description	version
extensions.tagging.strip_album_from_title	True/False	Remove the Album tag from the Title tag if the Title begins with the same string as the Album tag	all
extensions.tagging.genre_tag	Podcast	Value for the Genre tag	all
extensions.tagging.always_remove_tags	True/False	Remove all tags instead of creating/adding tag information	3.5.0 and newer
extensions.tagging.set_artist_to_album	True/False	Set the Artist tag to the same as the existing Album tag	3.9.3 and newer
extensions.tagging.set_version	4	Sets the id3 version which will be written	3.10.8 and newer
extensions.tagging.modify_tags	True/False	Allow tags to be modified rather than simply added. If set to False, remove_before_modify has no effect	3.10.8 and newer
extensions.tagging.remove_before_modify	True/False	Delete all existing tags prior to writing new tags	3.11.1 and newer
extensions.tagging.auto_embed_coverart	True/False	Embed cover art in file	3.9.4 and newer
extensions.tagging.prefer_channel_coverart	True/False	Prefer embedding the channel coverart if available over the episode coverart	newer than 3.11.5
extensions.tagging.normalize_coverart	True/False	Normalize the coverart to the desired size and file type before embedding it	newer than 3.11.5
extensions.tagging.episode_coverart_size	500	Desired size (in pixels) of coverart. Only used if normalize_coverart is True	newer than 3.11.5
extensions.tagging.episode_coverart_filetype	0 (JPEG)	Desired filetype of coverart. integer value, maps to 0=JPEG, 1=PNG. Only used if normalize_coverart is True	newer than 3.11.5
extensions.tagging.write_title	True/False	Write the title field	newer than 3.11.5
extensions.tagging.write_album	True/False	Write the album field	newer than 3.11.5
extensions.tagging.write_subtitle	True/False	Write the subtitle field	newer than 3.11.5
extensions.tagging.write_comments	True/False	Write the comments field (with the subtitle)	newer than 3.11.5
extensions.tagging.write_genre	True/False	Write the genre with the genre_tag setting	newer than 3.11.5
extensions.tagging.write_pubdate	True/False	Write the published date	newer than 3.11.5

Links:

Extension Source