A command-line tool for basic image processing tasks.
Project description
pixi-cli✨
pixi-cli is a command-line tool for image conversion and basic image processing tasks.
Features
- Crop images
- Adjust exposure
- Adjust saturation
- Adjust contrast
- Adjust sharpness
- Apply box blur
- Apply Gaussian blur
- Reduce noise
- Detect edges
- Convert images to black and white
- Invert colors
- Rotate images (90, 180, 270 degrees)
- Flip images (horizontally and vertically)
- Create thumbnails
- Compress images
- Get image size
- Fetch image metadata
- Convert between image formats (e.g., jpg, png, bmp, gif, tiff, svg)
Installation
You can either download Pixi-CLI through PyPI (recommended) or you can download the executable.
Installing via PyPI
- Ensure you have Python and pip installed on your machine.
- Install pixi-cli using pip:
pip install pixi-cli
Downloading the Executable
Download the executable from the latest release of pixi
from the Releases page and run it directly.
Usage
Basic Usage
- Open a terminal or Command Prompt.
- Use the command line to perform various image processing tasks.
Examples
-
Get Image Size:
pixi /path/to/input.jpg --size
-
Get Image Metadata:
pixi /path/to/input.jpg --metadata
-
Crop Image:
pixi /path/to/input.jpg --output_path /path/to/output.jpg --crop 50 50 200 200
-
Adjust Exposure:
pixi /path/to/input.jpg --output_path /path/to/output.jpg --exposure 1.2
-
Apply Gaussian Blur:
pixi /path/to/input.jpg --output_path /path/to/output.jpg --gaussian_blur 2.0
-
Convert to Black and White:
pixi /path/to/input.jpg --output_path /path/to/output.jpg --bw
-
Rotate Image 90 Degrees:
pixi /path/to/input.jpg --rotate90
-
Convert Image Format:
pixi /path/to/input.jpg --convert png
Full Command-Line Arguments
image_path
: Path to the input image (required).--output_path
: Path to save the processed image (required for processing operations).--crop LEFT TOP RIGHT BOTTOM
: Crop the image to the specified box.--exposure EV
: Adjust the exposure by a certain number of exposure values.--saturation LEVEL
: Adjust saturation level.--contrast LEVEL
: Adjust the contrast by the given factor.--sharpness FACTOR
: Adjust the sharpness by the given factor.--box_blur RADIUS
: Apply box blur with the specified radius.--gaussian_blur RADIUS
: Apply Gaussian blur with the specified radius.--reduce_noise
: Reduce noise in the image.--edge_detect
: Detect edges in the image--bw
: Convert the image to black and white.--invert
: Invert the colors of the image.--thumbnail width height
: Create a thumbnail of the specified size.--compression QUALITY
: Compress the image to the specified quality (0-100).--size
: Get the size of the image.--metadata
: Fetch the metadata of the image.--rotate90
: Rotate the image 90 degrees clockwise.--rotate180
: Rotate the image 180 degrees.--rotate270
: Rotate the image 270 degrees clockwise.--flip_horiz
: Flip the image horizontally.--flip_vert
: Flip the image vertically.--convert FORMAT
: Convert the image to the specified format.
Getting help
For more options and detailed usage, run:
pixi --help
Contributing
Contributions are welcome! Please fork the repository and submit pull requests.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.