Skip to main content

A media converter command line program in Python.

Project description



A media converter command line program in Python.


This is a custom Python (3) CLI for converting media files

I've done this to make it easy to convert my media files into different formats, bitrates and whatnot without having to remember the ffmpeg syntax for each case.

It does NOT cover all ffmpeg options (I just wanted a few) but it is possible to add them.


Plug & Play:

$ pip3 install converter-cli

If you want to play around with the code I'd recommend creating a virtual environment first (with python3):

$ mkvirtualenv --python=/usr/local/bin/python3 converter-cli

And then:

$ git clone

$ cd converter-cli

$ pip install -r requirements-dev.txt

$ python develop

Unit Tests

$ py.test tests


The idea is for the CLI to ask you for the necessary information in order to work, the only thing you should know is that if what you are interested in is converting audio you should use the audio command:

$ converter-cli audio

If you are interested in converting video files then use command video:

$ converter-cli video

Full command list follows:

    converter-cli hello
    converter-cli audio
    converter-cli audio [-m | --multiple] [--verbose] [-n | --no-confirm]
    converter-cli video
    converter-cli video [-m | --multiple] [--verbose] [-n | --no-confirm]
    converter-cli -h | --help
    converter-cli -v | --version

    -h --help                         Show this screen.
    -v --version                      Show version.
    -m --multiple                     Convert all files within a given folder
    -n --no-confirm                   Avoid user confirmation before converting
    --verbose                         Redirect converting process to stdout

By default the CLI will be used to convert one file, but the -m/--multiple option will allow you to do multiple files at once:

$ converter-cli video -m

Also by default, the CLi will hide the output of the ffmpeg command in favor of a more readable custom line, unless the --verbose option is specified:

$ converter-cli audio --verbose


Convert a .wav audio file into a .mp3 file:

$ converter-cli audio

You will be presented with the following:

Please choose an option:
    1) Convert to .mp3 (320k)
    2) Convert to .wav
Enter option number:

Insert the option number in this case 1 and this will show up:

Enter path to source file:

Here we will enter something like /path/to/file/music.wav and hit enter.

Enter path to destination folder (Enter for same folder as source):

Notice if your click enter without specifying any path then the output file will be in the same directory as the source file /path/to/file/

Next thing to happen will be (unless the --no-confirm option was given):


Output file will be called the same as the original
with the proper extension (.mp4, .mp3, ...) which
may cause an overwrite - YOU HAVE BEEN WARNED

You are about to convert file /path/to/file/music.wav into a .mp3 file to be saved in folder /path/to/file/

Please confirm action above [y/n]:

I have added the confirmation process with the warning message to give the user the option to review what is going to happen, I might add the option in the future to bypass this.

You can just hit enter, or type y and hit enter, anything else will stop the process.

Once you accept, this will show up:

Converting source /path/to/file/music.wav into output /path/to/file/music.mp3 ...

(っ◕‿◕)っ    Conversion completed    ⊂(´・◡・⊂ )∘˚

As you can see the CLI asks the user for all needed data and provides the user with explicit messages of what is happening. The rest of the commands have the same flow, just read what it asks for :)





Feel free to report any bugs or submit feature requests.

Pull requests are welcome as well.

Special thanks

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

converter-cli-1.0.7.tar.gz (12.7 kB view hashes)

Uploaded Source

Built Distribution

converter_cli-1.0.7-py2.py3-none-any.whl (14.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page