vicompres 0.2.0

Efficiently compress video files using ffmpeg

Vicompres

Vicompres is a CLI tool to efficiently compress video files using ffmpeg. It provides a simple interface for batch-compressing videos with configurable quality levels.

Installation

pip install vicompres

Prerequisite: ffmpeg must be installed and available in your PATH.

Usage

vicompres -d /path/to/videos -c 5

Features

Arguments:

• -d or --directory: Specify the directory containing the video files to be compressed. By default, it uses the current directory.
• -c or --compression: Set the compression level (1-10). Higher values result in better compression but may take more time. The default value is 5.
  • compression level is ephemeral — it maps to a specific ffmpeg preset, CRF, and bitrate based on the file extension.
• -p or --prefix: Define a prefix for the input files to be compressed. Only files that start with the specified prefix will be processed. By default, it processes all files in the directory.
• -o or --output: Specify the output directory where the compressed files will be saved. If not provided, the compressed files will be saved in the same directory as the input files.
• -s or --suffix: Add a specific suffix to the output file names. This can help differentiate compressed files from the original ones. By default, compressed suffix is added.
• -r or --remove-original: If this flag is set, the original files will be deleted after successful compression. By default, original files are retained.
• -l or --delimiter: Specify a custom delimiter to separate the prefix and suffix in the output file names. The default delimiter is a dot ..

Supported file extensions:

• .mp4
• .mkv
• .avi
• .mov

Graceful shutdown:

The tool can be gracefully shut down using a keyboard interrupt (Ctrl+C). It will stop processing new files and complete the current compression before exiting.

License

MIT