{"id":20894512,"url":"https://github.com/mxmarchal/metasong","last_synced_at":"2026-04-11T22:06:41.999Z","repository":{"id":221743643,"uuid":"754802897","full_name":"mxmarchal/metasong","owner":"mxmarchal","description":"🎵 Audio Metadata Extractor - Python script extracts metadata and find lyrics from MP3 files in an album folder, utilizing multiprocessing for efficiency. Powered by Hugging Face's Transformers library and OpenAI's GPT-3.5 Turbo API.","archived":false,"fork":false,"pushed_at":"2024-02-10T13:10:39.000Z","size":43,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-19T12:13:49.123Z","etag":null,"topics":["audio","genius","genius-api","gpt-35-turbo","lyrics","metadata","metadata-extractor","multiprocessing","openai","transformers"],"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/mxmarchal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-02-08T19:47:14.000Z","updated_at":"2024-02-10T09:55:37.000Z","dependencies_parsed_at":"2024-02-09T20:24:07.249Z","dependency_job_id":"cb98c2e2-3749-4aed-8f24-a97e39d0d248","html_url":"https://github.com/mxmarchal/metasong","commit_stats":null,"previous_names":["mxmarchal/metasong"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxmarchal%2Fmetasong","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxmarchal%2Fmetasong/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxmarchal%2Fmetasong/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxmarchal%2Fmetasong/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mxmarchal","download_url":"https://codeload.github.com/mxmarchal/metasong/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243278097,"owners_count":20265495,"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","genius","genius-api","gpt-35-turbo","lyrics","metadata","metadata-extractor","multiprocessing","openai","transformers"],"created_at":"2024-11-18T10:19:54.261Z","updated_at":"2025-12-28T02:23:42.693Z","avatar_url":"https://github.com/mxmarchal.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎵 Metasong - Audio Metadata Extractor\n\nThis Python script extracts metadata and lyrics from audio files in an album folder (MP3 format) and saves them to JSON files. It utilizes multiprocessing for parallel processing, making it efficient for handling a large number of audio files.\n\nThis project is used on: https://metasong-front.vercel.app/\n\n## Features\n\n- Extracts metadata such as track number, title, authors, album, year, duration, artwork description, and sentiment analysis. (Powered by OpenAI's GPT-3.5 Turbo API and GPT-4 Vision API.)\n- Retrieves lyrics from audio files using the Genius API.\n- Utilizes multiprocessing to process audio files in parallel, improving performance.\n\n## Requirements\n\n- Python 3.x\n- External dependencies (check requirements.txt for details)\n- OpenAI API key (GPT-3.5 Turbo and GPT-4 Vision a.k.a. you need to pay for this service.)\n- Genius API access token\n\n## Installation\n\nClone the repository:\n\n```bash\ngit clone https://github.com/mxmarchal/metasong.git\n```\n\n### Install dependencies:\n\n```bash\ncd metasong\npip install -r requirements.txt\n```\n\nCreate a .env file in the project directory and set the following environment variables:\n\n```bash\nOPENAI_API_KEY=your_openai_api_key\nGENIUS_ACCESS_TOKEN=your_genius_access_token\n```\n\n## Usage\n\n```bash\npython main.py \u003cpath_to_album_folder\u003e\n```\n\nReplace `path_to_album_folder` with the path to the folder containing the audio files (MP3 format) you want to process.\n\n## Example\n\n```bash\npython main.py /path/to/album\n```\n\n# Contributing\n\nI won't be accepting any pull requests for this project. This is a personal project and I'm not looking for contributions at the moment.\n\nYou are welcome to fork the project and customize it to your needs.\n\n# License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxmarchal%2Fmetasong","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmxmarchal%2Fmetasong","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxmarchal%2Fmetasong/lists"}