Turn picture into characters using braille system

• python (python 3 would be preferable)
• numpy
• pillow

In terminal, run:

python <path-to-python-file> <path-to-image>

or:

python <path-to-python-file> <path-to-image> [<path-to-text-file>]

Recommend using small pictures or doing some edits on the picture before turning it into dots.

It works fine with color pictures. Not supporting transparency.

If you ever get an error with location then open img2dot.py and change the dirpath to your folder in which img2dot.py is.

If you use this in command prompt on Windows, you will only get a whole bunch of \xxxx characters. But worry not, it's fine if you export them to a file.

However, notepad may not read that file properly because of the different in newline character between linux and windows. Open it with notepad ++ or the like.

⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠠⠶⠾⠀
⠀⠀⠀⠀⠀⠀⠀⠤⠤⠤⠀⠀⠀⠀⠠⠤⠤⠄⠀⠀⠀⠀⠀⠀⠠⠾⠿⠿⠇⠀
⠀⠀⠀⠀⠀⠀⠠⠿⠉⠙⠙⠦⠠⠞⠫⠭⠙⠿⠀⠀⠀⠠⠾⠀⠾⠟⠴⠿⠁⠀
⠀⠀⠀⠀⠀⠀⠸⠇⠾⠀⠀⠈⠛⠵⠛⠀⠀⠸⠄⠀⠠⠟⠿⠱⠋⠴⠿⠁⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠿⠘⠧⠀⠀⠠⠏⠀⠀⠀⠟⠀⠀⠘⠇⠿⠷⠿⠿⠷⠗⠀⠀
⠀⠀⠀⠀⠀⠀⠠⠾⠓⠊⠓⠦⠼⠀⠀⠠⠚⠳⠤⠀⠠⠾⠿⠋⠽⠿⠟⠀⠀⠀
⠀⠀⠀⠀⠀⠼⠏⠀⠀⠀⠀⠴⠻⠍⠉⠙⠛⠷⠞⠷⠘⠩⠴⠾⠿⠋⠀⠀⠀⠀
⠀⠠⠤⠤⠴⠿⠀⠤⠤⠶⠋⠁⠀⠧⠀⠀⠀⠀⠈⠼⠇⠭⠿⠛⠻⠆⠀⠀⠀⠀
⠀⠈⠿⠟⠙⠻⠷⠾⠽⠲⠎⠀⠀⠺⠸⠶⠶⠶⠾⠿⠥⠏⠶⠁⠈⠷⠀⠀⠀⠀
⠀⠀⠀⠙⠿⠷⠶⠶⠤⠈⠷⠀⠀⠽⠸⠢⠇⠄⠀⠀⠙⠼⠇⠀⠀⠏⠀⠀⠀⠀
⠀⠀⠠⠾⠿⠟⠋⠉⠤⠆⠘⠧⠄⠧⠏⠀⠹⠜⠦⠀⠀⠸⠀⠀⠘⠋⠓⠶⠄⠀
⠀⠼⠿⠿⠧⠴⠾⠿⠟⠱⠶⠌⠛⠋⠀⠀⠀⠱⠮⠙⠒⠼⠗⠚⠋⠛⠛⠊⠻⠧
⠘⠻⠟⠿⠻⠻⠛⠉⠰⠯⠂⠉⠢⠀⠠⠄⠴⠋⠀⠀⠠⠎⠸⠄⠀⠀⠀⠠⠾⠃
⠀⠀⠀⠀⠀⠀⠀⠀⠘⠞⠇⠀⠸⠫⠵⠻⠇⠀⠤⠶⠫⠀⠀⠹⠜⠖⠚⠋⠁⠀
⠀⠀⠀⠀⠀⠠⠖⠋⠉⠁⠹⠄⠰⠋⠀⠸⠷⠭⠭⠶⠿⠀⠀⠸⠇⠇⠀⠀⠀⠀
⠀⠀⠸⠿⠳⠾⠅⠤⠤⠤⠤⠿⠣⠤⠐⠾⠁⠀⠦⠬⠙⠳⠤⠐⠽⠃⠀⠀⠀⠀
⠀⠀⠀⠹⠶⠭⠹⠮⠥⠕⠁⠸⠀⠈⠙⠮⠣⠀⠝⠿⠿⠶⠿⠿⠏⠀⠀⠀⠀⠀
⠀⠴⠾⠟⠛⠛⠙⠄⠸⠁⠀⠼⠲⠄⠀⠈⠼⠰⠧⠹⠏⠙⠛⠛⠛⠂⠀⠀⠀⠀
⠘⠻⠿⠿⠾⠾⠟⠁⠸⠆⠐⠫⠎⠉⠛⠋⠋⠁⠻⠿⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠀⠀⠀⠛⠛⠋⠀⠀⠀⠀⠀⠀⠀⠙⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀