audiolibrarian 0.16.3__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.3"
+__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.3.dist-info → audiolibrarian-0.16.5.dist-info}/RECORD

@@ -1,10 +1,10 @@
-audiolibrarian/__init__.py,sha256=TA0WxXg92zvPld0b_-oYxDuKp-7Svu7k09p45NcRxBk,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
@@ -17,12 +17,12 @@ audiolibrarian/audiofile/formats/__init__.py,sha256=ZV5urTtQQ4ZX_K2s9qFsSzDunvdQ
 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=TTnzIGmZ8_G11G1VCz5DHdlidIrtkGFYxWFooyTKcbI,403
+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.3.dist-info/METADATA,sha256=2nYUbyqd_w-sUmlSMhwYGUk2rvqKjbLeyPdtFddOfUQ,10533
-audiolibrarian-0.16.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-audiolibrarian-0.16.3.dist-info/entry_points.txt,sha256=reubnr_SGbTTDXji8j7z8aTmIL0AEQKVSLcnmFG3YYY,59
-audiolibrarian-0.16.3.dist-info/licenses/COPYING,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-audiolibrarian-0.16.3.dist-info/licenses/LICENSE,sha256=WJ7YI-moTFb-uVrFjnzzhGJrnL9P2iqQe8NuED3hutI,35141
-audiolibrarian-0.16.3.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,,

picard_src/README.md

@@ -2,10 +2,10 @@
 
 Code in this directory comes from (or is derived from) the super-cool Picard project.
 
-https://github.com/metabrainz/picard
+[Picard](https://github.com/metabrainz/picard)
 
 I'd like to express my thanks to all of have contributed to that project.
 
-Note: we could have just set the Picard library as a dependency of audiolibrarian, but 
-it includes other dependencies (such as PyQT) that add a lot of overhead not required 
+Note: we could have just set the Picard library as a dependency of audiolibrarian, but
+it includes other dependencies (such as PyQT) that add a lot of overhead not required
 by this project.

audiolibrarian-0.16.3.dist-info/METADATA

@@ -1,328 +0,0 @@
-Metadata-Version: 2.4
-Name: audiolibrarian
-Version: 0.16.3
-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 powerful command-line tool for managing digital music libraries. It provides a streamlined 
-workflow for ripping, converting, organizing, and tagging audio files with high-quality metadata from MusicBrainz.
-
-### 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
-- **Scriptable**: Perfect for automating large music library management tasks
-- **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 ##
-
-### External Requirements ###
-
-`audiolibrarian` uses a few command-line tools to run:
-
-* `cd-paranoia`: [cd-paranoia](https://www.gnu.org/software/libcdio/)
-* `eject`: [util-linux](https://github.com/util-linux/util-linux)
-* `faad`: [faad2](https://github.com/knik0/faad2)
-* `fdkaac`: [fdkaac](https://github.com/nu774/fdkaac)
-* `flac`: [flac](https://github.com/xiph/flac)
-* `lame`: [lame](https://lame.sourceforge.io/)
-* `mpg123`: [mpg123](https://www.mpg123.de/)
-* `sndfile-convert`: [libsndfile](https://github.com/libsndfile/libsndfile)
-* `wavegain`: [wavegain](https://rarewares.org/others.php) 
-
-### 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
-     export AUDIOLIBRARIAN__LIBRARY_DIR="/mnt/music/library"
-     
-     # Set MusicBrainz credentials
-     export AUDIOLIBRARIAN__MUSICBRAINZ__USERNAME="your_username"
-     export AUDIOLIBRARIAN__MUSICBRAINZ__PASSWORD="your_password"
-     ```
-
-2. **YAML Configuration File**
-   - Location: `~/.config/audiolibrarian/config.yaml` (or `$XDG_CONFIG_HOME/audiolibrarian/config.yaml` if set)
-   - 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` (in the current dir)   | Directory for storing audio files         |
-| `work_dir`               | `$XDG_CACHE_HOME/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                  |
-
-> **Note**: The `musicbrainz` section is optional but recommended for accessing personal genre preferences on [MusicBrainz](https://musicbrainz.org/).
-
-## 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
-```
-
-### 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.
-
-### Advanced Usage ###
-
-1. **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
-```
-
-2. **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
-```
-
-2. **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 "12345678-1234-1234-1234-123456789012" /path/to/audio/files
-```
-
-3. **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
-```
-
-4. **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
-```
-
-5. **Using Different Normalization Presets**
-
-```bash
-# Use radio normalization preset (default)
-export AUDIOLIBRARIAN__NORMALIZE_PRESET="radio"
-
-# Use album normalization preset
-export AUDIOLIBRARIAN__NORMALIZE_PRESET="album"
-```
-
-### Troubleshooting ###
-
-1. **Increasing Verbosity**
-
-```bash
-# Show more detailed output
-audiolibrarian --log-level INFO cd
-
-# Show debug information
-audiolibrarian --log-level DEBUG cd
-```
-
-2. **Checking Dependencies**
-
-```bash
-# Verify all required tools are installed
-audiolibrarian --log-level DEBUG cd
-```
-
-3. **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"
-```
-
-### Directory Structure ###
-
-`audiolibrarian` organizes files in the following structure:
-
-1. **Source files** (original audio files):
-   ```
-   library/source/
-   └── Artist/
-       └── YYYY__Album/
-           ├── 01__Track_Title.flac
-           ├── 02__Another_Track.flac
-           └── Manifest.yaml
-   ```
-
-2. **Processed audio files** (organized by format):
-   ```
-   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
-   ```
-
-Each track filename follows the format: `track_number__track_name.extension` (e.g., `01__Call_to_Arms.flac`).