{"id":15009808,"url":"https://github.com/lamdav/audioconverter","last_synced_at":"2025-08-16T20:31:22.449Z","repository":{"id":34969367,"uuid":"140659595","full_name":"lamdav/AudioConverter","owner":"lamdav","description":"Audio Conversion CLI ","archived":false,"fork":false,"pushed_at":"2024-06-15T09:36:18.000Z","size":84,"stargazers_count":36,"open_issues_count":0,"forks_count":12,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-16T21:36:59.904Z","etag":null,"topics":["audio","audio-processing","cli","conversion","python3"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/AudioConverter/","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/lamdav.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":"2018-07-12T04:09:17.000Z","updated_at":"2024-06-15T09:36:16.000Z","dependencies_parsed_at":"2024-06-15T10:55:36.082Z","dependency_job_id":null,"html_url":"https://github.com/lamdav/AudioConverter","commit_stats":{"total_commits":52,"total_committers":4,"mean_commits":13.0,"dds":0.05769230769230771,"last_synced_commit":"1e4390a37e8832c814f4cbc8f59930d54457f3ad"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamdav%2FAudioConverter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamdav%2FAudioConverter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamdav%2FAudioConverter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lamdav%2FAudioConverter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lamdav","download_url":"https://codeload.github.com/lamdav/AudioConverter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230056130,"owners_count":18165879,"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","audio-processing","cli","conversion","python3"],"created_at":"2024-09-24T19:28:44.119Z","updated_at":"2024-12-17T03:10:18.598Z","avatar_url":"https://github.com/lamdav.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AudioConverter\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\nA simple CLI to convert a directory of audio files from  one format\nto another. This CLI sits ontop of `pydub` and `ffmpeg`\n\n## Motivation\nI have some old music in a lossless format. Now that I am constantly\njumping between computers, I wanted it to be converted in\na more universal format such as `mp3` so that I can play it with\nthe simplest of players. I also wanted to avoid having\nto stream my music on cloud platforms. Upon a cursory and naive scan\non the web, I found that existing scripts are defunct (again cursory)\nor was not as simple as I would like it to be. I did not want to download\na GUI for a one time use or upload a directory of music online to have it\nbe converted on some server and download it again either. Instead, I wrote\nthis quick CLI to do it for me.\n\n## Setup\n### Install `ffmpeg`\nGo follow the `pydub`\n[tutorial](https://github.com/jiaaro/pydub#getting-ffmpeg-set-up)\non how to set up `ffmpeg` on the various platforms.\n\n### Install CLI\n```shell\npip install --upgrade AudioConverter\n```\n\n## Usage\n```shell\naudioconvert [--verbose/-v] convert INPUT_DIRECTORY OUTPUT_DIRECTORY [--output-format/-o TARGET_FORMAT]\n```\nThis will recursively search the `INPUT_DIRECTORY` for files with music\nextensions. Each file found will then be converted to the `TARGET_FORMAT` and\nplaced in the `OUTPUT_DIRECTORY` with the same name but updated extension.\n\nThe `--verbose/-v` flag must be provided before the `convert` command. This\nwill enable debugging logs and allow you to monitor progress.\n\nFor example - to convert the contents of the directory `input/`, containing\nfiles of type `.m4a` and `.flac`, outputting to directory `output/`, converting\nto type `.mp3` run:\n\n```shell\naudioconvert convert input/ output/ --output-format .mp3\n```\n\n### Experimental\nAudio can be passed to be converted to specific codecs. This is an experimental now feature\nas it has no error checking that certain codecs are compatible with your desired output\naudio format. Depending on `ffmpeg` and/or `pydub`, there may or may not be error logging.\n\nTo use the new experimental feature:\n```shell\naudioconvert convert input/ output/ --output-format .wav --codec pcm_mulaw\n```\n\n## Accepted Formats\nDue to not being super savvy with audio formats, I hard coded the extensions\nthat are searched for in the `INPUT_DIRECTORY` and acceptable `TARGET_FORMAT`.\nHere is a list of formats I thought were popular:\n- .mp3\n- .flac\n- .aiff\n- .mp4\n- .m4a\n- .wav\n- .ogg\n\n## Supported Codec\n- pcm_mulaw\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flamdav%2Faudioconverter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flamdav%2Faudioconverter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flamdav%2Faudioconverter/lists"}