Installation • Command-line completion • Man documentation • Usage • CI Status • Contributing • License
rsz
is a simple utility for image resizing.
To build the rsz
from scratch, make sure you have a working Go 1.19+ workspace (instructions), then:
go install github.com/essentialkaos/rsz@latest
You can download prebuilt binaries for Linux and macOS from EK Apps Repository:
bash <(curl -fsSL https://apps.kaos.st/get) rsz
The latest version of rsz
also available as container image on Docker Hub and GitHub Container Registry:
podman run --rm -it ghcr.io/essentialkaos/rsz:latest image.png 0.55 thumbnail.png
# or
docker run --rm -it ghcr.io/essentialkaos/rsz:latest image.png 0.55 thumbnail.png
You can generate completion for bash
, zsh
or fish
shell.
Bash:
sudo rsz --completion=bash 1> /etc/bash_completion.d/rsz
ZSH:
sudo rsz --completion=zsh 1> /usr/share/zsh/site-functions/rsz
Fish:
sudo rsz --completion=fish 1> /usr/share/fish/vendor_completions.d/rsz.fish
You can generate man page using next command:
rsz --generate-man | sudo gzip > /usr/share/man/man1/rsz.1.gz
Usage: rsz {options} src-image size output-image
Options
--filter, -f name Resampling filter name
--list-filters, -F Print list of supported resampling filters
--no-color, -nc Disable colors in output
--help, -h Show this help message
--version, -v Show version
Examples
rsz image.png 256x256 thumbnail.png
Convert image to exact size
rsz -f Lanczos image.png 256x256 thumbnail.png
Convert image to exact size using Lanczos resampling filter
rsz image.png 25% thumbnail.png
Convert image to relative size (25% of original)
rsz image.png 0.55 thumbnail.png
Convert image to relative size (55% of original)
Branch | Status |
---|---|
master |
|
develop |
Before contributing to this project please read our Contributing Guidelines.