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 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"]
```

Path Template Values#

This plugin provides the album_artist_no_feat template value that you can use in your Path Format Configuration in paths.default. Any custom_words in the configuration are taken into account.

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).