▐██████▇▇▇▇▇▆▆▅▄
                      ▇▇▇▆▅◣▂    ▐███████████████▍
                       ██████▇◣  ▐███████████████▍
                      ▆ ████████◣▐███████████████▍
                      █▋ ███████▋▐███████████████▍
                      ██▍▐██████▋▐███████████████▍
                      ███ ██████▋▐███████████████▍
                      ▒██▍▓████◤▔▐██████████████▋▍
                      ◢▆▅◣▄▔▃▃▃▃  ▔▔▔▔▔▔▔▔▔▔▔▄▅▆▆▎
                      ▐▓▓▓▓▓▓▓▓▓▋▐▓▓▓▓▓▓▓▓▓▓▓▓▓▓▋
                       ▐▓▓▓▓▓▓▓▓▋▐▓▓▓▓▓▓▓▓▓▓▓▓▓▓
                        ▔▓▓▓▓▓▓▓▋▐▓▓▓▓▓▓▓▓▓▓▓▓▓
                         ▔▒▓▓▓▓▓▓ ▓▓▓▓▓▓▓▓▓▓▓◤
                           ▔▔▒▓▓▓▎▐▓▓▓▓▓▓▓▍▔▔
                               ▔▔  ░▔▔▔▔▔
            
             ▆   ▆  ◢▆▆▆◣  ▆  ▆   ▆  ▆  ▅◤▆◤ ◢◤ ◢▅▆▆◣  ◢▅▆▆◣
             █▍  ▓▍ ▓▍  █▎ █▎ ▔▋▂▆▍ ▐█▎ ▒▆◣  ▐▋ ▓▍  ▐▋ ▓▍  ▓
             ▔▋▅▅▋  █▎  █▍ █▎  ▐█▍  ▐█▎ ▅▄▅▍ ▐▋ ▔▆▅▅▓  ▓▍  ▓

Convert any image into x256 color or b/w unicode

Use-cases

• Make your CLI application pretty!
• Generate art or use univision as a filter

How To

Install Dependencies

pip3 install -r requirements.txt

Convert Image

Color: ./convert.py <path_to_image_file> B/W: ./convert.py <path_to_image_file> bw

Taylor Swift Color Sample

Original

Lightning Skull B/W Sample

                                 ▂▃▄▄▅▅▅▅▅▅▄▄▃▂
                           ▂▄▅▆██████████████████▆▅◣▂
                        ◢▆▇██▊▔◢▄▅▆▇▇▓▓▓▓▓▓▇▆▆▅◣▔▔███▇▅◣░░▂
                  ◢░░◢▆██▊▔◢▆▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▋░◢▄◣▔███▅▂░▆◣
                ░░░◢▇██▔◢▆▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▋░◢▅▆███▍░░░▔██▆◣░▓◣▂
             ◢░░░◢▆█▋▔▄▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▆◤▔█████▍░░░░░░▔██▆▂▒▓▆◣
           ◢░░░░◢██▔◢▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒░◢▅▆█████▄▅▅▅◤░░░░░▐██◣░▓▓▆◣
          ░░░░░▆█▋◢▆▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▋▒░▄▅▇███████████▊▔░░░░░░░▔██▆░▓▓▓▆▂
        ░░░░░░██▍◢▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▇▆▅▔▔█████████▋░░░░░░░░░░░ ██▋░▓▓▓▓◣
       ░░░░░░▇█▍◢▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▋░◢▆▇█████▔░░░░░░░░░░░░░░ ██▋▐▓▓▓▓▆
      ░░░░░░▐█▋ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒◢▄▇███████████▇▆▅▄░░░░░░░░░░ ██▍▐▓▓▓▓▋░
     ░░░░░░ ██ ▐▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▋░◢▆█████████████████▔░░░░░░░░░░░░▐█▊░▓▓▓▓▓▋░
    ░░░░░░░▐█▍ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▍▃▃▓████████████████▔░░░░░░░░░░░░░░░ ██▎▓▓▓▓▓▓▋
   ░░░░░░░░▐█▎▐▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▋░▅██████████▔░░░░░░░░░░░░░░░░░░ ██▍▐▓▓▓▓▓▓▋
  ░░░░░░░░░██▎▐▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░◢▆██████████████▇▇▇▇▍░░░░░░░░░░░░ ██▍▐▓▓▓▓▓▓▓▍
  ░░░░░░░░░▐█▎▐▓▓▓▓▓▓▓▓▓▓▓▓▓◤◢▆██████████████████▊▔░░░░░░░░░░░░░░ ██▍▐▓▓▓▓▓▓▓▋
 ░░░░░░░░░░▐█▍░▓▓▓▓▓▓▓▓▓▓▋░◢▇█████████████████▊▔░░░░░░░░░░░░░░░░░ ██▍▓▓▓▓▓▓▓▓▓▍
 ░░░░░░░░░░░█▋ ▓▓▓▓▓▓▓▓▓▓▇▇▆▆▆◤▂▅██████████▋▔░░░░░░░░░░░░░░░░░░░░◢██░▓▓▓▓▓▓▓▓▓▋
 ░░░░░░░░░░░██▍░▓▓▓▓▓▓▓▓▓▓▓▓▋◢▆████████████████▇▍ ░░░░░░░░░░░░░░ ██▋▐▓▓▓▓▓▓▓▓▓▋
 ░░░░░░░░░░░▐██░▐▓▓▓▓▓▓▓▓▓◤◢▆████████████████▔░░░░░░░░░░░░░░░░░░▐██░▓▓▓▓▓▓▓▓▓▓▓
 ░░░░░░░░░░░ ▊█▊ ▐▓▓▓▓▓▓▓▄▄▔██▊██████████▊▔░░░░░░░░░░░░░░░░░░░░◢██▎▓▓▓▓▓▓▓▓▓▓▓▓
 ░░░░░░░░░░░ ▐███▂░▓▓▓▓▓▓▓▓▓▓▋◢████████▅◣░░░░░░░░░░░░░░░░░░░░░◢██▍▆▓▓▓▓▓▓▓▓▓▓▓▋
 ░░░░░░░░░░░  ████◣▔▓▓▓▓▓▓▓▓▋◢█████████▋▔░░░░░░░░░░░░░░░░░░░▂▆██▔▆▓▓▓▓▓▓▓▓▓▓▓▓▍
 ░░░░░░░░░░░░ ◢▐█▔█▇▃▔▓▓▓▓▓▍◢██████▔▔░░░░░░░░░░░░░░░░░░░░░░▅███▎▓▓▓▓▓▓▓▓▓▓▓▓▓▓▎
  ░░░░░░░░░░░ ▐▍█▍▐▌█▆▃▔▒▓▍▆███████▍░░░░░░░░░░░░░░░░░░░░░▄███▐▋▐▓▓▓▓▓▓▓▓▓▓▓▓▓▋
  ░░░░░░░░░░░░ ▋▐▍▐▍███▇◣▂░███▊▔░░░░░░░░░░░░░░░░░░░░░░◢▆████▋▐▋▐▓▓▓▓▓▓▓▓▓▓▓▓▓▍
   ░░░░░░░░░░░ ▊▊▐▋▐██████▇▅▃░░░░░░░░░░░░░░░░░░░░░▂▄▆███████▌▊▐▐▓▓▓▓▓▓▓▓▓▓▓▓▍
    ░░░░░░░░░░░▋▋▐█▂██████████▇▆▅▄▃▃▂  ░░  ▂▃▃▄▅▆███████████▌█▐░▓▓▓▓▓▓▓▓▓▓▓▋
     ░░░░░░░░░ █▐▆▂▔  ▔███████████████▆◣◢▆██████████████████▅▊◤◢▓▓▓▓▓▓▓▓▓▓▋
      ░░░░░░░░░ ▓▅▋              ▔▔█████████▔░          ▔▔   ▔◢▓▓▓▓▓▓▓▓▓▓▋
       ░░░░░░░░░░░   ▆ ▄▂▃▂ ▂▂▂▂▂▂▂▃◣██████▃▃▃▃▃▃▃▄▄▄▅▅◤◤░  ▆▓▓▓▓▓▓▓▓▓▓▓▍
        ░░░░░░░░░░░ ◢◣◢◣▐▋▐▅████████▋█████████████████▊ ◢░ ▐▓▓▓▓▓▓▓▓▓▓▋▔
          ░░░░░░░░░ ▐▊▐▋▐▌▐███████████▎██▐████████████▋◢█  ▓▓▓▓▓▓▓▓▓▓▍
            ░░░░░░░░░▔▍▔ ▋▐██████████▊ █▍▐████████████▎▐▍ ▆▓▓▓▓▓▓▓▓▍▔
              ░░░░░░░░░░░░░░ ▆▔█▔█████▃█▍◢█████▄◣▇▇◢▅▅▅▆▆▓▓▓▓▓▓▓▓░▔
                ░░░░░░░░░░░░░█▎█▋▐██████████████▌▔◢▓▓▓▓▓▓▓▓▓▓▓▋▔
                   ░░░░░░░░░░ ██▔▅█████████████▐█░▓▓▓▓▓▓▓▓▓▒▔▔
                       ░░░░░░░▐▊ █▍▆█◢▆◣█▇◣▆▇▐█▐▋◢▓▓▓▓▓▒░▔
                            ░░░░░▐▍█▊▐█▌██▋██▐█░▒▒░░▔▔

Original

Future

• Multicore or GPU rendering
• Video Streaming
• OCR string injection
• VNC to Unicode
• Reduce dependencies