import argparse import textwrap import logging import os import shlex import json try: from json.decoder import JSONDecodeError except ImportError: JSONDecodeError = ValueError from ._version import __version__ from ._ffmpeg_normalize import FFmpegNormalize, NORMALIZATION_TYPES from ._errors import FFmpegNormalizeError from ._logger import setup_custom_logger logger = setup_custom_logger("ffmpeg_normalize") def create_parser(): parser = argparse.ArgumentParser( prog="ffmpeg-normalize", description=textwrap.dedent( """\ ffmpeg-normalize v{} -- command line tool for normalizing audio files """.format( __version__ ) ), usage=textwrap.dedent( """\ ffmpeg-normalize input [input ...] [-h] [-o OUTPUT [OUTPUT ...]] [-of OUTPUT_FOLDER] [-f] [-d] [-v] [-q] [-n] [-pr] [--version] [-nt {ebu,rms,peak}] [-t TARGET_LEVEL] [-p] [-lrt LOUDNESS_RANGE_TARGET] [-tp TRUE_PEAK] [--offset OFFSET] [--dual-mono] [-c:a AUDIO_CODEC] [-b:a AUDIO_BITRATE] [-ar SAMPLE_RATE] [-koa] [-prf PRE_FILTER] [-pof POST_FILTER] [-vn] [-c:v VIDEO_CODEC] [-sn] [-mn] [-cn] [-ei EXTRA_INPUT_OPTIONS] [-e EXTRA_OUTPUT_OPTIONS] [-ofmt OUTPUT_FORMAT] [-ext EXTENSION] """ ), formatter_class=argparse.RawTextHelpFormatter, epilog=textwrap.dedent( """\ The program additionally respects environment variables: - `TMP` / `TEMP` / `TMPDIR` Sets the path to the temporary directory in which files are stored before being moved to the final output directory. Note: You need to use full paths. - `FFMPEG_PATH` Sets the full path to an `ffmpeg` executable other than the system default. Author: Werner Robitza License: MIT Homepage / Issues: https://github.com/slhck/ffmpeg-normalize """ ), ) group_io = parser.add_argument_group("File Input/output") group_io.add_argument("input", nargs="+", help="Input media file(s)") group_io.add_argument( "-o", "--output", nargs="+", help=textwrap.dedent( """\ Output file names. Will be applied per input file. If no output file name is specified for an input file, the output files will be written to the default output folder with the name `.`, where `` is the output extension (see `-ext` option). Example: ffmpeg-normalize 1.wav 2.wav -o 1n.wav 2n.wav """ ), ) group_io.add_argument( "-of", "--output-folder", type=str, help=textwrap.dedent( """\ Output folder (default: `normalized`) This folder will be used for input files that have no explicit output name specified. """ ), default="normalized", ) group_general = parser.add_argument_group("General Options") group_general.add_argument( "-f", "--force", action="store_true", help="Force overwrite existing files" ) group_general.add_argument( "-d", "--debug", action="store_true", help="Print debugging output" ) group_general.add_argument( "-v", "--verbose", action="store_true", help="Print verbose output" ) group_general.add_argument( "-q", "--quiet", action="store_true", help="Only print errors in output" ) group_general.add_argument( "-n", "--dry-run", action="store_true", help="Do not run normalization, only print what would be done", ) group_general.add_argument( "-pr", "--progress", action="store_true", help="Show progress bar for files and streams", ) group_general.add_argument( "--version", action="version", version=f"%(prog)s v{__version__}", help="Print version and exit", ) group_normalization = parser.add_argument_group("Normalization") group_normalization.add_argument( "-nt", "--normalization-type", type=str, choices=NORMALIZATION_TYPES, help=textwrap.dedent( """\ Normalization type (default: `ebu`). EBU normalization performs two passes and normalizes according to EBU R128. RMS-based normalization brings the input file to the specified RMS level. Peak normalization brings the signal to the specified peak level. """ ), default="ebu", ) group_normalization.add_argument( "-t", "--target-level", type=float, help=textwrap.dedent( """\ Normalization target level in dB/LUFS (default: -23). For EBU normalization, it corresponds to Integrated Loudness Target in LUFS. The range is -70.0 - -5.0. Otherwise, the range is -99 to 0. """ ), default=-23.0, ) group_normalization.add_argument( "-p", "--print-stats", action="store_true", help="Print first pass loudness statistics formatted as JSON to stdout", ) # group_normalization.add_argument( # '--threshold', # type=float, # help=textwrap.dedent("""\ # Threshold below which normalization should not be run. # If the stream falls within the threshold, it will simply be copied. # """), # default=0.5 # ) group_ebu = parser.add_argument_group("EBU R128 Normalization") group_ebu.add_argument( "-lrt", "--loudness-range-target", type=float, help=textwrap.dedent( """\ EBU Loudness Range Target in LUFS (default: 7.0). Range is 1.0 - 20.0. """ ), default=7.0, ) group_ebu.add_argument( "-tp", "--true-peak", type=float, help=textwrap.dedent( """\ EBU Maximum True Peak in dBTP (default: -2.0). Range is -9.0 - +0.0. """ ), default=-2.0, ) group_ebu.add_argument( "--offset", type=float, help=textwrap.dedent( """\ EBU Offset Gain (default: 0.0). The gain is applied before the true-peak limiter in the first pass only. The offset for the second pass will be automatically determined based on the first pass statistics. Range is -99.0 - +99.0. """ ), default=0.0, ) group_ebu.add_argument( "--dual-mono", action="store_true", help=textwrap.dedent( """\ Treat mono input files as "dual-mono". If a mono file is intended for playback on a stereo system, its EBU R128 measurement will be perceptually incorrect. If set, this option will compensate for this effect. Multi-channel input files are not affected by this option. """ ), ) group_acodec = parser.add_argument_group("Audio Encoding") group_acodec.add_argument( "-c:a", "--audio-codec", type=str, help=textwrap.dedent( """\ Audio codec to use for output files. See `ffmpeg -encoders` for a list. Will use PCM audio with input stream bit depth by default. """ ), ) group_acodec.add_argument( "-b:a", "--audio-bitrate", type=str, help=textwrap.dedent( """\ Audio bitrate in bits/s, or with K suffix. If not specified, will use codec default. """ ), ) group_acodec.add_argument( "-ar", "--sample-rate", type=str, help=textwrap.dedent( """\ Audio sample rate to use for output files in Hz. Will use input sample rate by default, except for EBU normalization, which will change the input sample rate to 192 kHz. """ ), ) group_acodec.add_argument( "-koa", "--keep-original-audio", action="store_true", help="Copy original, non-normalized audio streams to output file", ) group_acodec.add_argument( "-prf", "--pre-filter", type=str, help=textwrap.dedent( """\ Add an audio filter chain before applying normalization. Multiple filters can be specified by comma-separating them. """ ), ) group_acodec.add_argument( "-pof", "--post-filter", type=str, help=textwrap.dedent( """\ Add an audio filter chain after applying normalization. Multiple filters can be specified by comma-separating them. For EBU, the filter will be applied during the second pass. """ ), ) group_vcodec = parser.add_argument_group("Other Encoding Options") group_vcodec.add_argument( "-vn", "--video-disable", action="store_true", help="Do not write video streams to output", ) group_vcodec.add_argument( "-c:v", "--video-codec", type=str, help=textwrap.dedent( """\ Video codec to use for output files (default: 'copy'). See `ffmpeg -encoders` for a list. Will attempt to copy video codec by default. """ ), default="copy", ) group_vcodec.add_argument( "-sn", "--subtitle-disable", action="store_true", help="Do not write subtitle streams to output", ) group_vcodec.add_argument( "-mn", "--metadata-disable", action="store_true", help="Do not write metadata to output", ) group_vcodec.add_argument( "-cn", "--chapters-disable", action="store_true", help="Do not write chapters to output", ) group_format = parser.add_argument_group("Input/Output options") group_format.add_argument( "-ei", "--extra-input-options", type=str, help=textwrap.dedent( """\ Extra input options list. A list of extra ffmpeg command line arguments valid for the input, applied before ffmpeg's `-i`. You can either use a JSON-formatted list (i.e., a list of comma-separated, quoted elements within square brackets), or a simple string of space-separated arguments. If JSON is used, you need to wrap the whole argument in quotes to prevent shell expansion and to preserve literal quotes inside the string. If a simple string is used, you need to specify the argument with `-e=`. Examples: `-e '[ "-f", "mpegts" ]'` or `-e="-f mpegts"` """ ), ) group_format.add_argument( "-e", "--extra-output-options", type=str, help=textwrap.dedent( """\ Extra output options list. A list of extra ffmpeg command line arguments. You can either use a JSON-formatted list (i.e., a list of comma-separated, quoted elements within square brackets), or a simple string of space-separated arguments. If JSON is used, you need to wrap the whole argument in quotes to prevent shell expansion and to preserve literal quotes inside the string. If a simple string is used, you need to specify the argument with `-e=`. Examples: `-e '[ "-vbr", "3" ]'` or `-e="-vbr 3"` """ ), ) group_format.add_argument( "-ofmt", "--output-format", type=str, help=textwrap.dedent( """\ Media format to use for output file(s). See 'ffmpeg -formats' for a list. If not specified, the format will be inferred by ffmpeg from the output file name. If the output file name is not explicitly specified, the extension will govern the format (see '--extension' option). """ ), ) group_format.add_argument( "-ext", "--extension", type=str, help=textwrap.dedent( """\ Output file extension to use for output files that were not explicitly specified. (Default: `mkv`) """ ), default="mkv", ) return parser def _split_options(opts): """ Parse extra options (input or output) into a list """ if not opts: return [] try: if opts.startswith("["): try: ret = [str(s) for s in json.loads(opts)] except JSONDecodeError: ret = shlex.split(opts) else: ret = shlex.split(opts) except Exception as e: raise FFmpegNormalizeError(f"Could not parse extra_options: {e}") return ret def main(): cli_args = create_parser().parse_args() if cli_args.quiet: logger.setLevel(logging.ERROR) elif cli_args.debug: logger.setLevel(logging.DEBUG) elif cli_args.verbose: logger.setLevel(logging.INFO) # parse extra options extra_input_options = _split_options(cli_args.extra_input_options) extra_output_options = _split_options(cli_args.extra_output_options) ffmpeg_normalize = FFmpegNormalize( normalization_type=cli_args.normalization_type, target_level=cli_args.target_level, print_stats=cli_args.print_stats, loudness_range_target=cli_args.loudness_range_target, # threshold=cli_args.threshold, true_peak=cli_args.true_peak, offset=cli_args.offset, dual_mono=cli_args.dual_mono, audio_codec=cli_args.audio_codec, audio_bitrate=cli_args.audio_bitrate, sample_rate=cli_args.sample_rate, keep_original_audio=cli_args.keep_original_audio, pre_filter=cli_args.pre_filter, post_filter=cli_args.post_filter, video_codec=cli_args.video_codec, video_disable=cli_args.video_disable, subtitle_disable=cli_args.subtitle_disable, metadata_disable=cli_args.metadata_disable, chapters_disable=cli_args.chapters_disable, extra_input_options=extra_input_options, extra_output_options=extra_output_options, output_format=cli_args.output_format, dry_run=cli_args.dry_run, progress=cli_args.progress, ) if ( cli_args.output is not None and len(cli_args.output) > 0 and len(cli_args.input) > len(cli_args.output) ): logger.warning( "There are more input files than output file names given. " "Please specify one output file name per input file using -o ... " "Will apply default file naming for the remaining ones." ) for index, input_file in enumerate(cli_args.input): if cli_args.output is not None and index < len(cli_args.output): if cli_args.output_folder and cli_args.output_folder != "normalized": logger.warning( "Output folder {} is ignored for input file {}".format( cli_args.output_folder, input_file ) ) output_file = cli_args.output[index] output_dir = os.path.dirname(output_file) if output_dir != "" and not os.path.isdir(output_dir): raise FFmpegNormalizeError( f"Output file path {output_dir} does not exist" ) else: output_file = os.path.join( cli_args.output_folder, os.path.splitext(os.path.basename(input_file))[0] + "." + cli_args.extension, ) if not os.path.isdir(cli_args.output_folder) and not cli_args.dry_run: logger.warning( "Output directory '{}' does not exist, will create".format( cli_args.output_folder ) ) os.makedirs(cli_args.output_folder) if os.path.exists(output_file) and not cli_args.force: logger.error( "Output file {} already exists, skipping. Use -f to force overwriting.".format( output_file ) ) else: ffmpeg_normalize.add_media_file(input_file, output_file) ffmpeg_normalize.run_normalization() if __name__ == "__main__": main()