🧹 Metadata Cleaner 🔍

📌 Overview

Metadata Cleaner is a powerful CLI tool that removes, edits, and views metadata in:

• Images: JPG, PNG, TIFF, WEBP
• Documents: PDF, DOCX, TXT
• Audio: MP3, WAV, FLAC
• Videos: MP4, MKV, AVI

It features:

• ✅ Batch processing for multiple files.
• 🔄 Recursive folder scanning.
• ⚡ Parallel execution for performance.
• 📜 Selective metadata filtering.
• 📊 Detailed logging & error handling.

---

🚀 Installation

1️⃣ Using Poetry (Recommended)

git clone https://github.com/sandy-sp/metadata-cleaner.git
cd metadata-cleaner
poetry install
poetry run metadata-cleaner --help

2️⃣ Install via PyPI

pip install metadata-cleaner
metadata-cleaner --help

---

📖 Usage Guide

View Metadata

metadata-cleaner view sample.jpg

Example Output:

{
    "Make": "Canon",
    "Model": "EOS 80D",
    "DateTimeOriginal": "2023:01:20 14:22:35"
}

Remove Metadata

metadata-cleaner delete sample.jpg

Output:

✅ Metadata removed: sample_cleaned.jpg

Batch Processing

metadata-cleaner delete --folder my_photos --recursive

---

📊 Logging & Debugging

• Log File: logs/metadata_cleaner.log
• Set Debug Mode:

  METADATA_CLEANER_LOG_LEVEL=DEBUG metadata-cleaner delete sample.jpg

---

📬 Contributing

1. Fork the repository.
2. Create a new branch (feature-branch).
3. Submit a pull request.

---

🔗 Resources

• API Reference
• Usage Guide

---