README.md

cmdpxl: a totally practical command-line image editor

Features

cmdpxl has many exciting functionalities, including

• Editing pixels one at a time!
• Saving images!
• An undo function!
• A fill tool!
• Cool image filters!

Installation

Install the package with:

pip install cmdpxl

Usage

Run with cmdpxl.

You can also specify the file path and resolution: for example, to create a new image that is 20px wide and 10px tall you can use

cmdpxl -f new_image.png -res 20,10

To get the full list of options:

$ cmdpxl --help
Usage: main.py [OPTIONS]

Options:
  -f, --filepath PATH      Path for the file you want to open
  -res, --resolution TEXT  Image height and width separated by a comma, e.g.
                           20,10 for a 20x10 image. Note that no spaces can be
                           used.
  --help                   Show this message and exit.

Examples

Here are some images that have been created with cmdpxl. If you have any images you'd like to share, please open a pull request or create an issue.

Why?

Good question.