Package: beets-autofix
Autofix (Beets Plugin)Thebeets-autofixplugin helps you to automate the tasks that you keep repeating to maintain your library.The plugin is a wrapper around the plugins that you already have in beets. It iterates through the items you have in your library and calls the individual plugins to execute their jobs as they are configured by you.InstallationThe plugin can be installed via:$pipinstallbeets-autofixUsageInvoke the plugin as:$ beet autofix [options] [QUERY...]The following command line options are available:--max_exec_time=MAX_EXEC_TIME [-m MAX_EXEC_TIME]: Interrupt the execution after this number of seconds.--version [-v]: Display the version number of the plugin. Useful when you need to report some issue and you have to state the version of the plugin you are using.ConfigurationBy default all tasks are disabled:max_exec_time:0tasks:missing_file_checker:enabled:noyear_fixer:enabled:noaudio_conversion:enabled:notag_cleaner:enabled:noab_data_fetcher:enabled:noxtractor:enabled:nogenre_finder:enabled:noYou need to override the default configuration and enable the tasks you want to run.Themax_exec_timeallows you to interrupt the execution after a certain number of seconds. For no limit set it to 0.TasksThe following tasks are available:Missing File Checker (task name: missing_file_checker) [related plugin: None]This task is not related to any plugin. It will iterate through all library items and check if the file indicated by thepathattribute exists. If it does not exist, it deletes the library item.Year Fixer (task name: year_fixer) [related plugin:yearfixer]The YearFixer plugin will attempt to fix items with missingyearororiginal_yearattributes missing. The particularity of theyearfixerplugin is that given a specific release, to look for theoriginal_yearattribute, it will search for all recordings of the same title (by the same artist) in the MB database and chose the earliest year that song has been released.Conversion (task name: audio_conversion) [related plugin:convert]This plugin is based on theconvertplugin and triggers the conversion in two cases:if the format of the item is does not correspond to theformatspecified in theconvertplugin configurationif the bitrate of the item is greater than thebitratespecified in theconvertplugin configurationIn both cases the audio file will be converted according to theconvertplugin configuration. The converted audio file will be attached to the library item whilst the original audio file will be deleted.Tag Cleaner (task name: tag_cleaner) [related plugin:zero]This task works with thezeroplugin and triggers only if in the configuration you use thefieldsconfiguration option (it does not work with thekeep_fieldsoption for now). If any of those fields are found to be non-empty, the item will be passed to thezeroplugin for processing.AcousticBrainz Data Fetcher (task name: ab_data_fetcher) [related plugin:acousticbrainz]This task will check if any of the following attributes are missing from the library item and will call the acousticbrainz plugin to fetch such data from the acousticbrainz database. The task will then set the values for the missing attributes. If theforceconfiguration option is set toyesin the configuration of theacousticbrainzplugin then all attributes will be set.The attributes checked and set are:average_loudness,bpm,danceable,gender,genre_rosamerica,voice_instrumental,mood_acoustic,mood_aggressive,mood_electronic,mood_happy,mood_party,mood_relaxed,mood_sad(some more to come soon)Xtractor(task name: xtractor) [related plugin:xtractor]This task and the related plugin works on exactly the same attributes as the ones listed in the AcousticBrainz Data Fetcher task. The difference is that thextractorplugin does not rely on external databases but uses the Essentia extractor binaries to extract such data from your audio files.Genre Finder (task name: genre_finder) [related plugin:lastgenre]This task will call thelastgenreplugin to find out the genre of a specific song. If that fails, it will fall back to thegenre_rosamericaattribute estimated by the Essentia high level extractor and map the genre based on this table:"cla" -> "classical"
    "dan" -> "dance"
    "hip" -> "hip-hop"
    "jaz" -> "jazz"
    "pop" -> "pop"
    "rhy" -> "rhythm and blues"
    "roc" -> "rock"
    "spe" -> "speech"IssuesIf something is not working as expected please use the Issue tracker.If the documentation is not clear please use the Issue tracker.If you have a feature request please use the Issue tracker.In any other situation please use the Issue tracker.Other plugins by the same authorbeets-goingrunningbeets-xtractorbeets-yearfixerbeets-autofixbeets-describebeets-bpmanalyserbeets-templateFinal RemarksEnjoy!