beets/docs/plugins/replace.rst
Uncorrupt3318 dd2f203090
Feat: Add replace plugin (#5644)
Adds replace plugin. The plugin allows the user to replace the audio
file of a song, while keeping the tags and file name.

Some music servers keep track of favourite songs via paths and tags. Now
there won't be a need to 'refavourite'. Plus, this skips the
import/merge steps.
2025-05-27 00:17:52 +02:00

17 lines
570 B
ReStructuredText

Replace Plugin
==============
The ``replace`` plugin provides a command that replaces the audio file
of a track, while keeping the name and tags intact. It should save
some time when you get the wrong version of a song.
Enable the ``replace`` plugin in your configuration (see :ref:`using-plugins`)
and then type::
$ beet replace <query> <path>
The plugin will show you a list of files for you to pick from, and then
ask for confirmation.
Consider using the `replaygain` command from the
:doc:`/plugins/replaygain` plugin, if you usually use it during imports.