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
- Apply common filters
- 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, requires Python to be installed on your machine) or you can download the executable (more steps, does not requires Python to be installed on your machine)
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 latest release of
pixi
from the Releases page. - Extract the ZIP file to a desired location on your machine.
Adding Pixi to Your PATH
macOS and Linux
- Extract the downloaded ZIP file to a desired location, such as
/usr/local/bin/pixi
. - Make the file executable:
chmod +x /usr/local/bin/pixi
- Open a terminal and edit your shell configuration file (
.bashrc
,.bash_profile
,.zshrc
, etc.):nano ~/.bashrc # or ~/.bash_profile or ~/.zshrc
- Add the following line to include the directory in your PATH:
export PATH=$PATH:/usr/local/bin
- Save the file and source it to apply the changes:
source ~/.bashrc # or source ~/.bash_profile or source ~/.zshrc
- Open a new terminal and type
pixi --help
to verify that it works from any location.
Windows support is coming soon!
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 --output_path /path/to/output.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 factor
: Adjust the exposure by the given factor.--saturation factor
: Adjust the saturation by the given factor.--contrast factor
: 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.
Contributing
Contributions are welcome! Please fork the repository and submit pull requests.
License
This project is licensed under the MIT License.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.