ASCII-Art-Generator

Welcome to the ASCII Art Creator! This tool allows you to transform images into stunning ASCII art. This repo is the code source for https://ascii-art-generator.streamlit.app/.

⡪⠪⡪⡪⡪⢒⣝⢯⢯⣓⢕⢒⠪⣪⡳⣻⢽⣻⣟⣿⣿⣿⣿⣻⢝⣞⣝⣯⣿⣻⢿⠻⠛⠍⢉⠉⠉⠉⠉⢈⠐⠠⠐⠔⡐⠔⠔⠤⡐⢌⣛⢯⢿⣻⣽⢿⡿⣿⣻⢽⢭⢯⣳⡳⡭⣺⢽⣿⡿⣝⢮⣻⣽⢿⣻⢿⣿⣿⣿
⣊⠭⡪⠭⡪⡱⣝⣯⢯⠮⢕⠥⠭⣲⢽⣝⣯⢿⣾⣿⣿⣿⣾⡯⢯⠳⢙⠊⡊⠈⠀⠄⡐⠀⠄⠐⢀⠁⠌⠀⡈⠠⢁⠡⠨⢪⢌⠢⡉⡒⣔⣑⣓⣑⠻⣻⣟⡿⣝⢗⢗⠯⢮⡫⣞⣺⡽⣿⣿⢽⡱⢽⡺⡻⡽⣻⣞⣟⣾
⢔⡩⡪⡩⡊⢎⢾⣺⣫⡫⢕⠭⡪⣪⢗⣗⣯⣿⣷⣿⢟⠓⠃⢉⠀⠅⢐⠀⠄⡁⠁⢂⠀⡂⠄⡁⡀⠐⢀⠐⠀⠀⠂⠔⢌⡢⢕⣕⢌⡢⡂⡓⣆⠖⣕⣑⠪⡫⡳⠭⠭⢝⢕⢝⣒⣒⢯⣿⣟⡧⢍⢕⠭⢝⣚⠵⣝⢮⡳
⠢⠢⡊⠢⢊⠪⣝⢮⢗⡪⢕⡫⡪⢮⣫⢷⡿⠽⠑⠐⡀⢀⠂⡀⠌⢀⠂⡈⠄⢂⢑⢄⠕⢌⠊⢀⠠⢁⢀⠐⠈⠠⠁⢈⠹⣞⡪⠪⡓⠮⡊⠄⡢⡩⠢⣒⢍⡒⡩⡩⠩⡑⠕⠥⡂⡒⣝⣿⡾⡪⡐⡡⢊⢕⢔⢍⣒⢕⢭
⢑⢑⠨⡨⢂⠭⡺⣝⡗⡭⠵⠭⣪⣳⡻⠫⠊⠀⡈⠐⠀⠄⠐⠠⠂⠠⢀⠐⢈⢄⠅⡢⡑⠤⡊⡢⢕⣑⣒⡬⡪⢔⡪⢔⢌⠔⠥⠡⢈⢑⣊⢊⠠⠨⡑⠔⡐⢈⠢⡈⡊⡐⠡⠑⡈⡐⣺⣺⡯⡣⡐⡐⠔⢔⠔⡢⠢⡑⡂
⠡⢂⢅⠢⠡⢕⡻⣮⡫⠮⢝⢝⠮⠊⠈⠠⢀⠂⡀⡐⢈⠀⠠⠀⠠⠀⠂⠌⢂⢂⢊⠔⣌⢵⢬⣲⢵⡲⣲⢭⣺⣱⣪⣒⣒⡪⠬⣑⠢⡐⢔⠔⢅⠥⡂⡁⣒⢄⠐⡐⢐⠀⠂⠡⠠⠐⣪⢯⡿⡕⢐⠨⠨⠢⡑⡐⡈⠔⠨
⠨⡐⠔⠨⠨⡪⡺⣪⣚⠭⠭⠑⠐⢀⠁⠂⠄⡐⠀⠄⠂⢀⠁⠀⠄⢈⠐⣈⢢⢢⣳⣝⣞⣷⣻⢽⣳⢿⢽⡽⣞⡾⣞⣾⣺⢞⡯⣮⡳⡬⢕⠭⣒⣑⡪⣒⢔⡒⢕⡐⠄⠅⡁⠂⠄⠨⣸⢽⣟⢎⠄⠊⠌⠂⡂⠄⠄⠡⠡
⠨⢌⠨⠨⡈⡪⡺⡕⣒⠩⠈⡀⠁⠠⠈⡐⢀⠐⢀⠐⠀⠂⢀⠠⡐⣐⠬⣲⣝⣯⣳⣻⣺⡺⡽⡽⣝⡯⢯⣻⢽⢽⢽⢞⣾⡻⣽⣳⣟⡾⣝⣝⣖⣲⢽⣽⣵⢮⢵⡊⠕⡡⠐⡈⠠⢀⢺⣽⣯⣓⠠⠁⢁⠁⠄⠂⠌⡈⠌
⢘⢐⠌⡂⡂⠭⢮⠭⠂⠐⡀⠠⠈⠠⢀⠠⢀⠐⠠⠨⠨⡨⡢⡱⣪⣞⣯⢯⣷⣳⣻⣺⢮⡯⡯⣫⡳⣝⢽⡲⣫⢯⢯⡻⣮⣻⢽⣺⢾⣽⣟⣾⣽⣞⣟⡾⣽⣻⣳⣯⣓⢔⠡⠐⡐⠀⢵⣳⣟⠦⠡⠨⡠⡈⠤⡁⡢⡢⣑
⣒⡥⣒⢔⢬⢭⣇⠃⢈⠀⠄⢁⢈⠐⠠⠐⠠⠊⢌⠨⡊⣒⡪⡺⡵⣳⡯⣟⡾⡽⣞⣞⢷⢽⡺⣕⡯⢮⡳⣝⢵⣫⢷⢽⣺⣺⡻⣞⡿⡾⣾⣳⡷⡷⡯⣟⡷⣟⢷⣳⢿⢵⢅⠅⢂⢈⢪⣯⣟⡭⣊⡪⣒⣪⢕⣊⣒⡺⡲
⡷⣯⣳⢯⡿⣟⠂⢀⠂⠠⢈⠠⠀⢂⠁⠊⠨⠨⢐⡑⠬⡒⡪⣝⡯⣗⠯⡳⣽⢽⣝⣞⢗⢯⢾⢵⢝⠵⡭⢮⡳⣝⣵⣫⢾⣪⣟⣷⣻⢿⣽⣷⣻⡽⣯⣯⢯⣯⢿⡽⣽⣻⣳⠭⡐⡀⠵⡷⣿⡪⣒⣪⢮⢮⣓⢖⣵⡻⡽
⣿⡷⣟⣿⡽⡁⠠⢀⠂⠐⠀⠄⡁⠂⠌⡈⠌⢌⢒⢌⠭⡪⡪⡳⢝⢮⡫⣏⢮⡳⣳⢽⢭⢯⣳⡻⣝⢝⢮⡳⣝⠮⡮⡳⣳⡻⣞⣟⣯⣿⣟⣾⣯⢿⣻⣾⢿⡽⣯⣟⢷⣳⣻⣻⣔⠠⡹⣽⣟⢮⡪⣒⡳⢝⡒⠭⠮⢝⠮
⣟⣟⡯⡯⠎⢀⠐⠀⢀⠈⡀⠂⠠⠁⠂⠄⠅⢅⠥⣑⡪⡪⡪⣪⣓⡳⣝⡮⣗⢯⣓⢗⣗⡳⡵⡻⡺⡭⡳⡺⢜⣝⢮⡫⣗⡯⡷⡯⡷⣷⣟⣷⣯⡿⣽⢾⣯⣟⣷⡽⣽⢵⢷⣻⢮⢆⣚⣽⣯⢗⠪⡢⡪⡑⢌⢍⠭⠕⢑
⡵⡵⡭⡎⠅⠠⠀⡁⠠⠀⠄⢈⠀⠂⡁⡊⡈⡢⡑⣒⠬⡒⡪⣒⣒⣫⣳⢽⣺⢽⣪⡳⣕⣝⢞⡽⡽⡽⣝⣝⣝⢖⡳⢝⡮⡯⡯⣟⡿⡷⣿⣽⡾⡿⣿⣻⡷⣟⣾⢯⣿⡽⣯⣞⡯⣗⣒⢯⣿⢭⠭⡪⡪⡨⢐⡐⣊⢊⢐
⣚⢞⢞⡊⠄⠁⠠⠀⡐⠀⠂⡀⠂⢁⠐⢀⢂⠪⠨⠢⡑⢌⣊⣒⡲⢵⢽⢽⡺⡽⣲⢝⢖⡮⡯⣞⣽⡽⣞⡾⡮⣗⣯⣳⢝⣞⡯⣯⡿⣽⣟⣾⣻⣟⣿⣽⢿⣽⣯⣿⢷⣟⡷⣗⢯⣳⢕⠽⣿⡽⣝⢮⡪⢌⢕⢮⣓⣅⠢
⡲⣝⡗⠌⡀⠂⠠⠀⠄⠐⠀⠄⠈⠄⡈⡀⢂⠨⠈⡂⡊⡢⠢⣒⢽⢽⢽⢷⢯⣟⢗⠯⠓⠝⠚⠙⠪⠙⠩⠙⠙⠩⢊⢚⠝⡚⠯⡻⡻⡿⣿⣽⣟⣾⡿⣽⣿⢿⣯⣿⢿⣟⣿⣽⣳⣯⡳⡩⢽⣯⢗⣗⡪⢕⣝⡵⣗⢖⣑
⣯⢯⡯⠂⢄⢁⠀⠂⠠⠁⠐⠀⠡⠐⠠⠐⡀⢂⠁⠔⡐⠬⡪⡮⡳⠫⠋⠍⢁⢂⢂⠄⠈⠰⡿⣵⠄⢔⣒⡪⠭⢊⠒⠥⡪⠌⡢⡂⡂⢊⠐⠑⠹⠝⡿⣿⣻⢿⡻⠽⡻⢝⠳⠫⡛⡚⠍⢊⠙⠺⠻⡺⡪⡳⢵⣽⣺⢕⣒
⣿⣿⢝⠐⠠⠠⠀⠂⠐⠀⠁⠌⠀⢂⠁⡐⢀⠂⡈⢂⠊⠅⠑⠀⠠⠀⠍⡀⠀⠂⣀⢔⢌⠠⠀⡀⢕⢕⢒⡪⡁⠂⠀⡁⠢⡑⠔⢀⠊⢄⢂⠐⠀⠠⠀⠂⠁⢁⢈⠈⡀⡀⠔⡁⡊⠌⡊⡢⡐⡠⡐⡀⡀⠈⠐⡐⠑⡱⣲
⣿⣿⡕⢁⠂⡁⠌⠀⡈⠀⡁⠀⠂⠐⠠⠀⠂⠠⠀⠠⠀⠂⡈⠀⡁⠠⡐⣠⣲⣝⣒⠕⠥⡁⠠⠨⡐⢅⠕⡐⠈⠄⠅⠔⡑⠌⡁⡂⢀⠂⠄⠢⠁⡐⠀⠈⡈⠄⢂⢂⠢⢌⠢⠐⠀⢂⠀⠄⠢⠢⢊⠈⠠⠈⢘⠓⡡⣺⢯
⡿⣷⡫⠠⠨⠀⠂⠠⠀⠐⠀⢀⠁⠌⠀⡐⠀⠁⠀⠠⠀⡐⡀⢔⢔⣕⣞⣗⣗⣕⡢⠭⠭⡒⠀⡁⡂⢅⠂⠄⡁⢂⠑⠌⠄⡂⠂⠐⠠⠐⠈⠐⠐⠀⢤⣕⣆⠨⢀⠂⠊⠠⢈⠄⢅⢂⠐⡐⢄⠑⢀⠐⡀⠂⡀⣐⣾⣻⣫
⣟⡳⡫⢂⠡⠁⡈⠀⠀⠂⠀⠂⠀⡀⠄⠄⢈⢀⠁⢄⣒⡲⡺⣝⣵⢵⣳⡳⣕⣕⡪⡫⢍⡊⠄⠐⡐⠀⠄⠂⠌⠠⠁⠅⠡⠀⡁⢈⠀⠄⠁⠌⠀⢒⢷⣻⣷⡡⠀⠄⢈⠠⢂⢂⠅⠅⠅⡊⢔⠡⠀⡂⢄⠡⢐⣪⠿⣝⠮
⡪⡪⢭⢂⠐⣐⢤⣢⣢⣂⢄⠄⡂⡂⠕⢈⠔⢔⢑⢕⢵⢝⡽⣞⢮⢯⢮⣚⣒⢖⠭⡊⣒⠬⡐⠀⡀⢈⠀⡐⠀⠄⠠⠠⠀⠄⡀⠠⠀⠄⠈⢀⠨⢭⡻⣞⣯⢗⠌⠀⡀⢀⠂⠀⠀⡁⠅⡪⣂⢅⢕⠨⢂⠀⡢⡲⠭⣪⣓
⠮⡪⣳⠥⡨⠮⡩⠪⣚⢞⣯⣓⠌⡐⢈⠔⢌⡢⢕⠭⢵⣓⢯⡺⣝⢯⡳⠵⡲⡭⣝⡪⡒⣊⠢⠀⠄⠂⢀⠠⠈⠄⠅⠅⠅⠡⠐⢐⠀⠂⠁⢄⢭⣓⡪⡳⣝⣿⣕⠀⠄⢂⠄⠄⠄⠄⠠⡐⢔⡑⡢⡩⠠⠨⡺⣪⢝⣞⡮
⡫⢮⢷⡯⣒⠡⣐⢭⢮⠕⣒⣗⣗⡢⠡⠪⠢⡪⣑⠭⣕⢮⡳⢝⢮⣓⠭⡫⢭⣚⣒⠭⡪⣒⢍⠢⠈⠌⠄⡀⢂⢐⠠⢈⠠⠡⠨⡐⢈⠐⣨⣪⢷⢕⠮⣚⣪⢾⡾⣵⠀⠠⠈⠐⠨⢈⢂⠪⡢⠪⡨⠐⢐⡽⣝⡲⣝⣾⡻
⡭⡳⣻⣽⠢⡡⢒⡯⣗⢭⣲⠳⣻⡺⡨⡨⡑⡪⣒⠭⠮⣕⡫⢕⣓⢒⢍⡪⢕⣒⣒⠭⠭⣒⢕⢕⠥⢂⠡⠨⢐⢄⢅⢂⢊⠊⡈⡠⣔⡾⣞⣞⡳⠭⠭⣒⡲⡳⡿⣿⡧⡁⠄⠅⠢⠡⡐⠥⡪⢑⠐⡨⡮⡯⡪⠮⣺⣺⢽
⠮⣪⣻⣞⢅⠢⢕⢯⡺⠝⡂⠅⢗⣝⢧⣒⢜⡪⣒⠭⢝⣒⡪⢕⠔⢅⢒⠪⢕⢒⣒⠭⢝⡪⣵⢵⣭⣳⣖⣧⣦⣦⣢⣵⣕⣾⡾⣽⠿⢝⢮⣲⣪⡭⠭⣒⣪⣫⢿⢿⡿⣮⢄⠊⠐⢁⠂⡑⡨⣢⡲⡽⣝⠮⢭⢝⣪⢞⣗
⣓⣒⢷⣳⠥⢊⢮⠣⢕⡑⡐⢕⣑⣪⣫⡳⡭⡪⣒⠭⣑⠢⡪⡢⢑⡡⡑⢍⢎⣕⣒⢭⢕⡽⣺⡽⡾⣟⣾⣿⣿⣿⣻⣿⢯⣿⣟⢏⡫⠭⢳⠵⡳⢝⠭⡒⡒⡪⡫⡻⢽⣫⢿⢿⣽⣶⣵⣮⣾⣯⢯⡫⡮⣝⢕⢕⣪⣓⢮
⢖⢮⡳⣗⢏⠢⡳⡩⢐⢐⠨⢕⢔⣪⡳⣝⣪⡪⣒⣑⠢⡩⢒⢌⠢⢐⠨⢕⢕⡲⣒⣓⣝⢞⢗⡯⣟⣯⢿⢾⢷⡿⣟⡿⣟⢗⢮⡒⠨⢊⠢⡉⠊⢈⠊⠈⠌⠔⠌⡊⠭⢕⡓⢝⢯⣿⢿⣟⣿⣽⡳⢭⢞⡲⠭⢕⣪⡺⡲
⠕⠭⡪⡪⢕⠅⢝⣒⠢⠰⠭⢕⠔⠬⡞⡖⣒⡒⡢⠢⡑⢌⢅⠢⡡⠡⡑⢕⣑⠪⣒⢒⡪⠭⣓⢝⢮⢞⢯⢟⣟⣟⡯⢯⢓⣝⣝⠮⠌⢄⢐⠠⠡⢂⠄⠅⡂⡊⡨⡀⡂⣦⠢⠡⡹⢽⣻⡽⡷⣯⢯⣓⢵⡱⠭⢕⡲⢭⣚
⢌⡢⡢⢔⡐⡕⢅⠪⢝⡪⣚⣕⠥⠡⣙⡪⡒⠬⠌⢕⠨⢅⢒⢑⠔⡑⢌⡒⢔⡩⠢⢕⠌⢍⠢⡣⣓⢝⢭⡻⡺⡮⡫⢕⢝⢮⡪⡫⠭⡢⡑⠌⠌⠐⠈⠄⠄⡐⢐⡪⡺⡺⡕⡐⠨⡱⡵⡻⣝⣗⡯⣒⠭⠮⡫⣓⢝⣕⠵
⣗⣯⢞⣵⢽⡮⡑⠬⡐⢌⢒⢕⡫⠕⠔⠌⠪⢌⠅⠥⣑⡑⢅⢅⠪⡨⡑⠬⢕⡪⢍⠢⡑⢅⢑⢐⢐⢑⠕⡪⣝⠪⠪⡪⠭⢕⠭⡪⣫⣪⢮⣪⣪⣪⣒⣪⣲⣪⣷⡽⡮⡫⠮⡀⠂⠪⣚⣝⠮⣞⡊⡢⡩⡩⠪⠒⠕⢌⢍
⣿⣿⣻⣽⣻⣻⣆⠅⢓⢕⢕⢒⡪⣍⡪⢌⢊⠢⡑⡑⠔⠌⡢⠡⡑⢌⢌⢍⢕⠪⠥⣑⢊⠔⡐⠔⡡⡡⠭⡪⡢⠭⠭⡪⠭⣒⢭⡺⡽⠽⣝⡯⣗⣗⠿⡽⣳⢟⡯⡿⣽⣫⢏⠄⠈⢌⢒⡪⢝⠮⠨⣐⣒⠔⢕⢕⡑⢄⠢
⣿⣟⡷⣗⡯⣗⣟⣮⠀⡑⠱⣑⡪⣒⡪⢕⢂⢑⢌⠢⡑⡑⢌⠪⠨⡐⠔⡢⡑⠭⣑⡢⡑⢌⡂⢕⠰⠬⣝⣊⠢⢍⢑⢌⠭⠒⠕⠌⢍⠍⡒⢌⣒⢬⡩⡪⣔⣕⣊⠪⠱⢝⢝⡢⠁⢄⠕⡜⡭⡯⣵⢮⣮⡮⣵⢯⡮⡢⡭
⡛⠮⡫⡳⢝⠮⡺⡪⡳⡠⠀⠐⢌⡢⠨⡁⠢⢕⢕⢅⠢⡊⠔⡨⠊⠔⡑⠔⠬⣑⢒⠬⣊⣒⠬⣑⢍⣫⣗⡢⣑⢔⢌⢂⠡⡑⠬⠬⢮⠾⠾⠿⡾⣿⢿⣿⣿⣿⣾⣵⢅⠡⡩⡂⠂⢅⢕⡪⣺⣽⣿⢿⣷⡿⣯⣿⡯⣗⢮
⣈⢊⢐⠨⠨⠨⠢⢑⢊⠪⡑⢌⢔⢮⠢⡈⣊⠭⢭⢕⠥⠢⡑⡐⡑⡑⠌⡊⡊⡢⡑⢕⡢⡢⠭⠢⢕⣵⡳⣭⡲⢅⠂⠠⠑⠈⠊⠈⠁⠈⠀⠁⡀⢀⠁⠂⠑⠑⠊⡚⠅⢂⡒⢌⢌⣒⢕⡪⣞⣟⡿⣟⣿⣽⢿⣿⢽⡳⠭
⠢⠥⢕⡪⣮⣪⣮⣲⣔⣖⣬⣲⣕⢗⡕⠔⣐⢍⣓⢕⢕⢕⠨⡐⢌⠔⡑⢌⠢⡑⢌⠢⡒⢌⡪⡑⢕⢾⣽⣺⢾⡳⡀⠀⢀⠀⠂⡈⠀⠌⠀⠂⡀⠂⡐⠈⡀⠄⡁⠄⢄⢕⡪⡐⣒⠮⡲⡪⡪⠑⠍⢍⠪⠪⠫⠪⡋⢎⠭
⢘⢭⣓⢿⣿⣿⣿⣿⢿⡿⡿⣿⣳⡳⣪⣑⠔⠬⢒⢕⡭⣕⢕⠨⡂⣊⢌⠢⡑⢌⠔⡨⡨⢂⢒⠨⢘⢽⢾⡺⣯⣟⣷⡠⠀⠀⠂⢀⠈⡀⠀⠂⠄⠂⠄⠂⠄⠅⡂⣕⣗⡯⠮⠬⣪⢫⠪⡪⠠⢈⠠⠠⢈⠐⡈⠠⠀⠅⢐
⣔⣶⣺⣻⡻⡺⣝⢮⢯⣫⢯⣷⣳⣏⢖⣒⢌⠪⡑⢕⠮⢮⣒⢕⢌⠢⣂⠭⡨⠢⠢⢂⠢⡑⠔⡈⠔⣝⢯⣯⡳⣗⣟⣿⣵⡀⠌⡀⡂⠢⡁⠅⡂⠅⡁⡁⠅⠅⡪⣞⡾⣞⠭⠭⡪⠕⡭⣾⣭⢵⣪⣪⢦⢕⢌⣒⣑⠬⡢
⣟⢽⣚⡮⡽⣽⣺⣯⣿⣽⡿⣯⣿⢮⢕⡢⠢⠡⠨⠕⣝⢕⠵⢕⠥⡑⢔⣑⠪⠪⢊⠢⠡⢂⠕⣈⢂⢪⡻⡮⣯⣫⢷⣳⣻⢿⣖⠤⡈⡂⠢⡑⢌⠐⠠⠀⠅⠊⣼⣽⢽⡪⠭⡭⡪⢭⣿⣿⣿⣻⣾⣽⣟⣷⢕⢖⣵⣻⡪
⣮⣷⣷⣿⣻⢿⡽⣽⣞⣾⢽⣗⡿⣝⢖⠬⢊⢊⠌⢕⢔⠭⡫⣓⢕⠢⠥⡢⡩⠕⢅⠥⡁⢅⠢⡂⢂⢒⢽⡺⡺⣺⣝⣞⡽⡽⡽⣻⢷⣮⣮⣬⣢⢥⢥⣐⢤⢭⣞⣞⣗⡫⣝⠬⣪⣿⣿⣿⣿⢿⡾⣿⣿⣳⠯⡪⢾⣺⣝
⣿⣳⣟⣾⣻⣽⣽⣳⣳⣯⣟⡾⣯⢗⠧⢕⠡⡁⡊⡂⣒⠭⠭⣪⢕⣑⠕⠬⣒⡩⡢⣑⠌⠥⠕⢌⠢⡑⢕⢯⢽⢵⣳⡳⣝⢞⣝⢮⣛⠾⣯⡿⣟⡿⣟⡾⣻⢽⡺⣞⣗⢝⣒⡽⡿⡿⣟⣯⣯⠿⣽⡿⣿⣻⠭⣊⢝⡾⡮
⣿⣽⢾⣳⣟⣞⡾⣞⣷⣳⢯⣟⣗⢯⢍⡒⡑⠌⢄⠢⠢⢍⠭⣒⢕⣒⢕⠩⡒⣒⠪⣒⠭⢕⠭⢕⡡⡨⠪⢕⢗⣫⢷⣻⣺⡱⣕⣓⠮⢝⣒⠭⠭⢝⢝⣚⠵⣝⡺⣞⢮⣓⠮⣛⠝⠝⠪⢒⠨⣉⣐⠽⡻⣪⡫⡖⣕⢯⢯
⡿⣾⣻⢯⡷⣯⢯⣟⡾⣽⣻⣞⡮⢕⢕⠬⡨⠨⠐⠌⡊⡒⠭⡢⡑⠔⠥⠭⠬⠢⢕⠔⠭⢕⢍⠦⣊⠢⢍⠭⡳⣕⢯⢿⢮⢮⣒⡪⢩⢕⢕⢕⠭⡑⡒⣒⢝⢖⡽⡯⣗⣧⣆⡢⢑⠬⣪⢌⢝⢖⢖⡯⣪⢮⢾⡽⣮⣻⣳
⣿⣳⡿⣯⣟⡾⣟⣯⢿⣻⢾⠵⠪⡪⡕⢅⢂⠑⡡⢑⠨⢌⢍⣒⢌⢊⠪⠨⠭⢍⣒⢌⢕⠕⣒⢍⡢⢍⠢⡩⡪⠮⣝⣻⣻⣯⣖⢎⣒⠢⡐⢄⠑⠌⠌⡢⣑⠵⣽⣻⣺⣽⣿⣿⣵⣌⠒⢍⠭⡙⡂⢝⣊⠹⡽⣟⣾⣻⣯
⣿⣽⣻⢷⣯⢿⣽⣽⣻⣽⡻⢍⠪⡪⢎⢅⠢⡑⡐⡡⡑⡡⢂⣒⠢⠥⡁⢅⠍⡢⡂⢕⠢⣑⠢⡑⡊⢆⠕⢌⡪⠭⣒⠮⣗⣿⣻⣯⣾⣾⣪⣖⣭⢮⢮⢖⣮⢯⡷⡳⣽⣿⣿⣿⣿⣿⣯⡦⣕⢌⠬⢅⣒⠥⡊⢖⣪⣓⠫
⣿⢾⣯⣿⢾⣻⣞⣾⣳⡯⠯⡐⡪⠭⢕⢔⢑⠔⢌⠢⡨⡐⡢⠢⡩⡪⡨⢐⢌⢐⠨⡢⣑⢔⢑⠨⡨⡑⢌⠢⡂⡓⠕⢍⠺⡺⣽⣳⢿⢾⣟⣿⣻⢿⣻⣻⡺⣝⢞⡽⣿⣿⣿⣿⣿⣿⣿⣿⣿⣖⣎⠥⡪⠕⢬⡓⠬⡪⠕
⣿⢿⣞⣾⣻⣳⣟⣷⡯⡯⡑⡨⡪⢭⢕⢔⢑⢌⠢⡑⠔⢌⠔⡑⡪⠪⠬⣑⢔⢐⢑⡐⠔⡢⡑⢌⠢⢊⠢⡑⢌⠌⠌⡂⢍⢊⠪⢯⢿⣻⡾⡯⣯⣟⣗⢗⣏⠮⢕⣿⣿⣿⣿⣿⣿⣿⣿⣿⣻⣿⣿⣯⣎⢎⣓⣢⢝⠊⢕
⣿⢿⡾⣯⢯⡿⣾⣳⢯⠕⠐⠬⡪⣓⡒⡢⡑⢔⢑⠌⢍⠢⡑⠬⡨⢍⢕⠢⡢⣑⠔⠔⡡⠢⢑⠔⡨⠐⠌⢌⠄⡂⠅⠌⠄⠅⠍⠅⡣⣑⠭⢝⡪⢞⠪⡓⡒⠥⣫⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣻⣿⣿⣿⣷⣖⡕⡱⢕⠑
⣿⣟⡿⣽⣟⡿⣷⢯⢗⠡⠡⡩⡪⣪⡪⣊⡢⡑⡢⡩⠢⠕⠬⣑⢒⣑⠢⠭⡒⡢⡑⠥⡢⠩⠢⡈⢔⠡⡑⢐⠨⢐⠨⠨⠐⠨⠈⠌⡐⠐⠌⠅⡊⠅⢍⠌⢔⣽⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣟⣿⣯⣿⣿⣿⣿⣮⣖⣾
⣿⣯⡿⣯⡿⣽⣯⣟⠕⡈⢌⢌⠮⣒⡪⡢⢒⠬⠢⣊⠪⣑⠕⡢⢕⣒⢍⠭⣊⡪⢌⠕⣌⡪⡑⢌⢐⢑⠨⡐⠌⠢⠊⠌⠌⢄⠑⠌⠄⠅⡂⢂⢄⡢⣢⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡾⣯⣿⢿⣿⣿⣿⣿
⣿⡾⣟⣯⡿⣯⢷⣳⠡⠐⢔⠨⡪⢕⡪⡪⣑⠪⢍⡢⠭⢔⢍⡪⢒⡒⣒⢍⢒⠬⡒⢕⢔⣊⠪⡢⡑⢄⠅⠌⡈⢌⠨⡈⢌⠢⠭⡪⣒⢕⡮⣗⢷⢽⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣯⣿⣿⣿⣿⣿⢾⣟⣿⣾⣿⣿
⣿⣟⣿⣽⣻⣯⢿⡲⢅⢑⢔⠩⡪⢕⢕⡪⣒⡑⢕⢌⠪⡒⢅⠪⠥⡊⣒⣑⢕⢕⢌⢕⢒⡢⠭⠬⠬⠢⢅⠕⢌⡢⢕⡨⣑⠭⡩⡪⣪⣳⢽⡺⣽⢽⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⢿⣾⣿⣿⣿⣿⣿⣿⣿⡾⣽⣟⣿
⣿⣯⡿⣾⣻⢾⣳⣫⡣⢐⡢⢍⡪⣑⢕⢕⣒⠬⣑⠢⡑⡊⡒⣑⢑⠪⡢⣒⢕⢕⢕⢕⠥⢒⢍⡪⠭⡩⡢⠭⡢⠪⡒⠬⢔⡑⡪⡺⣪⢮⣳⡻⡺⣽⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣟⣿⣿⣿⣿⣿⣿⢿⣿⣿⣿⣿⣽⣟

Features

• Image to ASCII Art: Transform images into intricate ASCII representations.
• Supports Various Sizes: Create both small and large ASCII art images.
• Customizable Settings: Adjust threshold value, algorithms, darkmode and more to fine-tune your art.
• Human Faces Mode: Includes a mode specifically for generating ASCII art from human faces in images.
• Save and Share: Save your creations by coping or as text files then share them as you like.

Installation

To get started with the ASCII Art Generator, choose the option you like :

Online

Just go to https://ascii-art-generator.streamlit.app/

On your machine using streamlit

1. Clone the repository:

   git clone --depth 1 https://github.com/your-username/ascii-art-creator.git

2. Navigate to the project directory:

   cd ASCII-Art-Generator

3. Install the necessary dependencies:

   pip install -r requirements.txt

4. Run time ! This will start the Streamlit app on port 8501. You can access it by navigating to http://localhost:8501 in your web browser. :

   streamlit run app.py 

   You can also set a different port number (Note that Streamlit will increment the port number if it is used):

   streamlit run app.py --server.port 8080

On your machine using docker

Prerequisites

Before you begin, ensure you have Docker installed on your machine. If not, download and install Docker from here.

1. Clone the repository to your local machine:

   git clone --depth 1 https://github.com/your-username/ascii-art-creator.git

2. Navigate to the project directory:

   cd ASCII-Art-Generator

3. Build the Docker image:

   docker build -t ASCII-generator .

   This command will create a Docker image named ASCII-generator.

4. Run the container

   docker run -p 8501:8501 ASCII-generator

   This will start the Streamlit app on port 8501. You can access it by navigating to http://localhost:8501 in your web browser.

License

This project is licensed under the MIT License. You can find the full text of the license in the LICENSE file.

To do

1. work on code cleaning
2. Check is an other port can be choose using docker
3. darkmode doesn't restart the ascii creation
4. add a gallery ? (st.navigation ?)