convert_image_to_ascii.py
A image to ascii converter
Convert an image using a standard character set or a custom character set
\$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$
$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$@@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.
