audiolibrarian 0.16.4__py3-none-any.whl → 0.17.0__py3-none-any.whl

audiolibrarian/__init__.py

@@ -1,7 +1,7 @@
 """The audiolibrarian package."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #
@@ -16,4 +16,4 @@
 #  You should have received a copy of the GNU General Public License along with audiolibrarian.
 #  If not, see <https://www.gnu.org/licenses/>.
 #
-__version__ = "0.16.4"
+__version__ = "0.17.0"

audiolibrarian/audiofile/__init__.py

@@ -1,7 +1,6 @@
 """Audio file library."""
-
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/audiofile/audiofile.py

@@ -1,7 +1,7 @@
 """Audio file library."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/audiofile/formats/__init__.py

@@ -1 +1,17 @@
 """AudioFile formats."""
+#
+#  Copyright (c) 2000-2025 Stephen Jibson
+#
+#  This file is part of audiolibrarian.
+#
+#  Audiolibrarian is free software: you can redistribute it and/or modify it under the terms of the
+#  GNU General Public License as published by the Free Software Foundation, either version 3 of the
+#  License, or (at your option) any later version.
+#
+#  Audiolibrarian is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+#  without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
+#  the GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License along with audiolibrarian.
+#  If not, see <https://www.gnu.org/licenses/>.
+#

audiolibrarian/audiofile/formats/flac.py

@@ -1,7 +1,7 @@
 """AudioFile support for flac files."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/audiofile/formats/m4a.py

@@ -1,7 +1,7 @@
 """AudioFile support for m4a files."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/audiofile/formats/mp3.py

@@ -1,7 +1,7 @@
 """AudioFile support for mp3 files."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/audiofile/tags.py

@@ -1,7 +1,7 @@
 """Manage tags."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/audiosource.py

@@ -1,7 +1,7 @@
 """AudioSource."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #
@@ -118,10 +118,10 @@ class CDAudioSource(AudioSource):
         cwd = pathlib.Path.cwd()
         os.chdir(self._temp_dir)
         try:
-            subprocess.run(("cd-paranoia", "-B"), check=True)  # noqa: S603
+            subprocess.run(("cd-paranoia", "-B"), check=True)
         finally:
             os.chdir(cwd)
-        subprocess.run(("eject",), check=False)  # noqa: S603
+        subprocess.run(("eject",), check=False)
 
 
 class FilesAudioSource(AudioSource):

audiolibrarian/base.py

@@ -4,7 +4,7 @@ Useful stuff: https://help.mp3tag.de/main_tags.html
 """
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #
@@ -27,9 +27,10 @@ import subprocess
 import sys
 import warnings
 from collections.abc import Iterable
-from typing import Any
+from typing import Any, Final
 
 import colors
+import ffmpeg_normalize
 import filelock
 import yaml
 
@@ -46,6 +47,7 @@ class Base:
     """
 
     command: str | None = None
+    _manifest_file: Final[str] = "Manifest.yaml"
 
     def __init__(self, args: argparse.Namespace) -> None:
         """Initialize the base."""
@@ -66,9 +68,10 @@ class Base:
         self._source_dir = self._work_dir / "source"
         self._wav_dir = self._work_dir / "wav"
 
-        self._manifest_file = "Manifest.yaml"
         self._lock = filelock.FileLock(str(self._work_dir) + ".lock")
 
+        self._normalizer = self._which_normalizer()
+
         # Initialize stuff that will be defined later.
         self._audio_source: audiosource.AudioSource | None = None
         self._release: records.Release | None = None
@@ -126,24 +129,6 @@ class Base:
             self._make_mp3()
             self._move_files(move_source=make_source)
 
-    @staticmethod
-    def _find_audio_files(directories: list[str | pathlib.Path]) -> Iterable[audiofile.AudioFile]:
-        """Yield audiofile objects found in the given directories."""
-        paths: list[pathlib.Path] = []
-        # Grab all the paths first because thing may change as files are renamed.
-        for directory in directories:
-            path = pathlib.Path(directory)
-            for ext in audiofile.AudioFile.extensions():
-                paths.extend(path.rglob(f"*{ext}"))
-        paths = sorted(set(paths))
-        # Using yield rather than returning a list saves us from simultaneously storing
-        # potentially thousands of AudioFile objects in memory at the same time.
-        for path in paths:
-            try:
-                yield audiofile.AudioFile.open(path)
-            except FileNotFoundError:
-                continue
-
     def _find_manifests(self, directories: list[str | pathlib.Path]) -> list[pathlib.Path]:
         """Return a sorted, unique list of manifest files anywhere in the given directories."""
         manifests = set()
@@ -283,25 +268,36 @@ class Base:
                 path.rename(source_dir / path.name)
 
     def _normalize(self) -> None:
-        """Normalize the wav files using wavegain."""
-        print("Normalizing wav files...")
-        command = [
-            "wavegain",
-            f"--{SETTINGS.normalize_preset}",
-            f"--gain={SETTINGS.normalize_gain}",
-            "--apply",
-        ]
-        command.extend(str(f) for f in self._wav_filenames)
-        result = subprocess.run(command, capture_output=True, check=False)  # noqa: S603
-        for line in str(result.stderr).split(r"\n"):
-            line_trunc = line[:137] + "..." if len(line) > 140 else line  # noqa: PLR2004
-            log.info("WAVEGAIN: %s", line_trunc)
-        result.check_returncode()
+        """Normalize the wav files using the selected normalizer."""
+        if self._normalizer == "none":
+            return
+        print(f"Normalizing wav files using {self._normalizer}...")
+
+        if self._normalizer == "wavegain":
+            command = [
+                "wavegain",
+                f"--{SETTINGS.normalize.wavegain.preset}",
+                f"--gain={SETTINGS.normalize.wavegain.gain}",
+                "--apply",
+            ]
+            command.extend(str(f) for f in self._wav_filenames)
+            result = subprocess.run(command, capture_output=True, check=False)  # noqa: S603
+            for line in str(result.stderr).split(r"\n"):
+                line_trunc = line[:137] + "..." if len(line) > 140 else line  # noqa: PLR2004
+                log.info("WAVEGAIN: %s", line_trunc)
+            result.check_returncode()
+            return
 
-    @staticmethod
-    def _read_manifest(manifest_path: pathlib.Path) -> dict[Any, Any]:
-        with manifest_path.open(encoding="utf-8") as manifest_file:
-            return dict(yaml.safe_load(manifest_file))
+        normalizer = ffmpeg_normalize.FFmpegNormalize(
+            extension="wav",
+            keep_loudness_range_target=True,
+            target_level=SETTINGS.normalize.ffmpeg.target_level,
+        )
+        for wav_file in self._wav_filenames:
+            normalizer.add_media_file(str(wav_file), str(wav_file))
+        log.info("NORMALIZER: starting ffmpeg normalization...")
+        normalizer.run_normalization()
+        log.info("NORMALIZER: ffmpeg normalization completed successfully")
 
     def _rename_wav(self) -> None:
         """Rename the wav files to a filename-sane representation of the track title."""
@@ -431,3 +427,54 @@ class Base:
         with pathlib.Path(manifest_filename).open("w", encoding="utf-8") as manifest_file:
             yaml.dump(manifest, manifest_file)
         print(f"Wrote {manifest_filename}")
+
+    @staticmethod
+    def _which_normalizer() -> str:
+        """Determine which normalizer to use based on settings and availability.
+
+        Returns:
+            str: The name of the normalizer to use ("wavegain", "ffmpeg" or "none")
+        """
+        normalizer = SETTINGS.normalize.normalizer
+        if normalizer == "none":
+            return "none"
+
+        wavegain_found = shutil.which("wavegain")
+        if normalizer in ("auto", "wavegain") and wavegain_found:
+            return "wavegain"
+
+        ffmpeg_found = shutil.which("ffmpeg")
+        if normalizer in ("auto", "ffmpeg") and ffmpeg_found:
+            return "ffmpeg"
+
+        if wavegain_found:
+            log.warning("ffmpeg not found, using wavegain for normalization")
+            return "wavegain"
+        if ffmpeg_found:
+            log.warning("wavegain not found, using ffmpeg for normalization")
+            return "ffmpeg"
+        log.warning("wavegain not found, ffmpeg not found, using no normalization")
+        return "none"
+
+    @staticmethod
+    def _find_audio_files(directories: list[str | pathlib.Path]) -> Iterable[audiofile.AudioFile]:
+        """Yield audiofile objects found in the given directories."""
+        paths: list[pathlib.Path] = []
+        # Grab all the paths first because thing may change as files are renamed.
+        for directory in directories:
+            path = pathlib.Path(directory)
+            for ext in audiofile.AudioFile.extensions():
+                paths.extend(path.rglob(f"*{ext}"))
+        paths = sorted(set(paths))
+        # Using yield rather than returning a list saves us from simultaneously storing
+        # potentially thousands of AudioFile objects in memory at the same time.
+        for path in paths:
+            try:
+                yield audiofile.AudioFile.open(path)
+            except FileNotFoundError:
+                continue
+
+    @staticmethod
+    def _read_manifest(manifest_path: pathlib.Path) -> dict[Any, Any]:
+        with manifest_path.open(encoding="utf-8") as manifest_file:
+            return dict(yaml.safe_load(manifest_file))

audiolibrarian/cli.py

@@ -1,7 +1,7 @@
 """Audiolibrarian command line interface."""
 
 #
-#  Copyright (c) 2021 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #
@@ -40,7 +40,6 @@ class CommandLineInterface:
         "lame",
         "mpg123",
         "sndfile-convert",
-        "wavegain",
     }
 
     def __init__(self, *, parse_args: bool = True) -> None:

audiolibrarian/commands.py

@@ -1,7 +1,7 @@
 """Command line commands."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #
@@ -51,8 +51,8 @@ class Convert(_Command, base.Base):
     parser = argparse.ArgumentParser()
     parser.add_argument("--artist", "-a", help="provide artist (ignore tags)")
     parser.add_argument("--album", "-m", help="provide album (ignore tags)")
-    parser.add_argument("--mb-artist-id", help="Musicbrainz artist ID")
-    parser.add_argument("--mb-release-id", help="Musicbrainz release ID")
+    parser.add_argument("--mb-artist-id", help="MusicBrainz artist ID")
+    parser.add_argument("--mb-release-id", help="MusicBrainz release ID")
     parser.add_argument("--disc", "-d", help="format: x/y: disc x of y for multi-disc release")
     parser.add_argument("filename", nargs="+", help="directory name or audio file name")
 
@@ -79,14 +79,14 @@ class Genre(_Command):
     parser = argparse.ArgumentParser(
         description=(
             "Process all audio files in the given directory(ies), allowing the user to *update* "
-            "the genre in Musicbrainz or *tag* audio files with the user-defined genre in "
-            "Musicbrainz."
+            "the genre in MusicBrainz or *tag* audio files with the user-defined genre in "
+            "MusicBrainz."
         )
     )
     parser.add_argument("directory", nargs="+", help="root of directory tree to process")
     parser_action = parser.add_mutually_exclusive_group()
     parser_action.add_argument("--tag", action="store_true", help="update tags")
-    parser_action.add_argument("--update", action="store_true", help="update Musicbrainz")
+    parser_action.add_argument("--update", action="store_true", help="update MusicBrainz")
 
     def __init__(self, args: argparse.Namespace) -> None:
         """Initialize a Genre command handler."""
@@ -106,8 +106,8 @@ class Manifest(_Command, base.Base):
     parser.add_argument("--artist", "-a", help="provide artist (ignore tags)")
     parser.add_argument("--album", "-m", help="provide album (ignore tags)")
     parser.add_argument("--cd", "-c", action="store_true", help="original source was a CD")
-    parser.add_argument("--mb-artist-id", help="Musicbrainz artist ID")
-    parser.add_argument("--mb-release-id", help="Musicbrainz release ID")
+    parser.add_argument("--mb-artist-id", help="MusicBrainz artist ID")
+    parser.add_argument("--mb-release-id", help="MusicBrainz release ID")
     parser.add_argument("--disc", "-d", help="format: x/y: disc x of y for multi-disc release")
     parser.add_argument("filename", nargs="+", help="directory name or audio file name")
 
@@ -229,8 +229,8 @@ class Rip(_Command, base.Base):
     parser = argparse.ArgumentParser()
     parser.add_argument("--artist", "-a", help="provide artist")
     parser.add_argument("--album", "-m", help="provide album")
-    parser.add_argument("--mb-artist-id", help="Musicbrainz artist ID")
-    parser.add_argument("--mb-release-id", help="Musicbrainz release ID")
+    parser.add_argument("--mb-artist-id", help="MusicBrainz artist ID")
+    parser.add_argument("--mb-release-id", help="MusicBrainz release ID")
     parser.add_argument("--disc", "-d", help="x/y: disc x of y; multi-disc release")
 
     def __init__(self, args: argparse.Namespace) -> None:

audiolibrarian/genremanager.py

@@ -1,7 +1,7 @@
 """Genre Manager."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #
@@ -139,11 +139,11 @@ class GenreManager:
     def _get_genres_by_artist(
         self,
     ) -> tuple[dict[str, str], dict[str, dict[str, Any]]]:
-        """Return two dicts mapping Musicbrainz-artist-ID to user and community.
+        """Return two dicts mapping MusicBrainz-artist-ID to user and community.
 
         Returns:
-          user: a single genre, set in Musicbrainz by this app's user
-          community: a list genre records (dicts) set in Musicbrainz by the community
+          user: a single genre, set in MusicBrainz by this app's user
+          community: a list genre records (dicts) set in MusicBrainz by the community
                      with "name" and "count" fields
         """
         user: dict[str, str] = {}

audiolibrarian/musicbrainz.py

@@ -1,7 +1,7 @@
 """Access the MusicBrainz service."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #
@@ -417,7 +417,7 @@ class Searcher:
             log.info("RELEASE_GROUPS: {release_group_ids}")
             release_id = self._prompt_release_id(release_group_ids)
         else:
-            release_id = self._prompt_uuid("Musicbrainz Release ID: ")
+            release_id = self._prompt_uuid("MusicBrainz Release ID: ")
 
         return MusicBrainzRelease(release_id).get_release()
 

audiolibrarian/output.py

@@ -1,7 +1,7 @@
 """Screen output utilities."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/records.py

@@ -4,7 +4,7 @@ Useful field reference: https://github.com/metabrainz/picard/blob/master/picard/
 """
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/settings.py

@@ -21,23 +21,34 @@ configuration and cache locations.
 Sensitive fields (like passwords) are handled using pydantic.SecretStr for security.
 """
 
+#
+#  Copyright (c) 2000-2025 Stephen Jibson
+#
+#  This file is part of audiolibrarian.
+#
+#  Audiolibrarian is free software: you can redistribute it and/or modify it under the terms of the
+#  GNU General Public License as published by the Free Software Foundation, either version 3 of the
+#  License, or (at your option) any later version.
+#
+#  Audiolibrarian is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
+#  without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
+#  the GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License along with audiolibrarian.
+#  If not, see <https://www.gnu.org/licenses/>.
+#
 import logging
 import pathlib
 from typing import Literal
 
 import pydantic
+import pydantic_settings
 import xdg_base_dirs
-from pydantic_settings import (
-    BaseSettings,
-    PydanticBaseSettingsSource,
-    SettingsConfigDict,
-    YamlConfigSettingsSource,
-)
 
 logger = logging.getLogger(__name__)
 
 
-class MusicBrainzSettings(BaseSettings):
+class MusicBrainzSettings(pydantic_settings.BaseSettings):
     """Configuration settings for MusicBrainz."""
 
     password: pydantic.SecretStr = pydantic.SecretStr("")
@@ -45,17 +56,37 @@ class MusicBrainzSettings(BaseSettings):
     rate_limit: pydantic.PositiveFloat = 1.5  # Seconds between requests.
 
 
-class Settings(BaseSettings):
+class NormalizeFFmpegSettings(pydantic_settings.BaseSettings):
+    """Configuration settings for ffmpeg normalization."""
+
+    target_level: float = -13
+
+
+class NormalizeWavegainSettings(pydantic_settings.BaseSettings):
+    """Configuration settings for wavegain normalization."""
+
+    gain: int = 5  # dB
+    preset: Literal["album", "radio"] = "radio"
+
+
+class NormalizeSettings(pydantic_settings.BaseSettings):
+    """Configuration settings for audio normalization."""
+
+    normalizer: Literal["auto", "wavegain", "ffmpeg", "none"] = "auto"
+    ffmpeg: NormalizeFFmpegSettings = NormalizeFFmpegSettings()
+    wavegain: NormalizeWavegainSettings = NormalizeWavegainSettings()
+
+
+class Settings(pydantic_settings.BaseSettings):
     """Configuration settings for AudioLibrarian."""
 
     discid_device: str | None = None  # Use default device.
     library_dir: pathlib.Path = pathlib.Path("library").resolve()
     musicbrainz: MusicBrainzSettings = MusicBrainzSettings()
-    normalize_gain: int = 5  # dB
-    normalize_preset: Literal["album", "radio"] = "radio"
+    normalize: NormalizeSettings = NormalizeSettings()
     work_dir: pathlib.Path = xdg_base_dirs.xdg_cache_home() / "audiolibrarian"
 
-    model_config = SettingsConfigDict(
+    model_config = pydantic_settings.SettingsConfigDict(
         env_nested_delimiter="__",
         env_prefix="AUDIOLIBRARIAN__",
         yaml_file=str(xdg_base_dirs.xdg_config_home() / "audiolibrarian" / "config.yaml"),
@@ -65,14 +96,18 @@ class Settings(BaseSettings):
     @classmethod
     def settings_customise_sources(
         cls,
-        settings_cls: type[BaseSettings],
-        init_settings: PydanticBaseSettingsSource,
-        env_settings: PydanticBaseSettingsSource,
-        dotenv_settings: PydanticBaseSettingsSource,
-        file_secret_settings: PydanticBaseSettingsSource,
-    ) -> tuple[PydanticBaseSettingsSource, ...]:
+        settings_cls: type[pydantic_settings.BaseSettings],
+        init_settings: pydantic_settings.PydanticBaseSettingsSource,
+        env_settings: pydantic_settings.PydanticBaseSettingsSource,
+        dotenv_settings: pydantic_settings.PydanticBaseSettingsSource,
+        file_secret_settings: pydantic_settings.PydanticBaseSettingsSource,
+    ) -> tuple[pydantic_settings.PydanticBaseSettingsSource, ...]:
         del dotenv_settings, file_secret_settings  # Unused.
-        return env_settings, YamlConfigSettingsSource(settings_cls), init_settings
+        return (
+            env_settings,
+            pydantic_settings.YamlConfigSettingsSource(settings_cls),
+            init_settings,
+        )
 
 
 SETTINGS = Settings()

audiolibrarian/sh.py

@@ -1,7 +1,7 @@
 """Command execution helpers."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian/text.py

@@ -1,7 +1,7 @@
 """Text utilities."""
 
 #
-#  Copyright (c) 2020 Stephen Jibson
+#  Copyright (c) 2000-2025 Stephen Jibson
 #
 #  This file is part of audiolibrarian.
 #

audiolibrarian-0.17.0.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: audiolibrarian
+Version: 0.17.0
+Summary: Manage my audio library.
+Project-URL: Repository, https://github.com/toadstule/audiolibrarian
+Author-email: Steve Jibson <steve@jibson.com>
+License-File: COPYING
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Programming Language :: Python
+Requires-Python: <3.14,>=3.12
+Requires-Dist: ansicolors
+Requires-Dist: discid
+Requires-Dist: ffmpeg-normalize
+Requires-Dist: filelock
+Requires-Dist: fuzzywuzzy
+Requires-Dist: musicbrainzngs
+Requires-Dist: mutagen
+Requires-Dist: pydantic-settings
+Requires-Dist: python-levenshtein
+Requires-Dist: pyyaml
+Requires-Dist: requests
+Requires-Dist: xdg-base-dirs
+Description-Content-Type: text/markdown
+
+# audiolibrarian
+
+[![PyPI](https://img.shields.io/pypi/v/audiolibrarian)](https://pypi.org/project/audiolibrarian/)
+[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+[![Documentation Status](https://readthedocs.org/projects/audiolibrarian/badge/?version=latest)](https://audiolibrarian.readthedocs.io/)
+
+`audiolibrarian` is a command-line tool for ripping audio from CDs (or taking
+high-quality audio from local files), tagging them with comprehensive metadata from MusicBrainz,
+converting them to multiple formats, and organizing them in a clean directory structure.
+
+## Features
+
+- **CD Ripping**: Extract audio from CDs with accurate metadata lookup
+- **Audio Conversion**: Convert between multiple audio formats (FLAC, M4A, MP3)
+- **Metadata Management**: Automatically fetch and apply rich metadata from MusicBrainz
+- **File Organization**: Intelligently organize music files into a clean directory structure
+- **Batch Processing**: Handle multiple files and directories efficiently
+
+## Basic Usage
+
+```bash
+# Rip audio from a CD
+audiolibrarian rip
+
+# Convert audio files
+audiolibrarian convert /path/to/audio/files
+
+# Get help
+audiolibrarian --help
+```
+
+## Documentation
+
+For complete documentation, including installation instructions, configuration, and advanced usage, visit:
+
+[https://audiolibrarian.readthedocs.io/](https://audiolibrarian.readthedocs.io/)
+
+## License
+
+This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please see our [contributing guide](CONTRIBUTING.md) for details.
+
+## Support
+
+For support, please [open an issue](https://github.com/toadstule/audiolibrarian/issues) on GitHub.

audiolibrarian-0.17.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+audiolibrarian/__init__.py,sha256=nk7MHHw3booS4scifS56NhceSDNsLnU7vcljwNcLcZ0,792
+audiolibrarian/audiosource.py,sha256=Xs8KBvb0Jd-JRHv3veyBA9lL2siC70-gO2RdZqy2ntk,8550
+audiolibrarian/base.py,sha256=yDN2PELNboUr_eD-Ix8xi-JHhq8XbDuaj4AnvergSIE,21263
+audiolibrarian/cli.py,sha256=vtAJND7U5yoBCbm20HRCvIFp2HYzXl3jfHNfsNUQVlE,4196
+audiolibrarian/commands.py,sha256=rM44NQUKtZsBI3C8EY0u0vRrricfj3felM00x16fBeU,11171
+audiolibrarian/genremanager.py,sha256=ag4LGcXPHjuI-Y07DTmGjVcaUKyKazyWHGBak9YzVAg,7362
+audiolibrarian/musicbrainz.py,sha256=hoZKDueqgfMo-Da_ZH3_bQcRXqRvaz9KCx9MARMI5h8,19317
+audiolibrarian/output.py,sha256=MQGsKrOfkRASGkVG4CEi2kgj0smEm8TfXqAR-lwULwk,1707
+audiolibrarian/records.py,sha256=87DXbpwzl8Fsh71Nzi5XmJDAaEGvRjH6vwJ75cIM9PQ,7934
+audiolibrarian/settings.py,sha256=GSuT3zOa6jyrejx14_dLwJaTA6eCTNYFq6EQ9UQOzhI,4042
+audiolibrarian/sh.py,sha256=7V-FrSSiq56cNL1IyYBEcSUXtMbwFs6Ob1EhU_i_c84,1917
+audiolibrarian/text.py,sha256=VrxrQm6pZtuYbK9MlukSC3MdqDBSlsnTgkhBTwj9MpY,4031
+audiolibrarian/audiofile/__init__.py,sha256=PTBAVV5gfSc0UVvWMHyeL1d3xwhgJ8J00L-KVhuCGhY,898
+audiolibrarian/audiofile/audiofile.py,sha256=UCVXu2ga7stnTzeeLzrx-JTFl5ad82qy45HmB3g2a8c,4357
+audiolibrarian/audiofile/tags.py,sha256=Di8TjvOYZYYgedMNRZ8tTGFxZ1KN4oAK7z17TzTSeZg,1790
+audiolibrarian/audiofile/formats/__init__.py,sha256=DexI0KdI6hnbDhvK9xuEFvYyyQA2SOFT_xfadc42Nsk,759
+audiolibrarian/audiofile/formats/flac.py,sha256=UNXfZbnL0cjzmlS3nuZ26QczrfD-twgc7S6PbtoOkqA,9713
+audiolibrarian/audiofile/formats/m4a.py,sha256=Ki-pHnObeEMXegIAHu7ymtB_PjMiWLDU5HHXaWxaPPo,10557
+audiolibrarian/audiofile/formats/mp3.py,sha256=SQOcPVAE-coDz4tK-gopWSWJE02nQBTbxrlmRkyK7QU,12886
+picard_src/README.md,sha256=mtJ7RNLlC7Oz9M038WU-3ciPa7jPdXlFLYdJBL8iRQo,411
+picard_src/__init__.py,sha256=acu0-oac_qfEgiB0rw0RvuL---O15-rOckWboVMxWtM,198
+picard_src/textencoding.py,sha256=0MRHFwhqEwauQbjTTz6gpgzo6YH1VDPfdJqQoCWHtjM,26234
+audiolibrarian-0.17.0.dist-info/METADATA,sha256=CvHJpVXiHY01H6rQ828Nu_a4Yzr-KXrXWXh5BgOl-X0,2578
+audiolibrarian-0.17.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+audiolibrarian-0.17.0.dist-info/entry_points.txt,sha256=reubnr_SGbTTDXji8j7z8aTmIL0AEQKVSLcnmFG3YYY,59
+audiolibrarian-0.17.0.dist-info/licenses/COPYING,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+audiolibrarian-0.17.0.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+audiolibrarian-0.17.0.dist-info/RECORD,,

audiolibrarian-0.16.4.dist-info/METADATA

@@ -1,333 +0,0 @@
-Metadata-Version: 2.4
-Name: audiolibrarian
-Version: 0.16.4
-Summary: Manage my audio library.
-Project-URL: Repository, https://github.com/toadstule/audiolibrarian
-Author-email: Steve Jibson <steve@jibson.com>
-License-File: COPYING
-License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
-Classifier: Programming Language :: Python
-Requires-Python: ==3.13.*
-Requires-Dist: ansicolors
-Requires-Dist: discid
-Requires-Dist: filelock
-Requires-Dist: fuzzywuzzy
-Requires-Dist: musicbrainzngs
-Requires-Dist: mutagen
-Requires-Dist: pydantic-settings
-Requires-Dist: python-levenshtein
-Requires-Dist: pyyaml
-Requires-Dist: requests
-Requires-Dist: xdg-base-dirs
-Description-Content-Type: text/markdown
-
-# audiolibrarian #
-
-## Overview ##
-
-`audiolibrarian` is a command-line tool for ripping audio from CDs (or taking
-high-quality audio from local files), tagging them with comprehensive metadata from MusicBrainz,
-converting them to multiple formats, and organizing them in a clean directory structure.
-
-### Key Features ###
-
-- **CD Ripping**: Extract audio from CDs with accurate metadata lookup
-- **Audio Conversion**: Convert between multiple audio formats (FLAC, M4A, MP3)
-- **Metadata Management**: Automatically fetch and apply rich metadata from MusicBrainz
-- **File Organization**: Intelligently organize music files into a clean directory structure
-- **Batch Processing**: Handle multiple files and directories efficiently
-- **Genre Management**: Work with MusicBrainz genres and tags
-- **Flexible Configuration**: Customize behavior through config files and environment variables
-
-### Why audiolibrarian? ###
-
-- **Consistent Quality**: Maintains audio quality through the conversion process
-- **Accurate Metadata**: Leverages MusicBrainz for comprehensive music information
-- **Automated Workflow**: Reduces manual work in organizing and tagging music
-- **Open Source**: Free to use and modify under the GPL-3.0 license
-
-Whether you're digitizing a CD collection, organizing existing music files, or managing a large
-digital library, `audiolibrarian` provides the tools you need to keep your music collection
-well-organized and properly tagged.
-
-## Installation ##
-
-> **NOTE:** This library has only been tested on Linux. It may not work on other operating
-> systems.
-
-### External Requirements ###
-
-`audiolibrarian` uses a few command-line tools to run:
-
-- [cd-paranoia](https://www.gnu.org/software/libcdio/)
-- [util-linux](https://github.com/util-linux/util-linux)
-- [faad2](https://github.com/knik0/faad2)
-- [fdkaac](https://github.com/nu774/fdkaac)
-- [flac](https://github.com/xiph/flac)
-- [lame](https://lame.sourceforge.io/)
-- [mpg123](https://www.mpg123.de/)
-- [libsndfile](https://github.com/libsndfile/libsndfile)
-- [wavegain](https://github.com/MestreLion/wavegain)
-
-It also requires the [libdiscid](https://musicbrainz.org/doc/libdiscid) library.
-
-### Install from PyPI ###
-
-`audiolibrarian` is available on PyPI:
-
-```bash
-pip install audiolibrarian
-```
-
-## Configuration ##
-
-`audiolibrarian` uses a flexible configuration system that supports multiple configuration sources,
-listed in order of precedence:
-
-1. **Environment Variables** (highest precedence)
-   - Prefix: `AUDIOLIBRARIAN__`
-   - Nested fields: Use `__` as delimiter (e.g., `AUDIOLIBRARIAN__MUSICBRAINZ__USERNAME`)
-   - Example:
-
-     ```bash
-     # Override library directory (library_dir)
-     export AUDIOLIBRARIAN__LIBRARY_DIR="/mnt/music/library"
-     
-     # Set MusicBrainz credentials (musicbrainz.username and musicbrainz.password)
-     export AUDIOLIBRARIAN__MUSICBRAINZ__USERNAME="your_username"
-     export AUDIOLIBRARIAN__MUSICBRAINZ__PASSWORD="your_password"
-     ```
-
-2. **YAML Configuration File** (medium precedence)
-   - Default location: `~/.config/audiolibrarian/config.yaml`
-   - Example:
-
-     ```yaml
-     # Base directory for your music library
-     library_dir: "~/music/library"
-
-     # Cache and working directory
-     work_dir: "~/.cache/audiolibrarian"
-
-     # CD/DVD device path (use null for default device)
-     discid_device: null
-
-     # Audio normalization settings
-     normalize_gain: 5  # dB gain for normalization
-     normalize_preset: "radio"  # "album" or "radio"
-
-     # MusicBrainz API settings (optional)
-     musicbrainz:
-       username: "your_username"  # For personal genre preferences
-       password: "your_password"  # Will be stored securely
-       rate_limit: 1.5  # Seconds between API requests
-     ```
-
-3. **Default Values** (lowest precedence)
-   - Built-in defaults from the application
-
-### Available Settings ###
-
-| Setting                  | Default                   | Description                               |
-|--------------------------|---------------------------|-------------------------------------------|
-| `library_dir`            | `./library`               | Directory for storing audio files         |
-| `work_dir`               | `~/.cache/audiolibrarian` | Directory for temporary files             |
-| `discid_device`          | `null`                    | CD device path (null for default device)  |
-| `normalize_gain`         | `5`                       | Normalization gain in dB                  |
-| `normalize_preset`       | `"radio"`                 | Normalization preset ("album" or "radio") |
-| `musicbrainz.username`   | (not set)                 | MusicBrainz username                      |
-| `musicbrainz.password`   | (not set)                 | MusicBrainz password                      |
-| `musicbrainz.rate_limit` | `1.5`                     | Seconds between requests                  |
-
-> **Notes**:
->
-> - The `musicbrainz` username and password are optional but recommended for accessing personal genre
->   preferences on [MusicBrainz](https://musicbrainz.org/).
-> - The `work_dir` default is actually `$XDG_CACHE_HOME/audiolibrarian`, which defaults to
->   `~/.cache/audiolibrarian` on Linux and macOS.
-
-## Usage ##
-
-### Basic Commands ###
-
-```bash
-# Rip audio from a CD
-audiolibrarian rip
-
-# Convert audio files
-audiolibrarian convert /path/to/audio/files
-
-# Create or update manifest files
-audiolibrarian manifest /path/to/audio/files
-
-# Reconvert files from existing source
-audiolibrarian reconvert /path/to/source/directories
-
-# Rename files based on tags
-audiolibrarian rename /path/to/audio/directories
-
-# Manage MusicBrainz genres
-audiolibrarian genre /path/to/audio/directories --tag  # Update tags with MB genres
-
-# Show help for all commands
-audiolibrarian --help
-```
-
-### Directory Structure ###
-
-`audiolibrarian` organizes files in the following structure:
-
-**Processed audio files** (organized by format):
-
-   ```text
-   library/
-   ├── flac/
-   │   └── Artist/
-   │       └── YYYY__Album/
-   │           ├── 01__Track_Title.flac
-   │           └── 02__Another_Track.flac
-   ├── m4a/
-   │   └── Artist/
-   │       └── YYYY__Album/
-   │           ├── 01__Track_Title.m4a
-   │           └── 02__Another_Track.m4a
-   ├── mp3/
-   │   └── Artist/
-   │   └── YYYY__Album/
-   │           ├── 01__Track_Title.mp3
-   │           └── 02__Another_Track.mp3
-   ├── source/
-   │   └── Artist/
-   │       └── YYYY__Album/
-   │           ├── 01__Track_Title.flac
-   │           ├── 02__Another_Track.flac
-   │           └── Manifest.yaml
-   ```
-
-### Advanced Usage ###
-
-#### Ripping CDs ####
-
-```bash
-# Basic CD rip
-audiolibrarian rip
-
-# Specify artist and album
-audiolibrarian rip --artist "Artist Name" --album "Album Name"
-
-# Specify MusicBrainz release ID (for better metadata)
-audiolibrarian rip --mb-release-id "12345678-1234-1234-1234-123456789012"
-
-# Specify disc number for multi-disc sets
-audiolibrarian rip --disc "1/2"  # First disc of two
-```
-
-#### Converting Audio Files ####
-
-```bash
-# Convert with specific artist and album
-audiolibrarian convert --artist "Artist Name" --album "Album Name" /path/to/audio/files
-
-# Convert with MusicBrainz release ID
-audiolibrarian convert --mb-release-id "12345678-1234-1234-1234-123456789012" /path/to/audio/files
-
-# Convert multi-disc release
-audiolibrarian convert --disc "1/2" /path/to/disc1/files
-```
-
-#### Working with Manifests ####
-
-```bash
-# Create manifest for existing files
-audiolibrarian manifest /path/to/audio/files
-
-# Specify CD as source
-audiolibrarian manifest --cd /path/to/audio/files
-
-# Specify MusicBrainz artist and release IDs
-audiolibrarian manifest \
-    --mb-artist-id "12345678-1234-1234-1234-123456789012" \
-    --mb-release-id "87654321-4321-4321-4321-210987654321" \
-    /path/to/audio/files
-```
-
-#### Reconverting Files ####
-
-```bash
-# Reconvert all files in directory
-audiolibrarian reconvert /path/to/source/directories
-
-# Reconvert with dry run (no changes)
-audiolibrarian reconvert --dry-run /path/to/source/directories
-```
-
-#### Renaming Files ####
-
-```bash
-# Rename files based on tags
-audiolibrarian rename /path/to/audio/directories
-
-# Preview renames without making changes
-audiolibrarian rename --dry-run /path/to/audio/directories
-```
-
-#### Using Different Normalization Presets ####
-
-```bash
-# Use radio normalization preset (default)
-export AUDIOLIBRARIAN__NORMALIZE_PRESET="radio"
-
-# Use album normalization preset
-export AUDIOLIBRARIAN__NORMALIZE_PRESET="album"
-```
-
-#### Combining Configuration Sources ####
-
-Configuration sources are combined with the following precedence (highest to lowest):
-1. Environment variables
-2. YAML configuration file
-3. Default values
-
-For example, with this `config.yaml`:
-
-```yaml
-# config.yaml
-library_dir: /media/music/library
-normalize_gain: 5.0
-```
-
-And this environment variable:
-
-```bash
-export AUDIOLIBRARIAN__NORMALIZE_GAIN="8.0"
-```
-
-The effective value of `normalize_gain` will be `8.0` (from the environment variable), while
-`library_dir` will be set to `/media/music/library` from the YAML file.
-
-### Troubleshooting ###
-
-#### Increasing Verbosity ####
-
-```bash
-# Show more detailed output
-audiolibrarian --log-level INFO cd
-
-# Show debug information
-audiolibrarian --log-level DEBUG cd
-```
-
-#### MusicBrainz Issues ####
-
-If you encounter MusicBrainz-related errors:
-
-1. Verify your credentials are correct
-2. Check your Internet connection
-3. Use the debug log level to get more information
-4. Increase the rate limit if you're hitting rate limits
-
-```bash
-export AUDIOLIBRARIAN__MUSICBRAINZ__RATE_LIMIT="2.0"
-```

audiolibrarian-0.16.4.dist-info/RECORD

@@ -1,28 +0,0 @@
-audiolibrarian/__init__.py,sha256=VVNnoovlK4Pl3YDm2ETbU5q14mKK3UH6PvNQIVxNq7Y,787
-audiolibrarian/audiosource.py,sha256=EtoSQb6R2zfHUwxiR9ZqGwjxrX2mTB5gPpmKangps4s,8573
-audiolibrarian/base.py,sha256=54s_NacDvyGpvc_uOJO5apmQin4HKUGfPrlw0XFiJoI,19428
-audiolibrarian/cli.py,sha256=azX49RO2t4q8qyUJ9WTOlDqUO13p17mq0wNmEdl6QGw,4211
-audiolibrarian/commands.py,sha256=8R9aagOaaLE798lGYPWknW-NiIHkxEbQbiM43RZrPTU,11166
-audiolibrarian/genremanager.py,sha256=ZciuJb3GoaM31h33_khowNg8iv4MVGkjJM-beijSF3k,7357
-audiolibrarian/musicbrainz.py,sha256=DAodaLVySqq6nSbGCLfUktXSAm95OfPhkOXyyexMj6w,19312
-audiolibrarian/output.py,sha256=JHuttwEMEzUxty7P8e2jaL6702q52fTWAdZEgb85bxQ,1702
-audiolibrarian/records.py,sha256=BovHwNVd0nTTwQPYkhOAOIVASWz9l47j6cGdXAx5VjM,7929
-audiolibrarian/settings.py,sha256=qKQ9JYfKr2k_JceWfYPiMlpBKylujCQI_2pmxWpsGFo,2550
-audiolibrarian/sh.py,sha256=tVTuKXlMH738jTopjnMWqidTaH02_EyHau3q9kQ6mYE,1912
-audiolibrarian/text.py,sha256=05q_E22w9hMsy01_A5XlU2pqQIMlM5RF4DXzYuLCcYo,4026
-audiolibrarian/audiofile/__init__.py,sha256=BRjf4iu_cogB3A5oIVE4BjIgUGCH0dAzPG4A_48rOUM,894
-audiolibrarian/audiofile/audiofile.py,sha256=IhTIzFzYeKfJmsgOG7bN62KWD06ehOGRoVv3eCf-_vw,4352
-audiolibrarian/audiofile/tags.py,sha256=42oyqHZ6jRokmQskD2p53NMgKxJR7xkidXImOhUzszY,1785
-audiolibrarian/audiofile/formats/__init__.py,sha256=ZV5urTtQQ4ZX_K2s9qFsSzDunvdQaQ43K7CE-BPPtEo,25
-audiolibrarian/audiofile/formats/flac.py,sha256=3MfzdgnAqTVSbAraAVde2BSHwdAyi-fKkc55OvuRNSc,9708
-audiolibrarian/audiofile/formats/m4a.py,sha256=S0aFZxMzgwpzkwYE2D_K_US0Dnh0objK21ph1S_8rJk,10552
-audiolibrarian/audiofile/formats/mp3.py,sha256=ipuanK7CIYSk9LqW0AvAgKAUZeU9ecwK0uZf2AhAGXo,12881
-picard_src/README.md,sha256=mtJ7RNLlC7Oz9M038WU-3ciPa7jPdXlFLYdJBL8iRQo,411
-picard_src/__init__.py,sha256=acu0-oac_qfEgiB0rw0RvuL---O15-rOckWboVMxWtM,198
-picard_src/textencoding.py,sha256=0MRHFwhqEwauQbjTTz6gpgzo6YH1VDPfdJqQoCWHtjM,26234
-audiolibrarian-0.16.4.dist-info/METADATA,sha256=_odZKLK0zulvGlhQs-bwdns_cUleRO49K1tpcT2qrdk,10476
-audiolibrarian-0.16.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-audiolibrarian-0.16.4.dist-info/entry_points.txt,sha256=reubnr_SGbTTDXji8j7z8aTmIL0AEQKVSLcnmFG3YYY,59
-audiolibrarian-0.16.4.dist-info/licenses/COPYING,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-audiolibrarian-0.16.4.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-audiolibrarian-0.16.4.dist-info/RECORD,,