PIX

PyPI - Python Version

A simple image manipulation tool for the terminal.

⭐️ Like this repo? please consider a star!

💡 This project is still earily in its development. Please report any bugs or issues you encounter.

🌟 Features

pip install zz-pix

git clone https://github.com/sean1832/pix.git
cd pix
pip install .

pix [COMMAND] [OPTIONS]

Replace [COMMAND] with the desired operation and [OPTIONS] with the relevant options for your command.

Command	Description
convert	Converts images to a different format
resize	Resizes images
crop	Crops images
prune	Removes images smaller than specified resolution

Converts images to a different formats. Currently supports JPEG, PNG, WEBP, TIFF, ICO, AVIF, HEIF, BMP.

pix convert input.jpg output.webp [OPTIONS]

Option	Input Type	Description	Default
`input`	String	Input image or directory	N/A
`output`	String	Output image or directory	Current dir.
`-f`, `--format`	String	Output format (supported formats listed)	N/A
`-q`, `--quality`	Integer	Output quality (0-100)	95
`--no-optimize`	Flag	Disable optimization	N/A
`-o`, `--overwrite`	Flag	Overwrite existing files	N/A
`-t`, `--transparent`	Flag	Preserve transparency	N/A
`--prefix`	String	Prefix for the output file name	""
`--surfix`	String	Suffix for the output file name	""

Resizes images to a specified size or scale.

pix resize input.jpg output.jpg [OPTIONS]

Option	Input Type	Description	Default
`input`	String	Input image or directory	N/A
`output`	String	Output image or directory	Current dir.
`--overwrite`	Flag	Overwrite existing files	N/A
`--size`	String	Output size (WxH)	N/A
`--scale`	Float	Output scale (0.0-1.0)	N/A

Crops images to a specified size and position.

pix crop input.jpg output.jpg [OPTIONS]

Option	Input Type	Description	Default
`input`	String	Input image or directory	N/A
`output`	String	Output image or directory	Current dir.
`--overwrite`	Flag	Overwrite existing files	N/A
`--ratio`	String	Aspect ratio (W:H), combined with `--align`	N/A
`--size`	String	Exact size and position as WxH+X+Y	N/A
`--align`	String	Alignment (top, bottom, left, right, center)	N/A

Removes images smaller than a specified resolution.

pix prune ./images [OPTIONS]

Option	Input Type	Description	Default
input	String	Input image or directory	N/A
`-r`, `--resolution`	String	Minimum resolution (WxH)	N/A
`--dry-run`	Flag	List files to be removed without deleting them	N/A

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for zz-pix 0.0.9
File	Size	Uploaded
zz-pix-0.0.9.tar.gz	13.1 kB	Jun 22, 2024	Details

Table of built distributions (wheels) for zz-pix 0.0.9
File	Interpreter	ABI	Platform	Reset
zz_pix-0.0.9-py3-none-any.whl 13.8 kB Jun 22, 2024	Python 3	none	any	Details

Total release size: 26.9 kB

Download URL	zz-pix-0.0.9.tar.gz
Size	13.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`3d1b987a37c08446373667705057a36c4c99072fd2d0b0a38585648baf55fee1`
BLAKE2b-256 checksum How to use checksums	`adf15bb2cc0cf5f34a59c2c4a1dd040cd7a98fc406a576b3febd9a3447923a8d`
Upload date	Jun 22, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.10.11`

Download URL	zz_pix-0.0.9-py3-none-any.whl
Size	13.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`662fedad179bacf18031c9ed491609025a9051d96574e7934444635a1c16d7d9`
BLAKE2b-256 checksum How to use checksums	`b2602711545cee02af58d241133265c56efc6785b32d8ec320311322e994c71b`
Upload date	Jun 22, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.10.11`