Metadata-Version: 2.4
Name: retag
Version: 0.1.1
Summary: Identify and retag mislabeled audio files using audio fingerprinting
Author-email: IRON-M4N <ironmanwasgone@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/IRON-M4N/retag
Project-URL: Repository, https://github.com/IRON-M4N/retag
Project-URL: Bug Tracker, https://github.com/IRON-M4N/retag/issues
Keywords: audio,mp3,metadata,tags,fingerprint,music
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0
Requires-Dist: mutagen>=1.47
Requires-Dist: httpx>=0.27
Dynamic: license-file

# retag

Identify and retag mislabeled audio files using acoustic fingerprinting.

---

## Requirements

- Python 3.9+
- [ffmpeg](https://ffmpeg.org/)
- An API key from [AudD](https://audd.io) or [ACRCloud](https://acrcloud.com)

**Install ffmpeg**

```
# macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
# Download from https://ffmpeg.org
```

---

## Installation

```
pip install retag
```

Or from source:

```
git clone https://github.com/IRON-M4N/retag.git
cd retag
pip install -e .
```


## Usage

```
retag <path>                         Scan, identify and tag
retag <path> --interactive           Step-by-step guided mode
retag <path> --dry-run               Preview without writing changes
retag <path> --resume                Skip files already processed
retag get <file|folder>              Inspect embedded metadata
retag get <file> --extract-cover     Extract embedded cover art
```

---


**All flags**

```
-i, --interactive     Step-by-step guided mode
--overwrite, -f       Retag files that already have tags
--keep-name           Keep original filenames
--no-cover            Skip cover art embedding
--clear-cache         Clear cached state for a folder
--dry-run             Preview changes without writing
--resume              Skip already-processed files
--provider P          Force a provider: audd or acrcloud
--confidence N        Minimum confidence score (default: 60)
--format EXT,...      Limit to specific formats, e.g. mp3,flac
--audd-token TOKEN    AudD API key
--acr-key KEY         ACRCloud access key
--acr-secret SEC      ACRCloud access secret
--version             Show version
```
supports almost all audio formats 

---


<div align="center">

\$\frac{\text{Made with } \heartsuit \text{ by IRON-M4N}}{\text{2025 - 6969}}\$

</div>
