Skip to content

Latest commit

 

History

History
125 lines (90 loc) · 3.18 KB

README.md

File metadata and controls

125 lines (90 loc) · 3.18 KB
Raw

Quality Muncher

About

This is the Python version of Quality Muncher.

It is still in development so if you have any bugs, issues, questions, or suggestions join our discord server: https://discord.gg/9tRZ6C7tYz

Installation

Install via Scoop

Run the following block of code in PowerShell:

iex(irm get.scoop.sh)
scoop bucket add utils https://github.com/couleur-tweak-tips/utils
scoop install utils/qm-py

This will:

  1. Install Scoop, a convenient and easy-to-use package manager for Windows
  2. Add the utils bucket
  3. Download and install Quality Muncher

Manual installation / Linux

NOTE: LINUX IS NOT FULLY SUPPORTED YET, SOME FEATURES MAY NOT WORK

  1. Install Python >= 3.10
  2. Download the .zip from releases
  3. Add the folder to PATH

Usage

Please report any issues!

This version of Quality Muncher is used via the command line, qm -h should get you started

Arguments

Text inside following characters is not literal: < > ( )

... means the argument takes multiple values of the same format

Optional arguments

--help / -h : Show this message and exit

--verbose / -v : Increase output verbosity

--curdir / -dir : Open the folder in which Quality Muncher was installed

Input / output options

--input / -i <PATH> : Specify input video path / filename

  • required

--output / -o <PATH> : Specify output path / filename

Video options

--preset / -p <int> : Specify quality preset

  • default: 1
  • min-max: 1-7

--contrast / -c <float> : Modify video contrast

  • default: 1.0
  • min-max: 0-2

--saturation / -s <float> : Modify video saturation

  • default: 1.0
  • min-max: 0-2

--brightness / -b <float> : Modify video brightness

  • default: 1.0
  • min-max: 0-2

--speed / -spd <float> : Modify video speed

  • default: 1.0
  • min-max: 0-2

--stretch / -str <multiplier>:<(w/h)> : Stretch video resolution

  • multiplier can be a float
  • w stretches width, h stretches height
Audio options

--audio-distort / -ad <method>:<strength>, ... : Distort audio

  • methods: earrape, echo, delay
  • strength: 1-10 (float)

Examples

The most basic usage, it will use the default preset and output to the same folder as the input

qm -i video.mp4

Munch using preset 5 with verbose output enabled

qm -i video.mp4 -p 5 -v

Munch with every setting set to 10 (or their maximum value)

qm -i video.mp4 -p 7 -c 2 -s 2 -b 2 -spd 10 -str 10:w -ad earrape:10,echo:10,delay:10 -v

Building

qm-py uses a Onefile Python Interpreter so that you don't need to install Python to use it.

If you wish to compile it yourself, follow these steps:

  1. Install Python 3.10 with PIP
  2. Install the following PIP packages: pip install nuitka zstandard ordered-set
    • Only Nuitka is necessary but the other ones improve compilation speed
  3. Download the latest release and run build.bat in the build folder