# AudioConverter
[](https://github.com/psf/black)
A simple CLI to convert a directory of audio files from one format
to another. This CLI sits ontop of `pydub` and `ffmpeg`
## Motivation
I have some old music in a lossless format. Now that I am constantly
jumping between computers, I wanted it to be converted in
a more universal format such as `mp3` so that I can play it with
the simplest of players. I also wanted to avoid having
to stream my music on cloud platforms. Upon a cursory and naive scan
on the web, I found that existing scripts are defunct (again cursory)
or was not as simple as I would like it to be. I did not want to download
a GUI for a one time use or upload a directory of music online to have it
be converted on some server and download it again either. Instead, I wrote
this quick CLI to do it for me.
## Setup
### Install `ffmpeg`
Go follow the `pydub`
[tutorial](https://github.com/jiaaro/pydub#getting-ffmpeg-set-up)
on how to set up `ffmpeg` on the various platforms.
### Install CLI
```shell
pip install --upgrade AudioConverter
```
## Usage
```shell
audioconvert [--verbose/-v] convert INPUT_DIRECTORY OUTPUT_DIRECTORY [--output-format/-o TARGET_FORMAT]
```
This will recursively search the `INPUT_DIRECTORY` for files with music
extensions. Each file found will then be converted to the `TARGET_FORMAT` and
placed in the `OUTPUT_DIRECTORY` with the same name but updated extension.
The `--verbose/-v` flag must be provided before the `convert` command. This
will enable debugging logs and allow you to monitor progress.
For example - to convert the contents of the directory `input/`, containing
files of type `.m4a` and `.flac`, outputting to directory `output/`, converting
to type `.mp3` run:
```shell
audioconvert convert input/ output/ --output-format .mp3
```
### Experimental
Audio can be passed to be converted to specific codecs. This is an experimental now feature
as it has no error checking that certain codecs are compatible with your desired output
audio format. Depending on `ffmpeg` and/or `pydub`, there may or may not be error logging.
To use the new experimental feature:
```shell
audioconvert convert input/ output/ --output-format .wav --codec pcm_mulaw
```
## Accepted Formats
Due to not being super savvy with audio formats, I hard coded the extensions
that are searched for in the `INPUT_DIRECTORY` and acceptable `TARGET_FORMAT`.
Here is a list of formats I thought were popular:
- .mp3
- .flac
- .aiff
- .mp4
- .m4a
- .wav
- .ogg
## Supported Codec
- pcm_mulaw
Raw data
{
"_id": null,
"home_page": "https://github.com/lamdav/AudioConverter",
"name": "audioconverter",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "audio,converter,cli,audioconverter",
"author": "David Lam",
"author_email": "david.lam@lamdav.com",
"download_url": "https://files.pythonhosted.org/packages/d7/7f/dbfa545546dc6126e564303ca85387d0b5c6f4d55c4cea544901a7912d2f/audioconverter-2.0.3.tar.gz",
"platform": null,
"description": "# AudioConverter\n[](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",
"bugtrack_url": null,
"license": "MIT",
"summary": "CLI for converting audio files from one format to another",
"version": "2.0.3",
"project_urls": {
"Bug Tracker": "https://github.com/lamdav/AudioConverter/issues",
"Documentation": "https://github.com/lamdav/AudioConverter#usage",
"Homepage": "https://github.com/lamdav/AudioConverter",
"Repository": "https://github.com/lamdav/AudioConverter"
},
"split_keywords": [
"audio",
"converter",
"cli",
"audioconverter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d22fa5bf8bec10301082f5d60be362827690bab265a2d1ae955f6a4e141e8042",
"md5": "bb9d0a6ed2a747093abe11915441e5ab",
"sha256": "61f178f357edab4764bb9b8dc5d85a2b1c92bd18ee39c1fc9b43deaf11f939d2"
},
"downloads": -1,
"filename": "audioconverter-2.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bb9d0a6ed2a747093abe11915441e5ab",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 5919,
"upload_time": "2024-02-02T06:42:19",
"upload_time_iso_8601": "2024-02-02T06:42:19.305277Z",
"url": "https://files.pythonhosted.org/packages/d2/2f/a5bf8bec10301082f5d60be362827690bab265a2d1ae955f6a4e141e8042/audioconverter-2.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d77fdbfa545546dc6126e564303ca85387d0b5c6f4d55c4cea544901a7912d2f",
"md5": "a59629b5bddea81c6a2cd83acfb39883",
"sha256": "8db3cfac184033ed7cf4307fcb2346d8424392924a819bb144aa928282eda5b7"
},
"downloads": -1,
"filename": "audioconverter-2.0.3.tar.gz",
"has_sig": false,
"md5_digest": "a59629b5bddea81c6a2cd83acfb39883",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 5147,
"upload_time": "2024-02-02T06:42:21",
"upload_time_iso_8601": "2024-02-02T06:42:21.000606Z",
"url": "https://files.pythonhosted.org/packages/d7/7f/dbfa545546dc6126e564303ca85387d0b5c6f4d55c4cea544901a7912d2f/audioconverter-2.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-02 06:42:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lamdav",
"github_project": "AudioConverter",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "audioconverter"
}
JSON
