Metadata-Version: 2.4
Name: audio-media-utils
Version: 0.1.0
Summary: Utilities for yt-dlp audio downloads and simple mutagen metadata workflows
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mutagen<2.0,>=1.47
Provides-Extra: dev
Requires-Dist: pytest<10,>=9; extra == "dev"
Requires-Dist: pytest-cov<7,>=6; extra == "dev"
Requires-Dist: sphinx<9,>=8; extra == "dev"

# audio_media_utils

Utilities for audio-oriented download workflows and simple metadata editing.

This repository is intentionally focused on reusable domain helpers for:

- YouTube and `yt-dlp` download helpers
- playlist detection and expansion
- simple audio metadata reads and writes with `mutagen`
- filename and path helpers for tagged audio files

It does not include worker loops, logging infrastructure, Docker wiring, or service-specific orchestration.

## Planned package layout

```txt
src/audio_media_utils/
|-- youtube/
|   |-- models.py
|   |-- urls.py
|   |-- ytdlp_runner.py
|   |-- playlists.py
|   `-- downloads.py
|-- audio/
|   |-- models.py
|   |-- mutagen_tags.py
|   |-- files.py
|   `-- naming.py
`-- exceptions.py
```
