Là một công cụ cho lập trình viên, jarun/imgp đã đạt 1.1k sao trên GitHub, ngôn ngữ Python. :camera_flash: Fast batch image resizer and rotator
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Watch imgp resize a directory of images in lightning speed!
imgp is a command line image resizer and rotator for JPEG, PNG and WEBP images. It can resize (or thumbnail) and rotate thousands of images in a go, at lightning speed, while saving significantly on storage.
Powered by multiprocessing, SIMD parallelism (thanks to the Pillow-SIMD library), an intelligent adaptive algorithm, recursive operations, shell completion scripts, EXIF preservation (and more), imgp is a very flexible utility with well-documented easy to use options.
imgp intends to be a stronger replacement of the Nautilus Image Converter extension, not tied to any file manager and way faster. On desktop environments (like Xfce or LxQt) which do not integrate Nautilus, imgp will save your day. File manager nnn provides a script to batch resize images with imgp.
Table of Contents
Features
Adaptive mode
Performance
Installation
Dependencies
From a package manager
Release packages
From source
Running standalone
Shell completion
Usage
cmdline options
Operational notes
Examples
Troubleshooting
Developers
Features
resize by percentage or resolution or megapixel target
rotate clockwise by specified angle
adaptive resize considering orientation
brute force to a resolution
optimize images to save more space
limit processing by minimum image size
convert PNG/WEBP to JPEG
erase exif metadata
specify output JPEG image quality
force smaller to larger resize
process directories recursively
overwrite source image option
completion scripts for bash, fish, zsh
minimal dependencies
Adaptive mode
If the specified and image orientations are same [(H >= V and h > v) or (H < V and h < v)], the image is resized with the longer specified side as reference.
In case of cross orientation [(H >= V and h <= v) or (H < V and h >= v)], the image is resized with the shorter specified side as reference. Same as non-adaptive.
For example, if an image has a resolution of 2048x1365 and is being resized to 1366x768:
In regular mode (default), output image resolution will be 1152x768
In adaptive mode, output image resolution will be 1366x910
Performance
imgp could resize 8823 images (approx. 4.5GB in size) of mixed resolutions (high to regular) stored in a USB 2.0 external hard disk at an adaptive resolution of 1366x1000 in around 8 minutes. The resulting size was 897MB (approx. 20%).
imgp uses Python PIL/Pillow library. Nautilus Image Converter calls the convert utility from ImageMagick. For a comparative benchmark, head here.
Installation
Dependencies
imgp requires Python 3.10 or later.
To install PIL library on Ubuntu, run:
sudo apt-get install python3-pil
or, using pip3:
sudo pip3 install pillow
pillow can be replaced by pillow-simd on SIMD processors.
From a package manager
Install imgp from your package manager. If the version available is dated try an alternative installation method.
Packages for Arch Linux, CentOS, Debian, Fedora, openSUSE Leap and Ubuntu are available with the latest stable release.
From source
If you have git installed, clone this repository. Otherwise download the latest stable release or development version (risky).
Install to default location (/usr/local):
sudo make install
To remove, run:
sudo make uninstall
PREFIX is supported, in case you want to install to a different location.
Running standalone
imgp is a standalone utility. From the containing directory, run:
./imgp
Shell completion
Shell completion scripts for Bash, Fish and Zsh can be found in respective subdirectories of auto-completion/. Please refer to your shell's manual for installation instructions.
Usage
cmdline options
usage: imgp [-h] [-x res] [-o deg] [-a] [-c] [-e] [-f] [-H] [-i] [-k] [-m] [-M res]
[-n] [-N] [-O] [-P] [-q N] [-r] [-s byte] [-w] [-d] [-v] [PATH ...]
Resize, rotate JPEG, PNG and WEBP images.
positional arguments:
PATH source file or dir [default: current dir]
optional arguments:
-h, --help show this help message and exit
-x res, --res res output resolution in HxV or percentage ("%" suffix) or megapixel ("MP" suffix)
-o deg, --rotate deg rotate clockwise by angle (in degrees)
-a, --adapt adapt to resolution by orientation [default: off]
-c, --convert convert PNG/WEBP to JPG format [default: off]
-e, --eraseexif erase exif metadata [default: off]
-f, --force force to exact specified resolution [default: off]
-H, --hidden include hidden (dot) files [default: off]
-i, --includeimgp re-process _IMGP files. * RISKY: refer to docs
-k, --keep skip (honors -c or --pr) images matching specified
H or V or --res=100 [default: off]
-m, --mute operate silently [default: informative]
-M res, --minres res min resolution in HxV or percentage of --res to resize
-n, --enlarge enlarge smaller images [default: off]
-N, --nearest use nearest neighbour interpolation for PNG [default: antialias]
-O, --optimize optimize the output images [default: off]
-P, --progressive save JPEG images as progressive [default: off]
-q N, --quality N quality factor (N=1-95, JPEG only) [default: 75]
-r, --recurse process non-symbolic dirs recursively [default: off]
-s byte, --size byte minimum size to process an image [default: 1024]
-w, --overwrite overwrite source images [default: off]
-d, --debug enable debug logs [default: off]
-v, --version show program's version number and exit
Operational notes
Multiple files and directories can be specified as source. If PATH is omitted, the current directory is processed.
Output image names are appended with _IMGP if --overwrite option is not used. By default _IMGP files are not processed. Doing so may lead to potential race conditions when --overwrite option is used.
PNG/WEBP files with lower target hres/vres are not converted (even if --convert is used). Run imgp --convert (*.png) separately to convert those.
Resize and rotate are lossy operations. For additional reductions in size try --optimize and --eraseexif options.
Option --optimize is slower, the encoder makes an extra pass over the image in order to select optimal encoder settings.
Adapt the images in the current directory to 1366x1000 resolution. Visit all directories recursively, overwrite source images, ignore images with matching hres or vres but convert PNG/WEBP images to JPEG.
$ imgp -x 1366x1000 -wrack
Set hres=800 and adapt vres maintaining the ratio.
Generate a 64px adaptive thumbnail of the last modified file in the current dir:
#!/usr/bin/env sh
thumb64 ()
{
pop=$(ls -1t | head -1)
imgp -acx 64x64 "$pop"
}
Troubleshooting
To lift the pixel limit (e.g. error 'PIL.Image.DecompressionBombError' when resizing large image) for trusted input files, uncomment the following line in the source code:
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/jarun/imgp là nguồn chính thức.
jarun/imgp có bao nhiêu sao?
jarun/imgp có 1.1k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/jarun/imgp. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
jarun/imgp có phải mã nguồn mở không?
Có — jarun/imgp phát hành theo license GPL-3.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/jarun/imgp.
jarun/imgp còn đang phát triển không?
Commit gần nhất trên jarun/imgp là 5 ngày trước (theo timestamp GitHub). Repo có 52 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
jarun/imgp là gì?
jarun/imgp (jarun/imgp) là dự án Python trên GitHub. Theo mô tả gốc: :camera_flash: Fast batch image resizer and rotator
jarun/imgp so với các dự án Developer Tools khác thế nào?
jarun/imgp được TopGit xếp vào nhóm Developer Tools, với 1.1k sao GitHub và viết bằng Python. Xem trang chủ đề Developer Tools trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Đọc đầy đủ README ở tab phía trên.
Muốn nghe thêm một ý kiến về imgp?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về imgp.