Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/douglascdev/pypixelart
PyPixelArt - A keyboard-centric pixel editor
https://github.com/douglascdev/pypixelart
image-editor image-processing pixel-art pygame python3 vim
Last synced: 3 months ago
JSON representation
PyPixelArt - A keyboard-centric pixel editor
- Host: GitHub
- URL: https://github.com/douglascdev/pypixelart
- Owner: douglascdev
- License: mit
- Created: 2021-08-27T14:03:12.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-04-30T00:40:50.000Z (over 2 years ago)
- Last Synced: 2024-10-12T09:06:19.613Z (3 months ago)
- Topics: image-editor, image-processing, pixel-art, pygame, python3, vim
- Language: Python
- Homepage:
- Size: 89.3 MB
- Stars: 21
- Watchers: 2
- Forks: 4
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PyPixelArt - A keyboard-centric pixel editor
The idea behind PyPixelArt is uniting:
- a [cmdpxl](https://github.com/knosmos/cmdpxl) inspired pixel image editor applied to pixel art.
- [vim](https://github.com/vim/vim) 's keyboard-centric approach to improve productivity. Pretty hard to do with an image editor, but it'll be fun to try xD
- Some very useful functionalities from [aseprite](https://github.com/aseprite/aseprite) and other pixel art editors, such as screen symmetry.
## Features and keybindings
- **Draw** : i
- **Erase**: x
- **Undo**: u
- **Save**: w
- **Zoom**: n, b
- **Move Cursor**: k, j, l, h
- **Grid**: g
- **Symmetry**: s
- **Color selection**: c
- **Color**: 1, 2, 3, 4, 5, 6
- **Help**: Space
## Installation
Install the package with:
```sh
pip install pypixelart
```
## Usage
Run with `pypixelart`.
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
```
pypixelart -f new_image.png -res 20,10
```
To get the full list of options:
```
$ pypixelart --help
PyPixelArt - A keyboard-centric pixel editor
Usage: pypixelart [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.
--debug Print debug-level logging to standard output
--help Show this message and exit.
```
## Contribute!
Any contributions and forks and welcomed and encouraged!
Here's how you can contribute:
- Fork the repository
- Mess around with the code and use [black](https://pypi.org/project/black/) to format it
- Submit a [Pull Request](https://github.com/douglascdev/pypixelart/pulls).