A CLI tool to manipulate images in various ways
pip install eqlmpip install eqlm[clipboard]Note that clipboard support varies depending on your OS.
| Source | Result |
|---|---|
 |  |
| Source | Result |
|---|---|
 |  |
| Source | Result |
|---|---|
 |  |
| Source | Result |
|---|---|
 |  |
| Source | Result |
|---|---|
|  |
| Source | Result |
|---|---|
 |  |
The main program can be invoked either through the eqlm command or through the Python main module option python3 -m eqlm.
Each operation is implemented as a subcommand shown below.
Spatially equalize image lightness, saturation, or brightness
usage: eqlm eq [-h] [-m {l,brightness,saturation,lightness}] [-n M N]
[-i {linear,cubic,akima,makima}] [-t RATE] [-c] [-e] [-u]
[-g [GAMMA]] [-d {8,16}] [-s] [-x]
IN_FILE [OUT_FILE]
Equalize image lightness, saturation, or brightness
positional arguments:
IN_FILE input image file path (use '-' for stdin, '_' for
clipboard)
OUT_FILE output PNG image file path (use '-' for stdout, '_'
for clipboard) (default: AutoUnique)
options:
-h, --help show this help message and exit
-m, --mode {l,brightness,saturation,lightness}
processing mode (l: L (LAB), brightness: Brightness
(HSV), saturation: Saturation (HSV), lightness:
Lightness (HLS)) (default: l)
-n, --divide M N divide image into MxN (Horizontal x Vertical) blocks
for aggregation (default: (2, 2))
-i, --interpolation {linear,cubic,akima,makima}
interpolation method (linear: Linear, cubic:
CubicSpline, akima: AkimaSpline, makima:
ModifiedAkimaSpline) (default: linear)
-t, --target RATE set the target rate for the output level, ranging from
0.0 (minimum) to 1.0 (maximum) (default: Average)
-c, --clamp clamp the level values in extrapolated boundaries
(default: False)
-e, --median aggregate each block using median instead of mean
(default: False)
-u, --unweighted disable weighting based on the alpha channel (default:
False)
-g, --gamma [GAMMA] apply inverse gamma correction before the process
[GAMMA=2.2] (default: None)
-d, --depth {8,16} bit depth of the output PNG image (default: 8)
-s, --slow use the highest PNG compression level (default: False)
-x, --no-orientation ignore the Exif orientation metadata (default: False)
'--' can be used to terminate option parsing, so that remaining arguments are
treated as positional arguments.Match histogram of source image to reference image
usage: eqlm match [-h]
[-m {rgb,red,green,blue,lab,ab,l,brightness,saturation,lightness}]
[-a SOURCE REFERENCE | -u] [-g [GAMMA]] [-d {8,16}] [-s]
[-x]
SOURCE_FILE REFERENCE_FILE [OUT_FILE]
Match histogram of source image to reference image
positional arguments:
SOURCE_FILE source image file path (use '-' for stdin, '_' for
clipboard)
REFERENCE_FILE reference image file path (use '-' for stdin, '_' for
clipboard)
OUT_FILE output PNG image file path (use '-' for stdout, '_'
for clipboard) (default: AutoUnique)
options:
-h, --help show this help message and exit
-m, --mode {rgb,red,green,blue,lab,ab,l,brightness,saturation,lightness}
processing mode (rgb: RGB, red: Red (RGB), green:
Green (RGB), blue: Blue (RGB), lab: LAB, ab: AB (LAB),
l: L (LAB), brightness: Brightness (HSV), saturation:
Saturation (HSV), lightness: Lightness (HLS))
(default: rgb)
-a, --alpha SOURCE REFERENCE
cutout threshold for the alpha channel (source,
reference) (default: (0.0, 0.5))
-u, --unweighted disable cutout based on the alpha channel (default:
False)
-g, --gamma [GAMMA] apply inverse gamma correction before the process
[GAMMA=2.2] (default: None)
-d, --depth {8,16} bit depth of the output PNG image (default: 8)
-s, --slow use the highest PNG compression level (default: False)
-x, --no-orientation ignore the Exif orientation metadata (default: False)
'--' can be used to terminate option parsing, so that remaining arguments are
treated as positional arguments.Sharpen an image using a Laplacian variant kernel
usage: eqlm laps [-h] [-m {rgb,red,green,blue,lab,ab,l}]
[-t {basic5,basic9,diagonal,oonopuri,patrakarttunen}] [-c C]
[-a] [-g [GAMMA]] [-d {8,16}] [-s] [-x]
IN_FILE [OUT_FILE]
Sharpen an image using a Laplacian variant kernel
positional arguments:
IN_FILE input image file path (use '-' for stdin, '_' for
clipboard)
OUT_FILE output PNG image file path (use '-' for stdout, '_'
for clipboard) (default: AutoUnique)
options:
-h, --help show this help message and exit
-m, --mode {rgb,red,green,blue,lab,ab,l}
processing channel mode (rgb: RGB, red: Red (RGB),
green: Green (RGB), blue: Blue (RGB), lab: LAB, ab: AB
(LAB), l: L (LAB)) (default: rgb)
-t, --stencil {basic5,basic9,diagonal,oonopuri,patrakarttunen}
kernel selection (basic5: typical 4-neighbor kernel,
basic9: typical 8-neighbor kernel, diagonal:
4-diagonal-neighbor kernel, oonopuri: Oono-Puri
isotropic kernel, reduced overall error,
patrakarttunen: Patra-Karttunen isotropic kernel,
optimized for rotational invariance) (default:
oonopuri)
-c, --coef C sharpening factor (default: 0.2)
-a, --include-alpha also sharpen the alpha channel (default: False)
-g, --gamma [GAMMA] apply inverse gamma correction before the process
[GAMMA=2.2] (default: None)
-d, --depth {8,16} bit depth of the output PNG image (default: 8)
-s, --slow use the highest PNG compression level (default: False)
-x, --no-orientation ignore the Exif orientation metadata (default: False)
'--' can be used to terminate option parsing, so that remaining arguments are
treated as positional arguments.Descreen a scanned image using a Fourier Transform-based method
usage: eqlm desc [-h] [--cmyk | --no-cmyk] [--nl-means | --no-nl-means]
[-g [GAMMA]] [-s] [-x]
IN_FILE [OUT_FILE]
Fourier Transform-based descreening for scanned images
positional arguments:
IN_FILE input image file path (use '-' for stdin, '_' for
clipboard)
OUT_FILE output PNG image file path (use '-' for stdout, '_'
for clipboard) (default: AutoUnique)
options:
-h, --help show this help message and exit
--cmyk, --no-cmyk switch to perform descreening in CMYK color space
(default: False)
--nl-means, --no-nl-means
switch to apply Non-Local Means denoising after
descreening (default: True)
-g, --gamma [GAMMA] apply inverse gamma correction before the process
[GAMMA=2.2] (default: None)
-s, --slow use the highest PNG compression level (default: False)
-x, --no-orientation ignore the Exif orientation metadata (default: False)
'--' can be used to terminate option parsing, so that remaining arguments are
treated as positional arguments.GNU Affero General Public License v3.0 or later
Copyright (C) 2025 curegit
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.