Metadata-Version: 2.1
Name: cmdpxl
Version: 0.1.7
Summary: A totally practical command-line image editor
Home-page: https://github.com/knosmos/cmdpxl
Author: Jieruei Chang
Author-email: jierueic@gmail.com
License: MIT license
Keywords: cmdpxl,opencv,image-editor,terminal-based
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: opencv-python (==4.5.3.56)
Requires-Dist: numpy (==1.21.1)
Requires-Dist: click (==8.0.1)

# cmdpxl: a totally practical command-line image editor
![ezgif com-gif-maker (2)](https://user-images.githubusercontent.com/30610197/128618252-d00100dd-6ca4-4089-b7a1-d7790b99a1cc.gif)

## 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:
```sh
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.

![image](https://user-images.githubusercontent.com/30610197/130501861-2ea41d6f-5568-47d9-b7e4-764c9136c979.png)
![image](https://user-images.githubusercontent.com/30610197/130502042-744f269e-9ffc-4089-81bb-5b58a15fa6db.png)
![image](https://user-images.githubusercontent.com/30610197/130501975-88423180-de64-49ff-afc5-dd670d959e9c.png)
![image](https://user-images.githubusercontent.com/30610197/130503771-4ae14006-494b-405c-9657-1eacd013c13f.png)




## Why?
Good question.


