GitHub • Docs • Contributing • Releases • Discord

🎧 Automated MP3 Tag Editor CLI

Your sleek, local-first, blazing-fast Terminal User Interface CLI for editing MP3 tags — powered by Rust, and Ratatui.

No ads. No upload. No BS. Just edit your music.

---

🔥 Features

• 🔍 Auto-fetch metadata (title, artist, album, genre, etc.)
• 🖼️ Cover art support (upcoming!)
• 💾 Batch edit MP3 files
• 🧠 AI-enhanced guessing (based on filename patterns)
• 🧑‍💻 Manual overrides
• 🌗 Light & Dark mode
• 🧩 Cross-platform (macOS, Windows, Linux)

---

💻 Tech Stack

Layer	Tech
UI	Ratatui
Backend	Rust

---

🚀 Getting Started

Prerequisites

• Rust

Setup Instructions

```bash

Clone the repository

git clone https://github.com/Mp3-Automated-Tag-Editor/Automated-Mp3-CLI cd Automated-Mp3-CLI

Build the app

cargo build --release

Run the app

cargo run ```

---

🛠️ Development Notes

• Written in modular Rust
• Terminal UI built with Ratatui
• Uses Lofty for tag parsing and writing

---

📸 Screenshots

---

✅ TaskList / Roadmap

v1.0.0

• Basic file picker & tag editor
• Auto metadata from file names
• Save changes to disk

v1.1.0

• Cover art support
• MusicBrainz integration
• Tag presets & templates
• Folder scanning
• Export metadata as JSON/CSV

---

💬 Community

• Discord: [Coming Soon]
• Suggest a feature or report a bug via Issues
• Contribute via Pull Requests

---

🙏 Acknowledgments

• Lofty-RS
• Ratatui
• MusicBrainz
• Open-source contributors around the globe ❤️

---

📜 License

MIT © 2025 [Your Name]. See LICENSE for more details.

Music is life — tag it right. 🎶