Navigation Menu

Skip to content

ChuckCaplan/ExcelArt

Repository files navigation

ExcelArt

This project takes an image as input and outputs an Excel spreadsheet, with each cell's background color being the RGB values from the image. In other words, it converts your images into Excel Art.

Idea from Matt Parker - https://www.youtube.com/watch?v=UBX2QQHlQ_I

Getting Started

Prerequisites

Git
Java
Maven

Installing

Clone the GitHub repo.

git clone http://www.github.com/ChuckCaplan/ExcelArt

Compile the project with Maven.

cd ExcelArt
mvn package

Run ExcelArt

Running with Maven is easy (though you can also run with the java command directly).

mvn exec:java -Dexec.mainClass="com.chuckcaplan.excelart.Main" -Dexec.args="-i sample.jpg"

The file output.xlsx should now exist in your directory. Open it in Excel and zoom out to 10% to view the image.

Try Different Options

mvn exec:java -Dexec.mainClass="com.chuckcaplan.excelart.Main" -Dexec.args="--help"

 Usage: java com.chuckcaplan.excelart.Main [options]
  Options:
  * -i
      The filesystem path or URL of the input image.
    -o
      The filename of the resulting .xlsx spreadsheet.
      Default: output.xlsx
    -h, --help
      Show this help.

Notes

  • It takes 19 seconds to process the sample JPG included with the application on a 2020 M1 Macbook Pro with 16GB RAM using the default JVM memory settings.

Author

License

This project is licensed under the MIT License - see the LICENSE file for details

About

Create beautiful Excel art from an image.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages