beets/docs/plugins/replace.rst
2026-03-08 17:27:07 +00:00

25 lines
955 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.
The file you pick will be replaced with the file at ``path``. Then, the new
file's metadata will be synced with the database. This means that the tags in
the database for that track (``title``, ``artist``, etc.) will be written to the
new file, and the ``path`` and ``mtime`` fields in the database will be updated
to match the new file's path and the current modification time.
Consider using the ``replaygain`` command from the :doc:`/plugins/replaygain`
plugin, if you usually use it during imports.