MP3TagCleaner remove unwanted "year" (date) tags from MP3 files using a simple Python utility powered by Mutagen. Clean individual files or entire folders with optional verbose logging.
- Remove
date(year) tag from MP3 metadata - Clean individual MP3 files or entire directories
- Optional verbose logging
- Built using
mutagen.easyid3andmutagen.id3 - Lightweight and dependency-light
- Python 3.6+
- mutagen
Install Mutagen with pip:
pip install mutagengit clone https://github.com/neoslab/mp3tagcleaner
cd mp3tagcleanerpython mp3tagcleaner.pycleaner.cleanfromfile(r"C:\Users\YourName\Music\song.mp3")cleaner.cleanfromfolder(r"C:\Users\YourName\Music")mp3tagcleaner.py # Main script containing MP3TagCleaner class
README.md # Project documentation
[OK] Removed year tag from: C:\Users\YourName\Music\song1.mp3
[SKIP] No year tag found in: C:\Users\YourName\Music\song2.mp3
[ERROR] Cannot process C:\Users\YourName\Music\badfile.mp3: ...
- Eliminate unnecessary or incorrect
yearmetadata from MP3s - Standardize your media files for automation tools or streaming
- Quickly clean up messy downloads and audio archives
Contributions are welcome! Please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature). - Make your changes and commit them (
git commit -m "Add your feature"). - Push to your branch (
git push origin feature/your-feature). - Open a pull request with a clear description of your changes.
Ensure your code follows PEP 8 style guidelines and includes appropriate tests.
This project is licensed under the MIT License. See the LICENSE file for details.
For issues, suggestions, or questions, please open an issue on GitHub or contact the maintainer at GitHub Issues.