lamdav / audioconverter Goto Github PK

View Code? Open in Web Editor NEW

35.0 4.0 10.0 84 KB

Audio Conversion CLI

Home Page: https://pypi.org/project/AudioConverter/

License: MIT License

Python 100.00%

cli python3 audio-processing audio conversion

audioconverter's Introduction

AudioConverter

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 on how to set up ffmpeg on the various platforms.

Install CLI

pip install --upgrade AudioConverter

Usage

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:

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:

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

audioconverter's People

Contributors

Stargazers

Watchers

Forkers

lester2525 msharifwali wheest akel123 darthone afolksetapart koldinger stancx1 atkallie dingalls

audioconverter's Issues

No module named AudioConverted

hello, I like your package, but there is a problem after installing it according to the instructions listed in README file: No module named AudioConverted.

After checking your setup.py file, I found that there missing a key in setup dict called py_modules, which specifies the name of the module. I then moved the converter.py file out of AudioConvert folder and specified py_modules=['converter'], and install it in my local virtual env, everything is ok.

here is code snippet of setup.py :

setup(name='AudioConverter',
      setup_requires=['setuptools_scm'],
      description='Audio Converter CLI',
      long_description=long_description,
      long_description_content_type='text/markdown',
      author='lamdav',
      author_email='[email protected]',
      license='MIT',
      python_requires='>=3.5',
      py_modules=['converter'],
      entry_points={
        'console_scripts': [
            'audioconvert=converter:cli'
        ]
      },

This is just a simple fix, you may consider doing some fix related to the module problem in following releases.

Regarding running the project

Hi David,

I emailed you last week. My question is how can I run your code. I have downloaded the code files and made necessary changes.
Simply running python audioconverter.py isn't working, even with the command line arguments.
Sorry I am new to python and just need functionality to convert mp3 to wav mulaw. The cli is an add on which I would like as well.
But for starters how can I run the file exactly?

Thank you,
Tejas

P.S. Just tried the updated version. It is working as intended. Do let me know how can I run the project for debugging and adding few things that I require that is logging into files so that I can use it. Thank you so much.

support .wav

Thank you for your tools. The format .wav is frequently used and I suggest to support it.

Conflicting dependencies between requirements.txt and setup.py files

Hi there,

I've encountered an issue while trying to install AudioConverter v1.0.0 using pip. The requirements specified in the requirements.txt and setup.py files for AudioConverter do not match, leading to a conflict between the versions of Click required by the two files.

Specifically, requirements.txt specifies that AudioConverter requires click==8.1.3, while setup.py requires click>=7.1.2,<8.0.0. When I try to install AudioConverter using pip install AudioConverter, I get a dependency conflict error due to the mismatch between the two files.

I believe this is a bug in the package, as the requirements specified in requirements.txt and setup.py should be consistent. Could you please look into this issue and provide a fix?

Thank you for your help!