Convert_Image_To_Ascii

Convert image to ASCII art

 

Stats

  • Forks
    0
  • Stars
    0
  • Open Issues
    0
  • Description
    Convert image to ASCII art
 

convert_image_to_ascii.py

A image to ascii converter
Convert an image using a standard character set or a custom character set

High Contrast\
Original Image

$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$@@8$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$@$$$$$$$$@@@$$@B@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$B%&&&$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$B@@$@$@$$$$$$$$$88%$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$@&B$@@$$$$$$$$B*W@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$@$B8$&@$$@$$$$@%#&$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$@%$88@$@$$$$$@%WbMoaddbho*M8%B@@@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$@$$$@$@$$BBMo@$pnuYQwkaaho####W8B@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$@$$8B@$B#kB$$oYczULOwkoM&88&MM**WB$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$@@Bo%$B@$adB$$$$#QYuvczQdk#W&M&88#ah#%@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$@$BW@8$Mp8$$$$$$&kadma*okaa*M%@@@%aboB$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$@$%$8*&%dZ$$$$$$$$$@$@%%%$$%&&$$$$@8hOw&$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$&BBaW@Uh$$$$$$B**bbkhMpX0k%BB8#hdqLXO#@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$B8$&*zCB$$$$$$#Oppqwb&MoapUuux|{1(|fYb%$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$&m#$Mz%$$$$$$aX\/xzUYn)-!"^^;IIl!>+](X&$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$@%&%UQhZZB$$$$$w}+<i;"^'.  ..`^",:::;Ii~)#$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$&q$MwO1q@$$$$8{^",""`''''```^`^"","",:;_YZqhoW@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$@zZB%Cc@$$$$$M<`````''''````^^^""""""^"",,I+{fO#apw*@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$@$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$&8qjqp/h$$$$$$$\.`''```````````^^^```""^:{fi;<-0B%&nxk$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$BBB$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$wowZYC$$$$$$$$ol''''''''''''''```''',,"~ntI"";(Z%$@%@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$8oo$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$80wBLt8$$$$$$$$$c'`''''''''''''''''.''^^",;l;;!I+0@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$BUm$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$apOqzb$$$$$$$$$$&+''''''''''''''''''''''''`,>]{}-)Q8$$$$$$$$$$$$$$$$$$$$$$$$$$$$$@@@$$$b[O$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$@dBJxW$$$$$$$$$$$w,'`'''''.....''''''''''''';vpmQmwk%@@$$$$$$$$$$$$$$$$$$$$$$$$$@@B%@$$CIC$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$qZcm%$$$$$$$$$$$$x```'''.'............'''''^~(jt({[)/nvzma&B@$$$$$$$$$$$$$$$$$$@B8&%$$h+c$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$pf~w%B$$$$$$$$$$$8[```'......'.........'''```..'`;<++](\rYwo&B$$$$$$$$$$$$$$$$$@%&M8$$r"|$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$@w)qW&$$$$$$$$$$$$k!``'............... .'`^,!-}jt\cb*aMB@@$$$$$$$$$$$$$$$$$$$$@B8##B$Bc'Ia$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$@c\M8M$$$$$$$$$$$$$O,`'...   ........^II"![)uYzLv[)juUwh#M*oM%$$$$$$$$$$$$$$$$@8#bM$$Z)[~*$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$Ct@8%$$$$$$$$$$$$$$J^''.    ....  "<)r\<I:",I;i>,"":!<<?1|fxzOa&B$$$$$$$$$$$$@&dd&&#f1,~a$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$hf#@%@$$$$$$$$$@@@$$C"'.    ..   ..''..''..   ....   .'`:!~}(\n0h&@@@$$$$$$$$%oUChj\jU,i&$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$C;bBB$$$$$$$$$$$$$@@$OI ..   .    ..          ......'``^,!?/vLpaM%$$$$$$$$$@Mwj!>~+[-{IL@$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$0|8@@@$$$$$$$$$$$@@@$$o}                       ...''`^,i?1jUOd#B$$@@$$$$$@WmcX\~}~jz".[M$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$h)b$&@$$$$$$$$@$$@@$$@$BCi             .       ...''.'`"i}fzCwa*M8%@$$$@&mnrJac!_+xQ-:O$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$w<L%%$$$$$$$$$$$@$@$@@BB$8C?`                          .`:~[\rXQOZkW%MdJff\/1!^{[~~){Q$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$%x!wB$$$$$$$$$$$$@$$@@$@@@$$@bu+`                   ...   .^;!>-{|juuj(?<_p(:I?cUci>,|&$$B%$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$o[lk@$$$$$$$$$$$$$$$$$@@@@@$$$$@aJ],`.                ..  .'";!+]?_>!ll;I_((v"+jcQL?rk$$$WM$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$#\"L$$@$$$$$$$$$$$$$$$$$$$$$$$$@$$#)+i;^'.            .''`^,I!iI,```^^'. `\OBUlI["+v@$buW@W$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$k\;X@$@$$$$$$$$$$$$$$$$$$$$@$$$$$$$C+<!;"`..         .'''``''''.....'!";)YYfuo#-I]8bcMb0M*d@$$$$$$$$$$$$$$$
$$$$$$$$$$$$Bn[`c@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$8\>;"^`.           ..........   "[rjd$@-x)!-0Mm}~+tvdma@$$$$$$$$$$$$$$$$
$$$$$$$$$$$$M>:'Y$B@$$$$$$$$$$$$$$$$$$$$$$$$$$$$$O+:^`'.          ........   `~}}[Qq1(z}]toaQ)uz-rB*h$$&$$$$$$$$$$$$$$$$
$$$$$$$$$$$$pc:^O$@@$$$@$$$$$$$$$$$$$$$$$$$$$$$$$q)I"''..              .  ."i1-}i''IXJUMB$h0YruX(xUxpB#W$$$$$$$$$$$$$$$$
$$$$$$$$$$$$ou''L$@$@B@@$$$$$$$$$$$$$$$$$$$$$$$$$Z/<,`'..                "I,^:|(-1|z%$@dUULr1{(vxxbah@8$$$$$$$$$$$$$$$@$
$$$$$$$$$$$$O!^.v$@$%%$$$%B$$$$$$$$$$$$$$$$$$$$$%Zt-l^'.             .'`!+<I~!U#B@$$$B@MLUzu[)ax)Z&bO8$$$$$$$$$$$$$@$%8@
mzuqUfXJLt\f(f` ~%%pW@B@$@@$$$$$$$$$$$$$$$$$$$$$&wr-~;`.        .:^"` ',q#q0CUca@$Ma8&ZYr)ru?~<]YYO&%$$@&@$@#$$$$@8@$8B$
!lcYuvjqC_]dx]`:\@B&B$88$$$$$$$$$$$$$$$$$$$$$$$$@8bc)+"         .lrJ)(<><[U#$$$$kbwcJYLf-{1]1}aWZq$Bo@88B$$W&$$$&8$$$$B$
:j(i]f[+1]tfU/">f8%@$%B$$$@$$$$$$$$$$$$$$$$$$$$$$$$@*u:     ')/i   ~rCw*aLm8BM8$Baq#0qXCnC80}c*ZLUo$%&a&@8BW@$$$dWoOwqcr
}[f1(1fU#\1?r,'.lWMB$@@$$$%$$$$$$$$$$$$$$$$$$$$$$$$$$&?  . .'>cvJdz{i[<n&$$$&vC@mxtUxc(1,~xj/Uv/vOqM&buh#b#W&M@$$$#&#wOq
l?/_~}{[{}C0Z}"'t8W$WoB$$W@$$$@8@$$$$$$$$$$$$$$$$$$$@mi'`QYii: `ixm#B*qq8$B8W#$8o&Lf{u0XnCrjtmd#ZkCX%&xCMoCChbqW@aM$$B8@
~jYv0Mo{/C1>?~>lh$@$%W@$$B$$$$@8%$$$$$$$$$$$$$$$$$$%Q+"`.~r\XXt?<~"lxoM@$@q\/OC}\pOZohjvMMU/xZ&q|[Ya8dw8$quaJZkpqftbWMpp
`` `,<{/z&zu&u+!M8#$$$$$$$$$%$$dmowZbB$$$$$$$$$$$$$@C;\c;'{,i1}uL#aqqq*@$B@@@opbaz)YM8XuW#LUutx\{J#wu[xB$$$$$B$$WQa&Oumh
[)[?]^~];1Cuun'18$@B@@$$$$$$%$$CpmZcY0w&$%$$$$$$$$$8{'I}[](t}}I`}\CX&$$$8pnYwrC&#bYhkx<1vnQf[J&B$YfcL/n&OJBoZW$$$$$W@$$$
i</1(/{q([{^ :.($$@8@$$@@&@$$$@#qm*#{~!0Mzw%$@M%$B#v!1\!`^`i1j\LCCXtna$$$$%bmUY/(<jcXu[(CfbXJhk$@%BW8@WXZpLJCOmd%8oZwo@#
]",?>\+>)xQt\0_w$$$&@$$$$%MW$$&q#dntt)rC/:?CaOYQw8*n{_[1_n/)~\,<|C){>x&YuX0Lw8MJ+Uk*Lm])+,z&aj(OoCkB#%$%$$8*$$ba$$hCW%@p
j"Yq~/LfCQnLx};c$$$$$$$$$$oM$$$8*k(;}}ijn(cxxdor]Z*&oc?|?l_->0zt!0wm%c(QW&C?Ym$C-%dO*&&&OrXkJfpdrb8Mff&bdk@$$&$$%&@$$$$$
  _{l|k@@LdY+:.+@$$$$$$$$$$$$$$&Mw?\+/u|*%t<Zvb@v`}Q0hkZz})|`fUc))Uz*MOL}LxcdM*b8QrZmcUa$W#BB8$$k&$qCW%ZdkaZw%$$ap8$@ho@
^C("(?__\maB\zZ_L8$$$$$$$$$$$$MYrvCt|U1|)dpv{(cZ$q+>YZ(xWW0ox)c++(vXfcv\xwZL)jZoQUmpz|r*Mx(wpzr*Bw&$8%$$$$$%W@$@M*$$$B%o
q$uC0<8/<<-(fUni`{o@$$$$$$$$$$afCkunuaL_YjmW0ir\(*Mz?dcfpohdOLdZJ0OmhqQXhMB$#oBM&$$$WkM@QdB8ZvpdLLMBhXO%BdmM$%bwq8$&8$$@
uZwkkZ&hCU+\Y"-v<?!na8$$$$$$$$$8$B]nx#$YlYwo%O'<}iLLb@8ZYZ{_zoht)UwqL\Xa*LQ8ouua$k8$$B@@B$$$BB$&mB$#Q#o%M0M$$$%B$$$$$&W$
jL[,x((zqOmqqzmbcUZU|nOQ8oW$B8MYW$w}O[*B}\(!CXuU&@@o%$qL$$hm%$%Ow$$@hbB$oL%$WL&BZZbWaw*@WM&$$$8%$@@$$$$$&8$@MMM@$8B8MWB$
vJwJ8mjb/(Q{}f(/cftmBziI()Qm1mY<jQ/{Q_Yqf(dCzJQQJu0$$$$&YJM%@&$Mo80p$@b&$@$$$@$$MW$&ZW$%p#B$oQaWB$$$$$@&#B$@oh#B@&8*k#B@
^{>i+jLbo8#nChOU&?;Lv~YbuO%#zJxwbk0\nzQdmfUf}fX\1xqCC&$o((CX{f%$bxUaaJJ8&qo%%bb%$%@$$$$$$$$$B#$$$$$$$$%#$$$$&B$$$B@$$$$$
L$U,zL~<jj{\tju\}(ffcQj_i|C)cZQ)jp#Qj**O{zB8cx$&vq$ocB$pz%$BX0@$&b&$@LM$dYB@pkWB#h%B88$$$$$$$$%M%$$$@8@$$@@B$$$B@@BB@@@%
1jUXw8o&$ZxUxX8tfhq)Q%*c#$McMMpZoW%q*&kvuYqqbaWbaZd8@pb%@%8W$$$@@$$$$$$$$$$$$$$$ha$@ao$$$Wm@$$a#@$$%#8%$$@&B$$$B@@B@$$@@
f:_/>+QcrJk0JLf(u)?[CX{{caLLJ-<I)){q&m0Ohz!|QmxQhj[va([ukhrY&%qq@Mk%%WM$B8@$$$$$$$@$$$$$$$$$$$@$$$$@W$$$$@&$$@@$@@%@B%BB
0wdbno8YUBu,J0,zMu|oo~ICqx\b&qC#%oYhB%zY$$aaBaq8$kw@$QzdaXL$$MC@$o#$Ba8$ho$$Mm%$%q&@$$@$$$$$@B$$$$$@$$$$@B$$@8B$@BB$@@$$
OqYuqpvQ*0d**UQ0rjC*oqOvYdWdjfwkQXhBC1c*Qj0hhMWCXOBap&bCCo$$$$#qM$&*$$$$$$$$@8$$$&@$$$%$$$$#8$$$$B@@$$$$B$$$@%$$$$$@@$$$
ocL&&ddaL|w%qXwd)cZ[+0ao00#*woM8k&$$BM%@8W&%B&Wo&&BW*%8aa&@%$$*b&$MM$$@$$$$$$$$$$$$$$$$$$$$$$$$$$@$$$$$$$$$$$$$$$$@B@$$$

Using a custom characters (-c/--chars '▀▁▂▃▄▅▆▇█▉▊▋▌▍▎▏▐▒▓▔▕▖▗▘▙▚▛▜▝▞▟ ')

████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████▇███████████████████████████████████████████████████████████████████████████████
████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████
███████████████████████████████████▉▇▇▇█████████████████████████████████████████████████████████████████████████████████
████████████████████████████████████▇▉▉█████████████████████████████████████████████████████████████████████████████████
█████████████████████▇▉███████████▉▛▇███████████████████████████████████████████████████████████████████████████████████
███████████████████▇█▇█████████▉▊▇██████████████████████████████████████████████████████████████████████████████████████
████████████████▉█▉▉█████████▉▊▜▊▛▓▙▙▜▓▛▛▊▇▉████████████████████████████████████████████████████████████████████████████
██████████████████████████▉▊▛██▙▞▞▀▋▟▜▓▓▓▛▛▛▛▊▇▉▉███████████████████████████████████████████████████████████████████████
████████████████████▇▉██▉▊▜▉██▛▀▚▌▀▅▆▟▜▛▊▇▇▇▇▊▊▛▛▇▉█████████████████████████████████████████████████████████████████████
████████████████▉▛▉█▉██▓▙▉████▛▋▀▚▚▚▌▋▙▓▊▇▇▊▇▉▇▊▛▓▊▉████████████████████████████████████████████████████████████████████
██████████████████▇█▇█▊▙▇██████▇▓▓▜▟▓▛▛▜▓▓▛▊▉███▉▓▜▛▉███████████████████████████████████████████████████████████████████
███████████████▉█▇▛▇▉▙▆████████████▉▉▉██▉▇▇█████▇▓▆▟▇███████████████████████████████████████████████████████████████████
███████████████▇▉▉▛▇█▀▓███████▛▛▜▜▜▓▊▙▌▆▜▉▉▉▉▊▓▙▙▅▌▆▊███████████████████████████████████████████████████████████████████
███████████████▉▇█▇▛▌▅▉██████▛▆▙▙▙▟▜▇▊▛▓▙▀▚▞▒▍▃▘▍▍▄▀▜▉██████████████████████████████████████████████████████████████████
███████████████▇▟▊█▊▌▉██████▛▌▐▐▞▌▀▀▞▘▎▂▔▁▁▏▏▏▂▂▗▎▝▍▌▇██████████████████████████████████████████████████████████████████
█████████████▉▇▉▀▋▓▆▆▉█████▟▃▎▖▗▏▔▁▕▕  ▕▕▕▁▔▔▔▔▔▏▏▗▖▍▊██████████████████████████████████████████████████████████████████
█████████████▇▙█▊▟▆▘▟█████▉▃▁▔▔▁▁▁▕▕▕▕▕▕▁▁▁▁▁▔▔▔▔▔▏▏▎▌▆▙▓▛▊█████████████████████████████████████████████████████████████
██████████████▌▆▉▉▅▚██████▊▗▕▁▁▕▕▕▕▕▕▕▕▁▁▁▁▁▁▁▁▁▁▁▁▁▔▔▔▏▖▘▄▆▊▓▙▟▛███████████████████████████████████████████████████████
████████████▇▇▙▒▙▙▄▓███████▐▕▕▕▕▕▁▕▕▕▕▁▕▕▕▁▁▁▁▁▁▁▁▁▁▔▃▄▂▏▗▝▋▉▉▇▞▒▜██████████████████████████████████▉▉██████████████████
█████████████▟▛▟▆▀▅████████▛▂▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▁▕▕▕▕▔▔▁▖▞▄▏▁▔▏▍▆▉██▉██████████████████████████████████▉▛▛██████████████████
████████████▉▆▟▉▋▄▉█████████▚▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▁▁▔▔▏▂▏▏▂▂▎▋█████████████████████████████████████▉▀▟██████████████████
████████████▛▙▆▙▌▜██████████▇▎▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▁▔▗▝▘▃▎▘▋▉███████████████████████████████████▜▃▆██████████████████
█████████████▜█▅▞▇███████████▟▔▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▏▚▙▟▋▟▟▓▉█████████████████████████████▉▉███▅▂▅██████████████████
█████████████▙▟▚▟▉████████████▒▁▁▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▁▖▍▒▄▍▘▃▍▐▞▚▌▟▛▇▉████████████████████▉▉▇▉██▓▖▚██████████████████
█████████████▙▄▖▟▉▉███████████▇▃▕▁▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▁▁▕▕▕▁▏▗▎▖▝▍▐▒▀▟▛▇███████████████████▉▇▊▇██▒▔▍██████████████████
██████████████▟▘▟▇▇████████████▜▂▕▁▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕▕ ▕▕▕▁▔▂▎▃▒▄▐▚▜▛▛▊▉███████████████████████▉▇▛▛▉█▉▚▕▏▓█████████████████
██████████████▌▐▊▉▊█████████████▆▔▁▕▕▕▕   ▕▕▕▕▕▕▕▕▁▂▏▔▂▝▘▚▀▌▅▚▃▘▒▚▀▟▓▊▊▛▛▊▉█████████████████▉▊▜▊██▆▍▃▖▛█████████████████
██████████████▅▄█▉▉██████████████▅▁▕▕▕    ▕▕▕▕  ▁▖▍▒▐▖▏▔▔▔▏▏▂▗▔▁▁▔▂▖▖▝▘▐▄▒▌▆▓▇██████████████▇▜▙▇▇▛▄▘▔▖▓█████████████████
██████████████▓▄▛█▉███████████████▅▁▕▕    ▕▕   ▕▕▕▕▕▕▕▕▕▕   ▕▕▕▕   ▕▕▁▔▂▖▃▍▐▞▋▓▇███████████▉▛▀▅▓▄▐▒▀▔▗▇█████████████████
██████████████▅▏▜█▉████████████████▆▏ ▕▕   ▕    ▕▕          ▕▕▕▕▕▕▕▕▁▁▔▂▝▐▚▅▙▓▊▉██████████▊▟▄▂▗▖▎▃▎▘▏▋██████████████████
██████████████▆▍▉███████████████████▛▃                       ▕▕▕▕▕▕▁▔▗▝▘▒▀▆▜▊▉██████████▇▟▚▌▐▖▃▖▄▌▔▕▃▊██████████████████
██████████████▓▍▜█▇███████████████████▅▗             ▕       ▕▕▕▕▕▕▕▕▔▗▃▄▌▅▟▓▛▊▉▉█████▇▟▞▒▀▓▚▂▎▎▞▋▝▔▆███████████████████
██████████████▟▗▋▉▉█████████████████▉▉█▉▅▝▕                          ▕▕▔▖▃▐▒▌▋▆▆▓▊▉▊▜▅▄▄▐▐▘▂▁▘▝▖▖▘▃▋████████████████████
█████████████▉▒▂▟█████████████████████████▜▞▖▁                   ▕▕▕   ▕▁▏▂▗▎▘▐▒▚▞▒▍▝▖▎▙▍▔▂▝▚▀▚▗▗▔▐▇██▉▉████████████████
█████████████▛▝▂▜████████████████████████████▓▅▝▔▁▕                ▕▕  ▕▕▔▏▂▎▝▝▎▗▂▂▂▏▏▎▍▍▚▔▖▄▚▋▋▝▒▜███▊▊████████████████
█████████████▊▐▁▅██████████████████████████████▊▍▖▂▏▁▕▕            ▕▕▕▕▁▔▏▂▂▂▔▁▁▁▁▁▕▕ ▁▐▆▉▀▂▂▃▔▎▚██▜▞▇█▇████████████████
█████████████▓▐▏▌███████████████████████████████▅▎▗▂▏▔▁▕▕         ▕▕▕▕▁▕▕▕▕▕▕▕▕▕▕▕▂▔▏▍▀▀▄▚▛▛▎▂▝▉▜▚▊▜▋▊▛▜████████████████
████████████▉▞▃▁▚███████████████████████████████▉▐▗▏▔▁▁▕           ▕▕▕▕▕▕▕▕▕▕   ▔▃▒▒▜██▎▒▍▂▝▋▊▟▃▖▎▄▚▙▟▓█████████████████
████████████▊▗▔▕▀█▉██████████████████████████████▆▖▏▁▁▕▕          ▕▕▕▕▕▕▕▕   ▕▖▃▃▃▋▙▘▍▌▃▝▄▛▓▋▘▞▌▝▒█▛▓██▇████████████████
████████████▙▌▏▁▆████████████████████████████████▙▍▂▁▕▕▕▕              ▕  ▕▁▗▘▝▃▗▕▕▏▌▅▀▊██▓▆▀▒▚▌▍▞▀▞▙▉▊▇████████████████
████████████▛▞▕▕▅████████████████████████████████▟▄▖▔▁▕▕▕                ▁▏▔▁▔▐▍▎▘▐▌▉██▜▀▀▅▒▘▘▍▚▒▒▜▓▓█▇█████████████████
████████████▆▂▁▕▚███▉▉███▉▉█████████████████████▉▆▄▎▂▁▕▕             ▕▕▁▂▖▖▏▖▂▀▊█████▉█▊▋▀▌▚▃▘▓▒▍▟▇▜▆▇███████████████▉▇█
▟▌▚▙▀▄▌▀▋▄▐▄▍▄▁ ▖▉▉▙▇███████████████████████████▇▟▒▎▖▏▁▕        ▕▔▁▁▁ ▕▔▟▊▙▋▅▀▌▛██▊▓▇▇▟▌▒▍▒▞▝▖▖▝▌▀▆▇▉███▇███▛█████▉██▇██
▂▂▚▀▞▚▒▙▅▎▝▙▒▝▁▔▐██▇▉█▇▉█████████████████████████▉▜▚▍▎▁         ▕▂▒▀▍▍▖▗▗▃▀▊████▜▜▟▚▅▀▅▄▝▃▘▝▘▃▓▇▟▙█▉▛█▉▉███▇▇███▇▇██████
▔▄▍▗▝▄▃▎▘▝▄▄▀▐▁▗▄▉▉██▉▉█████████████████████████████▛▚▔     ▕▘▐▗   ▖▒▅▟▛▓▅▟▉█▊▉█▉▛▙▊▋▟▌▅▞▅▇▋▃▚▛▆▋▀▛█▉▇▓▇█▉█▇████▜▊▛▆▟▟▌▒
▃▃▄▘▍▘▄▀▊▐▘▝▒▔▕▕▂▇▊▉██████▉██████████████████████████▇▝  ▕ ▕▕▗▚▚▅▙▌▘▗▃▖▞▇███▇▚▅█▟▞▄▀▞▚▍▘▔▖▞▒▐▀▚▐▚▆▙▊▇▜▚▓▊▜▛▇▇▊████▊▇▊▟▆▙
▂▝▐▎▖▃▃▃▘▃▅▋▆▃▁▕▄▉▊█▇▛███▇█████▉█████████████████████▟▂▕▁▋▌▗▗▔ ▁▗▞▟▛█▛▟▟▇█▉▉▇▊█▉▛▇▅▄▃▚▋▌▞▅▒▄▄▟▜▊▆▜▅▌▉▇▒▅▊▛▅▅▓▜▙▊█▓▊██▉▉█
▖▒▀▚▋▊▛▘▐▅▘▗▝▖▗▂▓███▉▇███▉█████▉▉██████████████████▉▋▎▁▕▕▖▒▐▌▌▄▝▖▖▁▂▞▛▊███▙▐▐▆▅▃▐▙▆▟▛▓▒▚▊▊▀▄▞▆▇▙▍▝▌▓▉▜▟▉█▙▚▓▅▟▓▙▙▄▄▜▇▊▙▙
▁▁ ▁▔▖▃▐▌▇▌▚▇▞▎▂▊▇▊█████████▉██▜▟▛▟▟▜▉██████████████▅▏▐▚▏▕▃▔▗▘▃▚▋▛▓▙▟▟▛██████▛▙▜▛▌▍▀▊▉▌▞▊▊▋▀▚▄▒▐▘▅▊▟▞▃▞▉█████▉██▇▋▓▇▆▚▟▓
▃▘▝▝▝▁▖▝▏▘▅▞▚▞▕▘▇███████████▉██▅▙▟▟▚▌▆▟▇█▉█████████▇▘▕▏▃▝▝▍▄▃▃▂▁▃▐▅▌▇███▉▙▞▌▟▒▅▇▊▜▀▓▓▒▖▘▚▞▋▄▃▅▇██▀▄▚▋▐▞▇▆▅▉▛▟▇█████▇████
▗▗▄▘▍▐▃▙▍▃▘▁ ▏▕▍███▉█████▇█████▊▙▟▛▛▃▖▂▋▊▌▟▉██▊▉█▉▊▚▂▘▐▂▁▁▁▗▘▄▐▅▅▅▌▄▞▓████▉▜▟▀▀▐▍▖▒▌▌▞▝▍▅▄▜▌▅▓▓██▉▉▇▇█▇▌▆▙▅▀▅▆▟▜▉▉▛▆▟▛█▊
▝▔▔▝▗▐▎▗▍▞▋▄▐▋▎▟███▇█████▉▊▇██▇▟▛▙▞▄▄▘▒▅▐▏▝▅▓▆▀▋▟▉▛▞▘▎▝▘▎▞▄▘▖▐▔▗▍▅▍▃▗▞▇▀▞▌▆▋▟▉▊▅▖▀▜▛▅▟▝▘▖▔▌▇▛▒▍▆▛▅▓▉▊▉█▉██▉▛██▜▓██▓▅▇▉█▙
▒▔▀▟▖▐▅▄▅▋▞▅▞▃▏▌██████████▛▊███▇▛▓▍▏▃▃▗▒▞▍▚▞▒▜▛▒▝▆▛▇▛▚▝▐▝▂▎▎▗▆▌▄▂▆▟▟▉▚▍▋▊▇▅▝▀▟█▅▝▉▜▆▛▇▇▇▆▒▌▜▅▄▙▙▒▜▇▊▄▄▇▜▜▓███▇██▉▇██████
  ▎▘▂▍▓██▋▜▀▖▔▕▎███████████████▇▊▟▝▐▖▄▞▐▛▉▄▖▆▚▜█▚▁▃▋▆▓▓▆▌▃▍▐▁▄▀▚▍▘▀▌▛▊▆▅▃▋▞▚▙▊▛▜▉▋▒▆▟▚▀▓█▇▊▉▉▉██▜▇█▙▅▊▉▆▜▓▓▟▟▉██▛▙▉██▓▛█
▁▅▍▁▍▝▎▎▐▟▓▉▐▌▆▎▅▇████████████▊▀▒▚▅▄▍▀▘▐▍▜▙▚▘▍▚▆█▟▖▗▌▆▍▒▇▊▋▛▞▍▚▖▖▍▚▌▄▚▚▐▒▟▆▋▘▒▆▛▋▀▟▙▌▍▒▛▊▞▍▟▙▌▒▛▉▟▇█▉▉█████▉▇███▊▛████▉▛
▙█▞▅▋▖▇▐▖▖▝▍▄▀▞▗▁▘▛███████████▓▄▅▜▚▞▞▓▋▎▀▒▟▊▋▗▒▐▍▛▊▌▝▜▚▄▙▛▓▙▆▋▜▟▅▋▆▟▓▙▋▌▓▊▉█▊▛▉▊▇███▇▜▊█▋▜█▇▆▚▙▙▅▋▊█▓▌▆▉▉▜▟▊█▉▜▟▟▉█▇▉███
▞▆▟▜▜▟▇▓▅▀▎▐▌▔▎▚▖▝▂▞▛▉█████████▉█▉▝▞▒▊█▀▂▌▟▛▉▆▕▖▃▗▋▅▜█▉▆▀▆▘▎▌▛▓▄▍▀▟▙▋▐▌▛▛▅▋▉▛▞▚▓█▓▇██▉██▉███▉▉█▇▟██▊▋▛▛▉▊▋▊███▉██████▇▇█
▒▅▃▔▒▍▍▌▙▆▟▙▙▌▟▜▌▀▆▀▍▞▆▋▉▛▊█▉▉▊▀▊█▟▃▆▝▛▉▃▐▍▂▅▌▞▀▇██▛▉█▟▅██▓▟▉█▉▆▟███▓▜▉█▛▋▉█▇▅▇▉▆▟▜▇▓▟▛█▊▊▇███▇▉████████▇▉██▊▊▊██▉▉▉▊▊▉█
▚▅▟▅▉▟▒▜▐▍▋▘▃▄▍▐▚▄▄▟▉▌▗▂▍▘▋▟▘▟▀▖▒▋▐▘▋▎▀▙▄▍▙▅▌▅▋▋▅▚▋████▇▀▅▊▉█▇█▊▛▉▆▙██▜▇████████▊▇█▇▟▇█▉▙▊▉█▛▋▓▇███████▇▊▉██▛▓▛▉█▇▇▛▓▛▉█
▁▃▗▗▎▒▅▜▛▉▊▞▅▓▆▀▇▝▏▅▚▖▀▜▚▆▉▊▌▅▒▟▜▜▋▐▞▌▋▙▟▄▀▄▃▄▌▐▘▞▙▅▅▇█▛▍▍▅▌▘▄▉█▜▞▀▛▓▅▀▇▇▙▛▉▉▜▜▉█▉██████████▉▊████████▉▊████▇▉███▉██████
▋█▀▔▌▅▖▗▄▒▘▐▄▒▞▐▃▍▄▄▚▋▒▎▗▍▅▍▚▟▋▍▄▙▛▋▒▛▛▆▘▌█▇▌▒█▇▚▟█▛▌▉█▙▌▉█▉▌▆██▇▜▇██▋▊█▙▀▉█▙▜▇▉▛▓▉█▉▉████████▉▊▉████▉█████▉███▉██▉▉███▉
▘▄▀▌▟▇▛▇█▆▞▀▒▌▇▄▄▓▙▍▋▉▛▚▊█▊▚▊▊▙▟▛▊▉▙▛▇▜▚▞▀▙▙▜▓▊▜▓▆▙▇█▙▜▉█▉▇▇████████████████████▓▓██▓▛███▇▟███▓▊███▉▊▇▉███▇▉███▉██▉█████
▄▔▎▐▗▎▋▌▒▀▜▋▅▋▄▍▞▍▝▝▅▌▘▘▚▛▅▅▅▎▖▏▘▘▃▙▇▟▋▆▓▌▂▍▋▟▞▋▓▒▝▚▓▍▝▚▓▓▒▀▇▉▙▙█▊▓▉▉▊▊█▉▇██████████████████████████▊█████▇███████▉█▉▉▉▉
▋▟▜▜▞▛▇▀▀█▞▔▅▋▔▌▊▞▐▛▛▖▏▅▙▞▐▜▇▟▅▊▉▛▌▓▉▉▌▌██▓▓█▛▙▇█▓▟██▋▌▙▛▌▅██▊▅██▛▊██▓▇█▓▛██▊▟▉█▉▙▇██████████▉███████████▉███▇▉██▉▉█████
▆▙▀▚▙▙▚▋▛▋▜▛▛▀▋▆▒▒▅▛▛▟▆▚▀▜▊▙▒▄▟▜▋▌▓▉▅▘▚▛▋▒▋▓▓▊▊▅▌▆▉▛▙▇▜▅▅▛████▛▙▊█▇▛█████████▉███▇████▉████▛▉████▉██████▉████▉██████████
▛▚▅▇▇▜▜▓▋▐▟▉▙▌▟▜▘▚▆▃▖▋▓▛▋▆▛▛▟▛▊▉▜▇███▊▉█▉▊▇▉█▇▇▛▇▇▉▇▛▉▇▓▓▇█▉██▛▜▇█▊▊███████████████████████████████████████████████▉████

What?

Convert an image to ascii

usage: convert_image_to_ascii.py [-h] -i IMAGE_FILE [-o OUT_FILE] [-s SHADER] [-c CHARACTERS] [-f FONT] [-x CUSTOM_WIDTH] [-y CUSTOM_HEIGHT] [-a ASPECT] [-b]

Convert image to ascii

optional arguments:
    -h, --help
            show this help message and exit
    -i IMAGE_FILE, --image IMAGE_FILE
            Image file to use
            Default: None
    -o OUT_FILE, --out-file OUT_FILE
            Text file to write
            Default: None
    -s SHADER, --shader SHADER
            Dark to light characters to use
            Default:  .'`^",:;Il!i><~+_-?][}{1)(|\/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$
    -c CHARACTERS, --chars CHARACTERS
            Dark to light characters to use
            Overrides -s/--shader
    -f FONT, --font FONT
            Font used to determine brightness when specifing characters
            Required for non-macOS systems
    -x CUSTOM_WIDTH, --width CUSTOM_WIDTH
            Custom width, recommended only for file output
            Default: Window width
    -y CUSTOM_HEIGHT, --height CUSTOM_HEIGHT
            Custom height, recommended only for file output
            Default: Window height
    -a ASPECT, --char-aspect ASPECT
            Aspect ratio of the character, ADVANCED
            Default: 2.4Adjust if aspect ration of the image feels off.  Height / width of a character block
    -b, --black-on-white
            Terminal is using dark text on light background
            Default: False

Why?

In trying to find converts, I was surprised to see that there were not that many and of those, little options and choices. In particular, the characters I wanted to use. See hangman art that I crated manually instead.

Improvements?

So much could be done. Colour? Thought about it. Better shape/character selection. As in, double the scale of the image and break the characters in to quadrants and measure each. So images that have a darker upperleft and lower right would be assigned a \ and upper left and lower left would be [, etc

State?

No known bugs. Works.

 
Page curl at bottom of the page