{"id":22596063,"url":"https://github.com/korseby/py3tag","last_synced_at":"2025-04-11T00:32:35.258Z","repository":{"id":136912328,"uuid":"219766075","full_name":"korseby/py3tag","owner":"korseby","description":"Write tags to audio files (mp3, flac, and m4a are supported) based on their filenames","archived":false,"fork":false,"pushed_at":"2023-10-15T11:15:15.000Z","size":15,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T21:21:47.392Z","etag":null,"topics":["audioread","flac-files","librosa","m4a-files","mp3-files","mutagen","python-libraries","python3","scheme"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/korseby.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}},"created_at":"2019-11-05T14:32:40.000Z","updated_at":"2024-10-25T17:19:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"8c3bacbc-eb8f-46dc-a1d5-7c025ce1857c","html_url":"https://github.com/korseby/py3tag","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/korseby%2Fpy3tag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/korseby%2Fpy3tag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/korseby%2Fpy3tag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/korseby%2Fpy3tag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/korseby","download_url":"https://codeload.github.com/korseby/py3tag/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322683,"owners_count":21084336,"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":["audioread","flac-files","librosa","m4a-files","mp3-files","mutagen","python-libraries","python3","scheme"],"created_at":"2024-12-08T10:12:56.798Z","updated_at":"2025-04-11T00:32:35.225Z","avatar_url":"https://github.com/korseby.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# py3tag\nWrite tags to audio files (mp3, flac, and m4a files are supported) based on their filenames.\n\nTo facilitate the tagging of audio files, tags can be generated automatically from the filename of the audio file. Since Napster there are some conventions how to properly name mp3 files - which are followed by this script.\n\nFor each album of compilation, the script expects an own directory. For albums the scheme `Artist - Album - Tracknumber - Title.mp3` is used whereas for compilations `Album - Tracknumber - Artist - Title.mp3` is used. The script automatically determines the total number of tracks that exist within the directory. Compilation tags used by iTunes are automatically set based on the scheme. If enabled, the script also calculates the BPMs by using the Python library librosa. If `Cover.jpg` exists in the directory it is used as the cover picture.\n\n## Version\n1.3\n\n## Usage\n\n```\nusage: py3tag.py [-h] [-V] [-n] [-v] [-b] [-c 4] [-g Electronic] files [files ...]\n\nWrites tags to audio files based on their filenames.\n\npositional arguments:\n  files                 List of file(s) and/or directories.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -V, --version         Show version.\n  -n, --dry-run         Do not do anything, just show what is being done.\n  -v, --verbose         Be verbose and show what is being done.\n  -b, --disable-bpm     Disable BPM detection.\n  -c 4, --cpu 4         Number of cpu cores to use. Default is to use all detected cores\n                        and threads.\n  -g Electronic, --genre Electronic\n                        Genre that is being used. Default is Electronic.\n```\n\n## Dependencies\nThe following additional Python libraries are needed to run the script. They can be best installed via pip.\n\n* audioread\n* numpy\n* librosa\n* mutagen\n\n## Changes\n\n### Version 1.3:\n- fix librosa deprecation issues with numpy\n\n### Version 1.2:\n- added flac and m4a support\n\n### Version 1.1:\n- librosa now always uses audioread\n\n### Version 1.0:\n- added multiprocessing\n\n### Version 0.9:\n- small bugfixes\n\n### Version 0.8:\n- initial version\n\n## License\nBSD-3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkorseby%2Fpy3tag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkorseby%2Fpy3tag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkorseby%2Fpy3tag/lists"}