Skip to content

ftintitle.rst

Latest commit

 

History

History
63 lines (48 loc) · 2.45 KB

ftintitle.rst

File metadata and controls

63 lines (48 loc) · 2.45 KB

FtInTitle Plugin

The ftintitle plugin automatically moves "featured" artists from the artist field to the title field.

According to MusicBrainz style, featured artists are part of the artist field. That means that, if you tag your music using MusicBrainz, you'll have tracks in your library like "Tellin' Me Things" by the artist "Blakroc feat. RZA". If you prefer to tag this as "Tellin' Me Things feat. RZA" by "Blakroc", then this plugin is for you.

To use the ftintitle plugin, enable it in your configuration (see :ref:`using-plugins`).

Configuration

To configure the plugin, make a ftintitle: section in your configuration file. The available options are:

  • auto: Enable metadata rewriting during import. Default: yes.

  • drop: Remove featured artists entirely instead of adding them to the title field. Default: no.

  • format: Defines the format for the featuring X part of the new title field. In this format the {0} is used to define where the featured artists are placed. Default: feat. {0}

  • keep_in_artist: Keep the featuring X part in the artist field. This can be useful if you still want to be able to search for features in the artist field. Default: no.

  • preserve_album_artist: If the artist and the album artist are the same, skip the ftintitle processing. Default: yes.

  • custom_words: List of additional words that will be treated as a marker for artist features. Default: [].

  • bracket_keywords: Controls where the featuring text is inserted when the title includes bracketed qualifiers such as (Remix) or [Live]. FtInTitle inserts the new text before the first bracket whose contents match any of these keywords. Supply a list of words to fine-tune the behavior or set the list to [] to match any bracket regardless of its contents. Default:

    ["abridged", "acapella", "club", "demo", "edit", "edition", "extended",
 "instrumental", "live", "mix", "radio", "release", "remaster",
 "remastered", "remix", "rmx", "unabridged", "unreleased",
 "version", "vip"]

Running Manually

From the command line, type:

$ beet ftintitle [QUERY]

The query is optional; if it's left off, the transformation will be applied to your entire collection.

Use the -d flag to remove featured artists (equivalent of the drop config option).