{"id":23550173,"url":"https://github.com/yashhere/beautifymp3","last_synced_at":"2025-06-17T01:03:51.647Z","repository":{"id":105118574,"uuid":"94624373","full_name":"yashhere/BeautifyMP3","owner":"yashhere","description":"A command line tool for fixing ID3 metadata and adding Album Art to MP3 songs","archived":false,"fork":false,"pushed_at":"2019-11-24T09:30:23.000Z","size":24,"stargazers_count":29,"open_issues_count":3,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-28T10:57:55.956Z","etag":null,"topics":["album-art","cli","eyed3","genius-api","genius-lyrics-search","id3","id3v2","lyrics","meta-tags","metadata-management","mit-license","mp3","music","python","python3","spotify","spotify-api","vscode"],"latest_commit_sha":null,"homepage":"https://yash2696.github.io/BeautifyMP3","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/yashhere.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2017-06-17T13:08:10.000Z","updated_at":"2024-10-24T16:41:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"1d0dfe50-d3c8-4173-8008-08fcd6230d70","html_url":"https://github.com/yashhere/BeautifyMP3","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yashhere/BeautifyMP3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashhere%2FBeautifyMP3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashhere%2FBeautifyMP3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashhere%2FBeautifyMP3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashhere%2FBeautifyMP3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashhere","download_url":"https://codeload.github.com/yashhere/BeautifyMP3/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashhere%2FBeautifyMP3/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260269423,"owners_count":22983642,"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":["album-art","cli","eyed3","genius-api","genius-lyrics-search","id3","id3v2","lyrics","meta-tags","metadata-management","mit-license","mp3","music","python","python3","spotify","spotify-api","vscode"],"created_at":"2024-12-26T10:13:47.875Z","updated_at":"2025-06-17T01:03:51.632Z","avatar_url":"https://github.com/yashhere.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"left\"\u003e\n    \u003ca href=\"https://github.com/yash2696/BeautifyMP3/LICENSE\"\u003e\n\t\t\u003cimg alt=\"License\"  src=\"https://img.shields.io/github/license/mashape/apistatus.svg?style=flat-square\"/\u003e\n\t\u003c/a\u003e           \n\u003c/p\u003e\n\n## Table of Contents\n\n- [Features](#features)\n- [Dependencies](#dependencies)\n- [Installing](#installing)\n  - [Source](#source)\n- [Usage](#usage)\n  - [Options](#options)\n- [Contribute](#contribute)\n- [License](#license)\n\n\n## Features\n\n1. Fixes metadata of songs based on data received from Spotify\n2. Fetches lyrics from [Genius](https://www.genius.com)\n3. Fetches metadata from [Spotify](https://www.spotify.com)\n4. Can format filenames of songs\n5. Can fetch data for a single song or complete directory\n\n## Dependencies  \n\n### [Genius API](https://genius.com/api-clients) \n\n1. Create an account and register an application \n2. Grab Access Token\n3. Set access token in config file\n\n\n### [Spotify API](https://developer.spotify.com/my-applications/#!/applications/create) \n\n1. Create an account and register an application \n2. Grab Client ID and client Secret Code\n3. Set both in config file\n\n```sh \n$ python addMetadata.py --config                                               \n\nEnter Genius key : \u003center genius key\u003e \n\nEnter Spotify Secret token : \u003center client secret here\u003e \n\nEnter Spotify Client ID : \u003center client id here\u003e                               \n```\n\n## Installing\n\n### Source\n```sh\n$ git clone https://github.com/yash2696/BeautifyMP3\n$ cd BeautifyMP3\n$ python setup.py install\n```\n\n### Options\n```sh\n(music-tagger) ~/D/music-tagger ❯❯❯ python addMetadata.py -h\nusage: addMetadata.py [-h] [-d REPAIR_DIRECTORY] [-s SONG_NAME] [-c] [-n]\n                      [-f RENAME_FORMAT]\n\n ____                   _   _  __       __  __ ____ _____ \n| __ )  ___  __ _ _   _| |_(_)/ _|_   _|  \\/  |  _ \\___ / \n|  _ \\ / _ \\/ _` | | | | __| | |_| | | | |\\/| | |_) ||_ \\ \n| |_) |  __/ (_| | |_| | |_| |  _| |_| | |  | |  __/___) |\n|____/ \\___|\\__,_|\\__,_|\\__|_|_|  \\__, |_|  |_|_|  |____/ \n                                  |___/                   \n                                  \n______________________________________________________________\n|                                                            |\n|       Edit Metadata of MP3 files based on file name        |\n|____________________________________________________________|\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -d REPAIR_DIRECTORY, --dir REPAIR_DIRECTORY\n                        give path of music files directory\n  -s SONG_NAME, --song SONG_NAME\n                        Only fix metadata of the file specified\n  -c, --config          Add API Keys to config\n  -n, --norename        Does not rename files to song title\n  -f RENAME_FORMAT, --format RENAME_FORMAT\n                        Specify the Name format used in renaming, Valid\n                        Keywords are: {title}{artist}{album} )\n```\n\n## TODO\n- [ ] Add download functionality from youtube\n- [ ] add support for last.fm and soundcloud if spotify fails\n- [ ] add support for metrolyrics and other lyrics service if genius api fails\n- [ ] add support for searching with existing id3 tags if searching with name fails\n- [ ] somehow find a way to properly synchronize the lyrics with sound if possible\n- [ ] add support for other file types(aac, flac etc)\n\n## Contribute\n\nFound an issue? Post it in the [issue tracker](https://github.com/yash2696/BeautifyMP3/issues). \u003cbr\u003e \nWant to add another awesome feature? [Fork](https://github.com/yash2696/BeautifyMP3/fork) this repository and add your feature, then send a pull request.\n\n## Disclaimer\n\nThe inspiration for this project is [MusicRepair](https://github.com/kalbhor/MusicRepair). \n\nDownloading copyright songs is illegal in most of the countries. I made this tool for educational purposes and was created for my python learning process. Please support the artists by buying their music.\n\n## License\nThe MIT License (MIT)\nCopyright (c) 2017 Yash Agarwal\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashhere%2Fbeautifymp3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashhere%2Fbeautifymp3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashhere%2Fbeautifymp3/lists"}