diff --git a/docs/changelog.rst b/docs/changelog.rst index fda8588a86..28bf129906 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -30,6 +30,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :ref:`import-cmd`: Fix duplicate album merge during import when running in threaded mode. The merge action no longer creates a duplicate folder or reports ``could not get filesize`` errors. :bug:`6601` @@ -123,6 +125,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :ref:`import-cmd`: Multi-disc album detection now recognizes ``cassette``, ``digital media``, and ``vinyl`` as disc markers (e.g. ``vinyl 1``, ``12 vinyl 2``), in addition to the existing ``disc``, ``disk``, and ``cd`` markers. @@ -201,6 +205,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :ref:`import-cmd` Automatically remux WAV files containing MP3 streams (``WAVE_FORMAT_MPEGLAYER3``) to proper MP3 files during import, instead of silently importing them with incorrect metadata. :bug:`6455` @@ -276,6 +282,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/deezer`: Fix Various Artists albums being tagged with a localized string instead of the configured ``va_name``. Detection now uses Deezer's artist ID rather than the artist name string. :bug:`4956` @@ -350,6 +358,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/missing`: Fix ``--album`` mode incorrectly reporting albums already in the library as missing. The comparison now correctly uses ``mb_releasegroupid``. @@ -421,6 +431,8 @@ Other changes Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - Tests that depend on the optional ``langdetect`` package are now skipped when the package is not installed. :bug:`6421` @@ -467,6 +479,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/ftintitle`: Fix handling of multiple featured artists with ampersand. - :doc:`plugins/zero`: When the ``omit_single_disc`` option is set, @@ -522,6 +536,8 @@ Other changes Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/musicbrainz`: Fix crash when release mediums lack the ``tracks`` key. :bug:`6302` - :doc:`plugins/musicbrainz`: Fix search terms escaping. :bug:`6347` @@ -549,6 +565,8 @@ Other changes Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - Make ``packaging`` a required dependency. :bug:`6332` 2.6.0 (February 01, 2026) @@ -606,6 +624,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`/plugins/lastgenre`: Canonicalize genres when ``force`` and ``keep_existing`` are ``on``, yet no genre info on lastfm could be found. :bug:`6303` @@ -724,6 +744,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - |BeetsPlugin|: load the last plugin class defined in the plugin namespace. :bug:`6093` @@ -775,6 +797,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/musicbrainz` Refresh flexible MusicBrainz metadata on reimport so format changes are applied. :bug:`6036` - :doc:`plugins/spotify` Ensure ``spotifysync`` keeps popularity, ISRC, and @@ -874,6 +898,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/musicbrainz`: fix regression where user configured :conf:`plugins.musicbrainz:extra_tags` have been read incorrectly. :bug:`5788` - tests: Fix library tests failing on Windows when run from outside ``D:/``. @@ -992,6 +1018,8 @@ Other changes Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`/reference/pathformat`: Fixed a regression where path legalization incorrectly removed parts of user-configured path formats that followed a dot (**.**). :bug:`5771` @@ -1027,6 +1055,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/thumbnails`: Fix API call to GIO on big endian architectures (like s390x) in thumbnails plugin. :bug:`5708` - :doc:`plugins/listenbrainz`: Fix rST formatting for URLs of Listenbrainz API @@ -1109,6 +1139,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - Check if running python from the Microsoft Store and provide feedback to install from python.org. :bug:`5467` - Fix bug where matcher doesn't consider medium number when importing. This @@ -1150,6 +1182,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`plugins/ftintitle`: The detection of a "feat. X" part in a song title does not produce any false positives caused by words like "and" or "with" anymore. :bug:`5441` @@ -1374,6 +1408,8 @@ New features Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - Improve ListenBrainz error handling. :bug:`5459` - :doc:`/plugins/deezer`: Improve requests error handling. - :doc:`/plugins/lastimport`: Improve error handling in the ``process_tracks`` @@ -1592,6 +1628,8 @@ Other new things Bug fixes ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - :doc:`/plugins/lyrics`: Fix a crash when Beautiful Soup is not installed. :bug:`4027` - :doc:`/plugins/discogs`: Support a new Discogs URL format for IDs. :bug:`4080` @@ -4159,6 +4197,8 @@ dependency, the requests_ module. New stuff ~~~~~~~~~ +- Remove deprecated :doc:`plugins/acousticbrainz`, :doc:`plugins/absubmit`, and :doc:`plugins/beatport` plugin documentation. The AcousticBrainz service has been permanently shut down. :bug:`5780` + - Added a :ref:`config-cmd` command to manage your configuration. It can show you what you currently have in your config file, point you at where the file should be, or launch your text editor to let you modify the file. Thanks to diff --git a/docs/plugins/absubmit.rst b/docs/plugins/absubmit.rst deleted file mode 100644 index 894deb4437..0000000000 --- a/docs/plugins/absubmit.rst +++ /dev/null @@ -1,80 +0,0 @@ -AcousticBrainz Submit Plugin -============================ - -The ``absubmit`` plugin lets you submit acoustic analysis results to an -AcousticBrainz_ server. This plugin is now deprecated since the AcousicBrainz -project has been shut down. - -As an alternative the beets-xtractor_ plugin can be used. - -Warning -------- - -The AcousticBrainz project has shut down. To use this plugin you must set the -``base_url`` configuration option to a server offering the AcousticBrainz API. - -Installation ------------- - -The ``absubmit`` plugin requires the streaming_extractor_music_ program to run. -Its source can be found on GitHub_, and while it is possible to compile the -extractor from source, AcousticBrainz would prefer if you used their binary (see -the AcousticBrainz FAQ_). - -Then, install ``beets`` with ``absubmit`` extra - - pip install "beets[absubmit]" - -Lastly, enable the plugin in your configuration (see :ref:`using-plugins`). - -Submitting Data ---------------- - -To run the analysis program and upload its results, type: - -:: - - beet absubmit [-f] [-d] [QUERY] - -By default, the command will only look for AcousticBrainz data when the tracks -don't already have it; the ``-f`` or ``--force`` switch makes it refetch data -even when it already exists. You can use the ``-d`` or ``--dry`` switch to check -which files will be analyzed, before you start a longer period of processing. - -The plugin works on music with a MusicBrainz track ID attached. The plugin will -also skip music that the analysis tool doesn't support. -streaming_extractor_music_ currently supports files with the extensions ``mp3``, -``ogg``, ``oga``, ``flac``, ``mp4``, ``m4a``, ``m4r``, ``m4b``, ``m4p``, -``aac``, ``wma``, ``asf``, ``mpc``, ``wv``, ``spx``, ``tta``, ``3g2``, ``aif``, -``aiff`` and ``ape``. - -Configuration -------------- - -To configure the plugin, make a ``absubmit:`` section in your configuration -file. The available options are: - -- **auto**: Analyze every file on import. Otherwise, you need to use the ``beet - absubmit`` command explicitly. Default: ``no`` -- **extractor**: The absolute path to the streaming_extractor_music_ binary. - Default: search for the program in your ``$PATH`` -- **force**: Analyze items and submit of AcousticBrainz data even for tracks - that already have it. Default: ``no``. -- **pretend**: Do not analyze and submit of AcousticBrainz data but print out - the items which would be processed. Default: ``no``. -- **base_url**: The base URL of the AcousticBrainz server. The plugin has no - function if this option is not set. Default: None - -.. _acousticbrainz: https://acousticbrainz.org - -.. _beets-xtractor: https://github.com/adamjakab/BeetsPluginXtractor - -.. _faq: https://acousticbrainz.org/faq - -.. _github: https://github.com/MTG/essentia - -.. _pip: https://pip.pypa.io - -.. _requests: https://requests.readthedocs.io/en/latest/ - -.. _streaming_extractor_music: https://essentia.upf.edu/ diff --git a/docs/plugins/acousticbrainz.rst b/docs/plugins/acousticbrainz.rst deleted file mode 100644 index 7f2f9a5341..0000000000 --- a/docs/plugins/acousticbrainz.rst +++ /dev/null @@ -1,80 +0,0 @@ -AcousticBrainz Plugin -===================== - -The ``acousticbrainz`` plugin gets acoustic-analysis information from the -AcousticBrainz_ project. This plugin is now deprecated since the AcousicBrainz -project has been shut down. - -As an alternative the beets-xtractor_ plugin can be used. - -.. _acousticbrainz: https://acousticbrainz.org/ - -.. _beets-xtractor: https://github.com/adamjakab/BeetsPluginXtractor - -Enable the ``acousticbrainz`` plugin in your configuration (see -:ref:`using-plugins`) and run it by typing: - -:: - - $ beet acousticbrainz [-f] [QUERY] - -By default, the command will only look for AcousticBrainz data when the tracks -doesn't already have it; the ``-f`` or ``--force`` switch makes it re-download -data even when it already exists. If you specify a query, only matching tracks -will be processed; otherwise, the command processes every track in your library. - -For all tracks with a MusicBrainz recording ID, the plugin currently sets these -fields: - -- ``average_loudness`` -- ``bpm`` -- ``chords_changes_rate`` -- ``chords_key`` -- ``chords_number_rate`` -- ``chords_scale`` -- ``danceable`` -- ``gender`` -- ``genre_rosamerica`` -- ``initial_key`` (This is a built-in beets field, which can also be provided by - :doc:`/plugins/keyfinder`.) -- ``key_strength`` -- ``mood_acoustic`` -- ``mood_aggressive`` -- ``mood_electronic`` -- ``mood_happy`` -- ``mood_party`` -- ``mood_relaxed`` -- ``mood_sad`` -- ``moods_mirex`` -- ``rhythm`` -- ``timbre`` -- ``tonal`` -- ``voice_instrumental`` - -Warning -------- - -The AcousticBrainz project has shut down. To use this plugin you must set the -``base_url`` configuration option to a server offering the AcousticBrainz API. - -Automatic Tagging ------------------ - -To automatically tag files using AcousticBrainz data during import, just enable -the ``acousticbrainz`` plugin (see :ref:`using-plugins`). When importing new -files, beets will query the AcousticBrainz API using MBID and set the -appropriate metadata. - -Configuration -------------- - -To configure the plugin, make a ``acousticbrainz:`` section in your -configuration file. The available options are: - -- **auto**: Enable AcousticBrainz during ``beet import``. Default: ``yes``. -- **force**: Download AcousticBrainz data even for tracks that already have it. - Default: ``no``. -- **tags**: Which tags from the list above to set on your files. Default: [] - (all). -- **base_url**: The base URL of the AcousticBrainz server. The plugin has no - function if this option is not set. Default: None diff --git a/docs/plugins/beatport.rst b/docs/plugins/beatport.rst deleted file mode 100644 index 8277788b04..0000000000 --- a/docs/plugins/beatport.rst +++ /dev/null @@ -1,48 +0,0 @@ -Beatport Plugin -=============== - -.. deprecated:: 2.8 Beatport retired the API this plugin relies on. See :bug:`3862` and :bug:`4477`. - -The ``beatport`` plugin adds support for querying the Beatport_ catalogue during -the autotagging process. This can potentially be helpful for users whose -collection includes a lot of diverse electronic music releases, for which both -MusicBrainz and (to a lesser degree) Discogs_ show no matches. - -.. _discogs: https://discogs.com - -Installation ------------- - -To use the ``beatport`` plugin, first enable it in your configuration (see -:ref:`using-plugins`). Then, install ``beets`` with ``beatport`` extra - -.. code-block:: bash - - pip install "beets[beatport]" - -You will also need to register for a Beatport_ account. The first time you run -the :ref:`import-cmd` command after enabling the plugin, it will ask you to -authorize with Beatport by visiting the site in a browser. On the site you will -be asked to enter your username and password to authorize beets to query the -Beatport API. You will then be displayed with a single line of text that you -should paste as a whole into your terminal. This will store the authentication -data for subsequent runs and you will not be required to repeat the above steps. - -Matches from Beatport should now show up alongside matches from MusicBrainz and -other sources. - -If you have a Beatport ID or a URL for a release or track you want to tag, you -can just enter one of the two at the "enter Id" prompt in the importer. You can -also search for an id like so: - -:: - - beet import path/to/music/library --search-id id - -Configuration -------------- - -This plugin can be configured like other metadata source plugins as described in -:ref:`metadata-source-plugin-configuration`. - -.. _beatport: https://www.beatport.com/ diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst index a3ef7d4417..738cb34f45 100644 --- a/docs/plugins/index.rst +++ b/docs/plugins/index.rst @@ -55,15 +55,12 @@ databases. They share the following configuration options: .. toctree:: :hidden: - absubmit - acousticbrainz advancedrewrite albumtypes aura autobpm badfiles bareasc - beatport bpd bpm bpsync @@ -177,13 +174,6 @@ Autotagger Extensions Metadata -------- -:doc:`absubmit ` - Analyse audio with the streaming_extractor_music_ program and submit the - metadata to an AcousticBrainz server - -:doc:`acousticbrainz ` - Fetch various AcousticBrainz metadata - :doc:`autobpm ` Use Librosa_ to calculate the BPM from the audio.