🎵 MP3 Tag Reader & Editor (ID3v2) in C

A command-line MP3 Tag Reader and Editor developed in C that reads and edits ID3v2 metadata from MP3 files without using any external libraries.

The project directly parses the binary structure of ID3v2 tags using C file handling concepts, allowing users to view and modify metadata such as Title, Artist, Album, Year, Genre (Content), and Composer.

---

🚀 Features

📖 View MP3 Metadata

Display the following ID3v2 tags:

• 🎵 Title
• 🎤 Artist
• 💿 Album
• 📅 Year
• 🎼 Genre (Content)
• ✍️ Composer

---

✏️ Edit MP3 Metadata

Supports editing the following tags:

Option	Frame ID	Description
-t	TIT2	Title
-a	TPE1	Artist
-A	TALB	Album
-y	TYER	Year
-m	TCON	Genre / Content
-c	TCOM	Composer

---

✨ Project Highlights

• Binary file parsing
• ID3v2 metadata processing
• In-place metadata editing
• Big Endian frame size handling
• Dynamic frame traversal
• Command-line interface
• Input validation
• Error handling
• Memory-safe implementation
• Modular code structure

---

📂 Project Structure

.
├── main.c
├── main.h
├── functions.c
├── read_metadata.c
├── edit_metadata.c
├── display.c
├── sample.mp3
└── README.md

---

⚙️ How It Works

View Metadata

./a.out -v sample.mp3

Edit Metadata

./a.out -e -t "New Title" sample.mp3
./a.out -e -a "New Artist" sample.mp3
./a.out -e -A "New Album" sample.mp3
./a.out -e -y 2026 sample.mp3
./a.out -e -m "Pop" sample.mp3
./a.out -e -c "New Composer" sample.mp3

Help

./a.out --help

---

📸 Project Demo

Help Menu & View Metadata

---

Editing Title, Artist, Album & Year

---

Editing Genre (Content), Composer & Final Output

---

Validation & Error Handling

The application validates:

• Invalid command-line arguments
• Unsupported edit options
• Non-MP3 files
• Missing ID3 tags
• Oversized replacement strings
• Invalid user input

---

🛠️ Concepts Used

C Programming

• Functions
• Arrays
• Strings
• Structures
• Pointers
• Dynamic Memory Allocation
• Command Line Arguments

File Handling

• fopen()
• fread()
• fwrite()
• fseek()
• ftell()

Binary File Processing

• Frame Parsing
• Big Endian Integer Conversion
• Byte-level Data Manipulation

Data Structures

• Structures
• Buffers

---

🧠 Technical Challenges Solved

• Parsing binary ID3v2 frame structure
• Converting Big Endian frame sizes
• Editing metadata without corrupting adjacent frames
• Handling variable-length metadata safely
• Traversing MP3 frame headers correctly
• Implementing in-place updates
• Preventing buffer overflows
• Validating frame sizes before editing

---

📌 Future Improvements

• Support ID3v2.4
• Add Album Art (APIC) support
• Support UTF-16 encoded tags
• Add command to create missing tags
• Add backup before editing
• Add colored CLI output

---

🧪 Tested On

• Ubuntu (WSL)
• GCC Compiler
• ID3v2.3 MP3 Files

---

👨‍💻 Author

Yogesh B

Embedded C | C Programmer | Electronics & Communication Engineer

---

⭐ If you found this project interesting, consider giving it a star!