mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 08:39:17 +01:00
aa31fea037
*All* URLs were checked manually, but only once per domain! I mostly concerned myself with URLs in documentation rather than source code because the latter may or may not have impactful changes, while the former should be straight forward. Changes in addition to simply adding an s: - changed pip and pypi references as their location has changed - MPoD (iOS app) url redirects to Regelian, so I replaced those - updated homebrew references Notable observations: - beets.io does have HTTPS set up properly (via gh-pages) - beatport.py uses the old HTTP url for beatport - as does lyrics.py for lyrics.wikia.com - https://tomahawk-player.org/ expired long ago, but the http page redirects to https regardless - none of the sourceforge subdomains have https (in 2019!)
44 lines
1.4 KiB
ReStructuredText
44 lines
1.4 KiB
ReStructuredText
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}``
|
|
|
|
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).
|
|
|
|
.. _MusicBrainz style: https://musicbrainz.org/doc/Style
|