/audioConvertor

A multi-audio :musical_note: converter CLI that makes some bitful use of ffmeg in media format conversion

Primary LanguagePythonApache License 2.0Apache-2.0

audioConvertor Build Status Coverage Status

audioConvertor is a multifile media format convertor command line tool. It allows conversion of files to various media types, the most emphasised on, being from video to audio. The tool is a guide detailed out on this blog post

Setup

  1. Access a cloned copy of the repo
  $ git clone https://github.com/hogum/audioConvertor
  1. Change to the repo directory
  $ cd audioConvertor
  1. Optionally install ffmpeg. You can skip this step.

    Running the application for the first time will prompt for the installation.

    $ apt-get install ffmpeg

Dependecies

  1. Ensure to have pipenv installed
  $ apt install pipenv
  1. Install the project dependencies by running
  $ pipenv install
  • Alternatively, you can use a virtual environment with dependencies present by running
  $ pipenv shell

Interacting with the application

Basic Usage

The usage options are accesible on the help menu. This can be displayed by running:

   $ python convertor/cli.py --help
  1. Convert a video file to audio.
  • Required Options

    • --input_file -i Path to video file

      $ python convertor/cli.py -i /path/to/video/file/ -o /save/path/
  1. Convert mulitple video files from multiple directories
$ python convert -i /path/to/root/directory/ -o /path/to/save/output/ --recursive

Testing

  1. Spawn a virtual environment
  $ pipenv shell
  1. Run tests
  $ pytest