This program converts images and gifs to ASCII
It can also display them in the terminal
Python==3.8.1
Pillow==7.0.0
Requests==2.22.0
It accepts images and gifs. You can specify the path or link (ending in .jpg/.png/.gif ...)
Example: python ascii.py /path/to/file.png
/ python ascii.py https://site.domain/file.gif
You can specify the scale
, reverse
, chars
, rotate
, contrast
and wide
arguments
scale {integer}
- scales the source file to the integer specified
Example: python ascii.py /path/to/file.gif scale 75
reverse
- swaps black&white for the given file
Example: python ascii.py /path/to/file.gif reverse scale 10
chars {'string'}
- specifies the characters for conversion
Example: python ascii.py /path/to/file.jpg chars ' $@B%8&WM#'
(default is ' :co@')
rotate {'string'}
- rotates the characters by either -90 or 90 degrees; the accepted values are 'left' and 'right'
Example: python ascii.py /path/to/file.jpg rotate left
contrast
- converts using these characters ' ░▒▓█'; this will override the chars
arguments
Example: python ascii.py /path/to/file.jpg contrast
wide {int}
- specifies how wide each cell will be
Example: python ascii.py /path/to/file.jpg wide 3
(default is 2)
All arguments can be nested and combined
Displays the image/gif in the terminal. For gifs, it will infinitely loop through the frames
Example: python show.py
You can specify the s
argument to specify the delay between frames
s {float}
- delay between frames, default is 0.07 seconds
Example: python show.py s 0.3