{"id":29138620,"url":"https://github.com/ivan-ayub97/metatag","last_synced_at":"2025-06-30T14:10:38.234Z","repository":{"id":298597690,"uuid":"1000490490","full_name":"Ivan-Ayub97/Metatag","owner":"Ivan-Ayub97","description":"A modern audio metadata editor with MusicBrainz integration, cover art support, and an intuitive interface","archived":false,"fork":false,"pushed_at":"2025-06-11T22:46:25.000Z","size":1750,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-11T23:36:25.629Z","etag":null,"topics":["audio","metadata-editor","metadata-management","music","musicbrainz","musicbrainz-api","mutagen","pyqt5-desktop-application","python","qt5-gui","tag"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ivan-Ayub97.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T21:44:00.000Z","updated_at":"2025-06-11T22:49:04.000Z","dependencies_parsed_at":"2025-06-11T23:36:29.068Z","dependency_job_id":"9e8ef2f3-89b7-4c4c-8f08-14f7f372ff0f","html_url":"https://github.com/Ivan-Ayub97/Metatag","commit_stats":null,"previous_names":["ivan-ayub97/metatag"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Ivan-Ayub97/Metatag","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetatag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetatag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetatag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetatag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ivan-Ayub97","download_url":"https://codeload.github.com/Ivan-Ayub97/Metatag/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ivan-Ayub97%2FMetatag/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262788745,"owners_count":23364399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","metadata-editor","metadata-management","music","musicbrainz","musicbrainz-api","mutagen","pyqt5-desktop-application","python","qt5-gui","tag"],"created_at":"2025-06-30T14:10:37.317Z","updated_at":"2025-06-30T14:10:38.226Z","avatar_url":"https://github.com/Ivan-Ayub97.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[Download the EXE from Google Drive](https://drive.google.com/file/d/1noVr8WXN2tWL-xoOV3PKoUF0mCyapiUl/view?usp=sharing)\r\n![Metatag](Banner.png)\r\n\r\nA modern audio metadata editor with **MusicBrainz** integration, cover art support, and an intuitive interface\r\n\r\n---\r\n\r\n## Contributions\r\n\r\nContributions are welcome!\r\n\r\n1. Fork the repository.\r\n2. Create a branch for your feature or fix.\r\n3. Submit a Pull Request with a clear description.\r\n\r\nFor bug reports or suggestions, contact me at: [negroayub97@gmail.com](mailto:negroayub97@gmail.com).\r\n\r\n---\r\n\r\n## 📸 Interface Preview\r\n\r\n### 🔹 General Interface\r\n\r\n![Edit Tags](Captures/Edit_Options.png)\r\n\r\n### 🔹 MusicBrainz Search\r\n\r\n![Search UI](Captures/Search_UI.png)\r\n\r\n### 🔹 MusicBrainz Submission\r\n\r\n![Submit UI](Captures/Submission_UI.png)\r\n\r\n---\r\n\r\n## ✨ Key Features\r\n\r\n### 🎧 Metadata Editing\r\n\r\n- Supports `.mp3`, `.flac`, `.m4a`, `.ogg` files\r\n- Edit title, artist, album, year, genre, track number, comments\r\n\r\n### 🖼️ Album Art\r\n\r\n- Add, change, or remove cover art\r\n- Preview embedded artwork\r\n- Supports `.jpg`, `.png` images\r\n\r\n### 🌐 MusicBrainz Integration\r\n\r\n- Search and auto-apply metadata from MusicBrainz\r\n- Submit new releases directly from the app\r\n\r\n### 🧠 Automation\r\n\r\n- Rename files using custom patterns\r\n- Autofill forms using existing metadata\r\n- Visual indicators for unsaved changes\r\n\r\n### 🛡️ Error Handling\r\n\r\n- Safe error recovery\r\n- Robust handling of malformed files\r\n\r\n---\r\n\r\n## 🛠️ Development Status — v3.0\r\n\r\n| Component            | Status         | Notes                                                  |\r\n| -------------------- | -------------- | ------------------------------------------------------ |\r\n| Metadata Editing     | 🟢 Complete    | Per-field editing, supports multiple formats           |\r\n| Album Art            | 🟢 Complete    | Preview + editing integrated                           |\r\n| MusicBrainz (Search) | 🟢 Complete    | Search by artist/album, select and apply release       |\r\n| MusicBrainz (Submit) | 🟡 Functional  | Requires authentication, community-reviewed submission |\r\n| File Renaming        | 🟢 Complete    | Pattern-based renaming like `%artist% - %title%`       |\r\n| GUI Interface        | 🟢 Improved    | Dark theme, responsive layout                          |\r\n| Drag \u0026 Drop          | 🟢 Implemented | Drag files directly into the table                     |\r\n\r\n---\r\n\r\n## 🎮 How to Use\r\n\r\n1. Launch the app.\r\n\r\n2. Select your audio files using the **\"Load Files\"** button.\r\n\r\n3. Select a file to edit its metadata individually.\r\n\r\n4. Optional: Use MusicBrainz search or submit a new release from within the app.\r\n\r\n---\r\n\r\n## 📦 Dependencies\r\n\r\n### Core\r\n\r\n- `PyQt5` (\u003e=5.15.0)\r\n- `mutagen` (\u003e=1.45.1)\r\n- `musicbrainzngs` (\u003e=0.7.1)\r\n- `qtawesome`\r\n- `requests`\r\n\r\n---\r\n\r\n## 🔥 Recent Enhancements\r\n\r\n- ✅ MusicBrainz submission from within the interface\r\n- ✅ Smart file renaming\r\n- ✅ Search and apply metadata\r\n- ✅ Visual cover art editor\r\n\r\n---\r\n\r\n## ⚠️ Known Issues\r\n\r\n- MusicBrainz submission requires authentication and may fail due to API issues\r\n- Large files may cause performance issues\r\n\r\n---\r\n\r\n## 💻 System Requirements\r\n\r\n- Python 3.7+\r\n- All listed dependencies installed\r\n- A working `ffmpeg` setup in the system\r\n\r\n---\r\n\r\n## 📄 License\r\n\r\nDistributed under the **[MIT License](LICENSE)**.\r\n\r\n---\r\n\r\n## 👤 Author\r\n\r\n**Iván Eduardo Chavez Ayub**\r\n🔗 [GitHub](https://github.com/Ivan-Ayub97)\r\n📧 [negroayub97@gmail.com](mailto:negroayub97@gmail.com)\r\n🛠️ Tech: Python, PyQt5, mutagen, MusicBrainz API\r\n\r\n---\r\n\r\n## 🌟 Why Metatag?\r\n\r\nBecause you need a **simple, powerful, and beautiful** metadata editor.\r\nMetatag is an **open, intuitive, and evolving** tool built with creators in mind.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-ayub97%2Fmetatag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivan-ayub97%2Fmetatag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-ayub97%2Fmetatag/lists"}