From 74a10266f01eb261adfdc9f3e4bec36e0afce760 Mon Sep 17 00:00:00 2001 From: Eric Masseran Date: Tue, 6 Jan 2026 22:43:08 +0100 Subject: [PATCH] Add documentation and changelog --- docs/changelog.rst | 4 ++++ docs/plugins/embedart.rst | 7 ++++++- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/changelog.rst b/docs/changelog.rst index b9a5c1f3f..1c1d6a2b6 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -31,6 +31,10 @@ New features: no_convert, never_convert_lossy_files, same format, and max_bitrate - :doc:`plugins/titlecase`: Add the `titlecase` plugin to allow users to resolve differences in metadata source styles. +- :doc:`plugins/embedart`: Embedded arts can now be cleared during import with the + ``clearart_on_import`` config option. Also, ``beet clearart`` is only going to + update the files matching the query and with an embedded art, leaving + untouched the files without. Bug fixes: diff --git a/docs/plugins/embedart.rst b/docs/plugins/embedart.rst index abbe2460d..b8de07cc7 100644 --- a/docs/plugins/embedart.rst +++ b/docs/plugins/embedart.rst @@ -70,6 +70,8 @@ file. The available options are: :doc:`FetchArt ` plugin to download art with the purpose of directly embedding it into the file's metadata without an "intermediate" album art file. Default: ``no``. +- **clearart_on_import**: Enable automatic embedded art clearing. Default: ``no``. + Note: ``compare_threshold`` option requires ImageMagick_, and ``maxwidth`` requires either ImageMagick_ or Pillow_. @@ -110,4 +112,7 @@ embedded album art: automatically. - ``beet clearart QUERY``: removes all embedded images from all items matching the query. The command prompts for confirmation before making the change - unless you specify the ``-y`` (``--yes``) option. + unless you specify the ``-y`` (``--yes``) option. The files listed for + confirmation are the ones matching the query independently of having an + embedded art. However, only the files with an embedded art are updated, + leaving untouched the files without.