https://github.com/knosmos/cmdpxl
totally practical command-line image editor
https://github.com/knosmos/cmdpxl
cli image-editor opencv python terminal-based
Last synced: 10 months ago
JSON representation
totally practical command-line image editor
- Host: GitHub
- URL: https://github.com/knosmos/cmdpxl
- Owner: knosmos
- License: mit
- Created: 2021-08-06T12:24:08.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-08-27T18:27:23.000Z (over 4 years ago)
- Last Synced: 2025-03-28T08:09:00.383Z (10 months ago)
- Topics: cli, image-editor, opencv, python, terminal-based
- Language: Python
- Homepage:
- Size: 92.8 KB
- Stars: 515
- Watchers: 2
- Forks: 19
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-tuis - cmdpxl - line image editor (Table of Contents)
README
# 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:
```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.
## Why?
Good question.