Metadata-Version: 1.1
Name: ffmpeg-normalize
Version: 0.2.3
Summary: Normalize audio via ffmpeg / avconv
Home-page: https://github.com/slhck/audio-normalize
Author: Werner Robitza
Author-email: slhck@me.com
License: MIT
Description: ffmpeg-normalize
        ================
        
        ffmpeg script for normalizing audio.
        
        This program normalizes media files to a certain dB level. The default is an
        RMS-based normalization where the mean is lifted. Peak normalization is
        possible with the ``-m`` option.
        
        It takes any audio or video file as input, and writes the audio part as
        output WAV file. The normalized audio can also be merged with the
        original.
        
        Requirements:
        
        - Python 2.7 (Python 3 is not supported yet)
        - ffmpeg from http://ffmpeg.org/ installed in your $PATH
        
        Installation::
        
            pip install ffmpeg-normalize
        
        Usage::
        
            ffmpeg-normalize [options] <input-file>...
        
        Options:
        
        -  ``-f``, ``--force`` — Force overwriting existing files
        -  ``-l``, ``--level <level>`` — dB level to normalize to [default: -26]
        -  ``-p``, ``--prefix <prefix>`` — Normalized file prefix [default:
           normalized]
        -  ``-t``, ``--threshold <threshold>`` — dB threshold below which the
           audio will be not adjusted [default: 0.5]
        -  ``-o``, ``--dir`` — Create an output folder in stead of prefixing the
           file
        -  ``-m``, ``--max`` — Normalize to the maximum (peak) volume instead of
           RMS
        -  ``-v``, ``--verbose`` — Enable verbose output
        -  ``-n``, ``--dry-run`` — Show what would be done, do not convert
        -  ``-d``, ``--debug`` — Show debug output
        -  ``-u``, ``--merge`` — Don’t create a separate WAV file but update the
           original file. Use in combination with -p to create a copy
        -  ``-a``, ``--acodec <acodec>`` — Set audio codec for ffmpeg (see
           “ffmpeg -encoders”) when merging. If not set, default from ffmpeg
           will be used.
        -  ``-e``, ``--extra-options <extra-options>`` — Set extra options
           passed to ffmpeg (e.g. “-b:a 192k” to set audio bitrate)
        
        Examples::
        
            ffmpeg-normalize -v file.mp3
            ffmpeg-normalize -v *.avi
            ffmpeg-normalize -u -v -o -f -m -l -5 *.mp4
            ffmpeg-normalize -u -v -a libfdk_aac -e "-b:a 192k" *.mkv
        
        
        
        
        History
        -------
        
        0.2.2 (2016-02-12)
        __________________
        
        * Fixed issue where ffmpeg could not be found if path included spaces
        
        0.2.2 (2016-02-09)
        __________________
        
        * Change default level back to -26
        
        0.2.1 (2016-02-08)
        __________________
        
        * Documentation fixes
        
        
        0.2.0 (2016-02-08)
        __________________
        
        * Support multiple input files
        * Allow merging with input file instead of creating separate WAV
        * Write to directory instead of using prefix
        * Set the audio codec when merging
        * Set additional encoder or ffmpeg options
        
        Note: avconv support is very limited, use the real ffmpeg from http://ffmpeg.org/ instead.
        
        0.1.3 (2015-12-15)
        __________________
        
        * Bugfix for detecting ffmpeg or avconv on Windows (as .exe)
        * Add version to Usage message
        * Update year
        
        0.1.2 (2015-11-13)
        __________________
        
        * Bugfix for missing ffmpeg or avconv
        
        
        0.1.0 (2015-08-01)
        __________________
        
        * First release, changing name to ffmpeg-normalize
        
Keywords: avconv,ffmpeg,libav,normalize,audio
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
