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

audiolibrarian/__init__.py

@@ -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.16.5"

audiolibrarian/audiosource.py

@@ -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/commands.py

@@ -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

@@ -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

@@ -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-0.16.5.dist-info/METADATA

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: audiolibrarian
+Version: 0.16.5
+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: 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.16.4.dist-info → audiolibrarian-0.16.5.dist-info}/RECORD

@@ -1,10 +1,10 @@
-audiolibrarian/__init__.py,sha256=VVNnoovlK4Pl3YDm2ETbU5q14mKK3UH6PvNQIVxNq7Y,787
-audiolibrarian/audiosource.py,sha256=EtoSQb6R2zfHUwxiR9ZqGwjxrX2mTB5gPpmKangps4s,8573
+audiolibrarian/__init__.py,sha256=gY9TxON-FJ8rKpy6s2RKFMpH0qMDrgDtE9Nn6q8xIjM,787
+audiolibrarian/audiosource.py,sha256=hQVFc2VQfCPV1kQRGOwwNAuMx4AXno0zcf_0Ps_Y2ts,8545
 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/commands.py,sha256=4oyXDSvzlL2vb1SyD2GVy8bDD9MTJz9IuTMl2PMLOQ4,11166
+audiolibrarian/genremanager.py,sha256=omjsn-8Bdz3etLu-qNAXhPUOyY4Byy6muwvkHyPM6so,7357
+audiolibrarian/musicbrainz.py,sha256=GwTrwvn-hLZw4uLD7CshyegLCM1tfeNL00rqz2Xsl20,19312
 audiolibrarian/output.py,sha256=JHuttwEMEzUxty7P8e2jaL6702q52fTWAdZEgb85bxQ,1702
 audiolibrarian/records.py,sha256=BovHwNVd0nTTwQPYkhOAOIVASWz9l47j6cGdXAx5VjM,7929
 audiolibrarian/settings.py,sha256=qKQ9JYfKr2k_JceWfYPiMlpBKylujCQI_2pmxWpsGFo,2550
@@ -20,9 +20,9 @@ audiolibrarian/audiofile/formats/mp3.py,sha256=ipuanK7CIYSk9LqW0AvAgKAUZeU9ecwK0
 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,,
+audiolibrarian-0.16.5.dist-info/METADATA,sha256=m92zy8tCb5anGh-_ltl2Hca0jkB8QRW6locAtVnuskQ,2546
+audiolibrarian-0.16.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+audiolibrarian-0.16.5.dist-info/entry_points.txt,sha256=reubnr_SGbTTDXji8j7z8aTmIL0AEQKVSLcnmFG3YYY,59
+audiolibrarian-0.16.5.dist-info/licenses/COPYING,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+audiolibrarian-0.16.5.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
+audiolibrarian-0.16.5.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"
-```