https://github.com/nibble-4bits/excel-pixel-art

Create awesome pixel art in Microsoft Excel using Python!
https://github.com/nibble-4bits/excel-pixel-art

excel excel-pixel-art pixel-art python

Last synced: 3 months ago
JSON representation

Create awesome pixel art in Microsoft Excel using Python!

• Host: GitHub
• URL: https://github.com/nibble-4bits/excel-pixel-art
• Owner: nibble-4bits
• License: mit
• Created: 2020-03-04T06:37:30.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2021-01-03T01:13:17.000Z (about 4 years ago)
• Last Synced: 2024-10-13T22:29:59.720Z (4 months ago)
• Topics: excel, excel-pixel-art, pixel-art, python
• Language: Python
• Size: 213 KB
• Stars: 4
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Excel Pixel Art

A simple Python program that takes an image as input and outputs an Excel workbook containing said image.

It works by getting the average of each pixel's RGB data and then applying the resulting color to each corresponding cell in Excel.

## Example

#### Original image

![Van Gogh - Starry Night](starry-night-512px.jpg)

#### Excel Workbook Pixel Art

![Starry Night Excel Pixel Art](starry-night-pixel-art.jpg)

## Prerequisites

- Python 3.6 or above

## Install

```shell

git clone https://github.com/nibble-4bits/excel-pixel-art.git

cd excel-pixel-art

pip install -r requirements.txt

```

### Usage

```shell

python main.py [-h] [-o OUTPUT] [-f FILENAME] [-c CELLSIZE] [-p PIXELSIZE] input

positional arguments:

  input                 The path to the input image

optional arguments:

  -h, --help            show this help message and exit

  -o OUTPUT, --output OUTPUT

                        Path where you want to save your Excel pixel art, if

                        not provided default value will be the same path of

                        this script

  -f FILENAME, --filename FILENAME

                        Name of the resulting Excel workbook, if not provided

                        default value will be "Pixel Art"

  -c CELLSIZE, --cellsize CELLSIZE

                        The size (width and height) in pixels of the workbook

                        cells where the image will be drawn, if not provided

                        default value will be 10px

  -p PIXELSIZE, --pixelsize PIXELSIZE

                        The size of the pixels of the input image. A bigger

                        value means the resulting image will look more

                        pixelated. This value must be a number divisible

                        exactly by both the image width and height. If not

                        provided default value will be 1, which means that one

                        pixel in the input image will map to one cell in the

                        Excel workbook

```

## License

[MIT](https://choosealicense.com/licenses/mit/)