asciifier

commit e78d904e0df26c487b0c265f5f499b914419e25d
parent da838413b5587c82d4cdb7244db7f03f6423b35a
Author: Michael Constantine Dimopoulos <mk@mcdim.xyz>
Date:   Sun, 19 Jun 2022 07:42:44 +0000

Added readme

Diffstat:
A
README.md
 | 
22
++++++++++++++++++++++

1 file changed, 22 insertions(+), 0 deletions(-)
diff --git a/README.md b/README.md
@@ -0,0 +1,22 @@
+![logo](https://mcdim.xyz/media/logo1.png)
+
+# Asciifier
+
+Python script of <100 SLOC to turn images to ASCII art. Works by dividing the image into squares according to the available terminal columns and rows, and getting the average color value of each squares pixels. Then, based on the average value and the brightness threshold, it prints out the respective character from an array of 7 characters, each corresponding to a different amount of value.
+
+## Installation
+Run the following commands to install
+```
+$ git clone https://github.com/MichaelDim02/asciifier && cd asciifier
+$ pip3 install -r requirements.txt
+```
+
+## Options
++ `-h` print help panel
++ `-f` path to the image file
++ `-t` adjust brightness threshold
++ `-i` invert colors
+
+## Screenshots
+![girl](https://mcdim.xyz/media/girl_ascii.png)
+![griffin](https://mcdim.xyz/media/griffin_ascii.png)