Easily Manipulate Images Using Python: Change Brightness, Contrast, Sharpness, Resize
Project description
pillowcover
Mass Manipulate Images Using Python: Change Brightness, Contrast, Sharpness, Resize, Compress, Crop and Convert (e.g png to jpg). A simple script (wrapper) using pillow. Licensed Under: GNU General Public License v3 or later (GPLv3+)
Requirements
python >= 3.5, pillow
Installation
Simplest option is to install with pip using sudo.
sudo python3 -m pip install pillowcover --upgrade
--OR-- Install as a user without sudo. This installs it in ~/.local/bin/ make sure this path is in your $PATH.
python3 -m pip install --user pillowcover --upgrade
If not found, add the following to your .bashrc or .zshrc
# Add to PATH to Install and run programs with "pip install --user"
export PATH=$PATH:~/.local/bin
Usage
To increase brightness, contrast, sharpness by 20% and resize all images (landscape, portrait) to max dimension of 1920 pixels (using largest dimension. hight or width) and compress them to 60% in a given folder while keeping the same aspect ratio.
pillowcover -d /home/user/Pictures/ -b 1.20 -c 1.20 -s 1.20 -r 1920 -q 60
To crop (640*480 from the left corner) and convert (from png to jpg) all images in a folder.
plc -d /home/user/Pictures/ -k "0,0,640,480" -x jpg
Usage Options
usage: pillowcover [-h] [-v] [-d DIR] [-o OUTPUT_DIR] [-b BRIGHTNESS] [-c CONTRAST]
[-s SHARPNESS] [-r RESIZE] [-R RESIZE_RATIO] [-k CROP]
[-q COMPRESSION] [-x EXTENSION]
[image_file]
PillowCover: Mass Manipulate Images Using Python: Change Brightness, Contrast,
Sharpness, Resize, Compress, Crop and Convert. A simple script (wrapper) using
pillow. Licensed Under: GNU General Public License v3 or later (GPLv3+)
positional arguments:
image_file Full path to the image file to edit
optional arguments:
-h, --help show this help message and exit
-v, --version show program\'s version number and exit
-d DIR, --dir DIR Path to the directory containing the image files
-o OUTPUT_DIR, --out-dir OUTPUT_DIR
Path to output directory to store edited images. by
default they get stored in (parent
director)/pillowcover-output
-b BRIGHTNESS, --brightness BRIGHTNESS
Change brightness level, 1.00 is the current value
-c CONTRAST, --contrast CONTRAST
Change contrast level, 1.00 is the current value
-s SHARPNESS, --sharpness SHARPNESS
Change sharpness level, 1.00 is the current value
-r RESIZE, --resize RESIZE
Resize img, keep ratio. provide the maximum
length/width value as one number. e.g pillowcase.py
img -r 1920
-R RESIZE_RATIO, --resize-ratio RESIZE_RATIO
Resize img by providing new width and length e.g
pillowcase.py img -R "640 480"
-k CROP, --crop CROP Crop img by providing starting point then width and
length from it e.g pillowcase.py img -k "0,0,640,480"
-q COMPRESSION, --compression-quality COMPRESSION
Compression quality 1-100, 100 means no compression at
all
-x EXTENSION, --extension EXTENSION
Specifiy the output extension. Can be 'jpg', 'jpeg',
'png' Default is same as the input file's. e.g
pillowcase.py -d imgdir -x "jpg"
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pillowcover_gui-1.2.0.tar.gz
.
File metadata
- Download URL: pillowcover_gui-1.2.0.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b8e3cc3bd9ef61bf381af7bbb9d2602a8d074fcfb891ef969f01088afcbbf50e |
|
MD5 | 3eb9b60a861e4c223f3aa0c44aabc0f0 |
|
BLAKE2b-256 | 82abc690151d6433de50d2b863e29f4bb6522c852219e2e75a70fde01423f2d5 |