{"id":28288874,"url":"https://github.com/gitmotion/audio-metadata-updater","last_synced_at":"2025-08-20T15:42:00.392Z","repository":{"id":194881803,"uuid":"691777163","full_name":"gitmotion/audio-metadata-updater","owner":"gitmotion","description":"Programmatically update meta data of audio files in a given directory and specified file type using python \u0026 mutagen.easyid3","archived":false,"fork":false,"pushed_at":"2023-09-15T19:57:16.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-22T00:13:49.838Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitmotion.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-14T21:43:11.000Z","updated_at":"2024-11-02T06:47:12.000Z","dependencies_parsed_at":"2024-06-25T20:42:50.611Z","dependency_job_id":"18212525-455b-4e78-9942-b5fc9b28405f","html_url":"https://github.com/gitmotion/audio-metadata-updater","commit_stats":null,"previous_names":["gitchrishan/audio-metadata-updater","gitmotion/audio-metadata-updater"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gitmotion/audio-metadata-updater","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitmotion%2Faudio-metadata-updater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitmotion%2Faudio-metadata-updater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitmotion%2Faudio-metadata-updater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitmotion%2Faudio-metadata-updater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitmotion","download_url":"https://codeload.github.com/gitmotion/audio-metadata-updater/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitmotion%2Faudio-metadata-updater/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260579600,"owners_count":23031213,"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":[],"created_at":"2025-05-22T00:13:41.623Z","updated_at":"2025-08-20T15:42:00.369Z","avatar_url":"https://github.com/gitmotion.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# audio-metadata-updater\n- Uses \u003ccode\u003emutagen.easyid3\u003c/code\u003e\n- Add songs files to a given directory\n- Generate / create a .json file that contains all the metadata you want to update\n- current supported metadata fields: \u003ccode\u003etitle, artist, album, tracknumber, composer, albumartist, discnumber, copyright\u003c/code\u003e\n- Comes with error handling and will list out files that failed to update at the end of the log\n\n\u003cb\u003eNote: File name will be used as the key in the metadata.json file and must be configured accordingly\u003c/b\u003e\n\u003c/br\u003e\n- Certain special characters (?, \u003e, \u003c, etc) can't be added to file names and will need to be taken out of the .json file keys to account for this\n- However you can still add them in the metadata info\n- As long as the file name and the keys in the metadata.json match up you can essentially use any identifier\n\n![specialcharacterexample](https://github.com/gitchrishan/audio-metadata-updater/assets/43588713/9533db9e-ca65-47f3-a808-02494734dfd5)\n\n \n# Execution\n\u003cb\u003eDebugging:\u003c/b\u003e\n\u003c/br\u003e\n![debugmodeexecution](https://github.com/gitchrishan/audio-metadata-updater/assets/43588713/44482a26-188e-401a-9982-776453dbc391)\n- uncomment following lines and comment lines after\n\u003c/br\u003e\n\n![debug_mode](https://github.com/gitchrishan/audio-metadata-updater/assets/43588713/d5bf55b1-ee0c-4835-b3d1-d06749708152)\n- this will allow you to input the arguments\n\n\u003cb\u003eTerminal:\u003c/b\u003e\n- ![terminalexecution](https://github.com/gitchrishan/audio-metadata-updater/assets/43588713/969a1c47-c934-4141-b5c2-7bd728d44fbf)\n  - uncomment following lines and comment lines before\n- Using \u003ccode\u003epython\u003c/code\u003e, execute as such:\n  \u003cdiv\u003e\n    \u003ccode\u003epython path/to/amdu.py /path/to/song/directory .mp3 /path/to/metadata.json\u003c/code\u003e\n    \u003c/br\u003e\n    Or\n    \u003c/br\u003e\n    \u003ccode\u003epython .\\amdu.py '.\\AUDIO_FILE_DIRECTORY\\' .mp3 '.\\metadata.json'\u003c/code\u003e (powershell)\n  \u003c/div\u003e\n  - you can use any audio file extensions supported by mutagen (see documentation)\n- This will grab all *.mp3 files (or any other specified extensions) in the given directory and parse the metadata.json file and match them accordingly\n\n# Demo \u0026 Results\n\u003cb\u003eDemo:\u003c/b\u003e\n\u003c/br\u003e\n![amdu demo](https://github.com/gitchrishan/audio-metadata-updater/assets/43588713/5cc62b9a-4efd-4e51-8041-35fbb65f9760)\n\n\u003cb\u003eBefore:\u003c/b\u003e\n\u003c/br\u003e\n![before](https://github.com/gitchrishan/audio-metadata-updater/assets/43588713/4c919f56-dcd0-4f24-9209-359f4d24a701)\n\n\u003cb\u003eAfter:\u003c/b\u003e\n\u003c/br\u003e\n![after](https://github.com/gitchrishan/audio-metadata-updater/assets/43588713/993da10c-ef44-4dd0-b36d-a03ce8536dc8)\n\n\u003cb\u003eView Log:\u003c/b\u003e\n\u003c/br\u003e\n[amdu-demo-log.txt](https://github.com/gitchrishan/audio-metadata-updater/files/12614815/amdu-demo-log.txt)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitmotion%2Faudio-metadata-updater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitmotion%2Faudio-metadata-updater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitmotion%2Faudio-metadata-updater/lists"}