A command-line tool that converts images to ASCII art.


Keywords
ascii, ascii-art, ascii-art-generator, ascii-graphics, cli, command-line, command-line-tool, python, python3
License
MIT
Install
pip install ASCIIcli==0.1.1

Documentation


โ€‡โ€‡โ€‡35005550โ€‡โ€‡โ€‡โ€‡22โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡666โ€‡โ€‡โ€‡โ€‡โ€‡666โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡165โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡
โ€‡โ€‡002โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡77โ€‡โ€‡โ€‡โ€‡003โ€‡โ€‡โ€‡โ€‡555โ€‡โ€‡โ€‡โ€‡โ€‡555โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡350โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡
โ€‡056โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡155677โ€‡โ€‡555โ€‡โ€‡โ€‡โ€‡โ€‡555โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡โ€‡3554โ€‡337โ€‡โ€‡โ€‡โ€‡
โ€‡053โ€‡โ€‡โ€‡89889โ€‡โ€‡โ€‡00โ€‡โ€‡โ€‡4559โ€‡โ€‡โ€‡โ€‡55555555555โ€‡โ€‡006โ€‡โ€‡โ€‡400โ€‡โ€‡3557โ€‡โ€‡โ€‡008โ€‡โ€‡
โ€‡059โ€‡โ€‡โ€‡โ€‡โ€‡300โ€‡โ€‡โ€‡00โ€‡โ€‡โ€‡โ€‡051โ€‡โ€‡โ€‡โ€‡555โ€‡โ€‡โ€‡โ€‡โ€‡555โ€‡โ€‡059โ€‡โ€‡โ€‡700โ€‡โ€‡350โ€‡โ€‡โ€‡โ€‡850โ€‡โ€‡
โ€‡3007โ€‡โ€‡โ€‡โ€‡700โ€‡โ€‡โ€‡00โ€‡โ€‡โ€‡โ€‡053โ€‡โ€‡โ€‡โ€‡555โ€‡โ€‡โ€‡โ€‡โ€‡555โ€‡โ€‡059โ€‡โ€‡โ€‡400โ€‡โ€‡350โ€‡โ€‡โ€‡โ€‡950โ€‡โ€‡
โ€‡โ€‡โ€‡900988500โ€‡โ€‡โ€‡00โ€‡โ€‡โ€‡โ€‡90034โ€‡โ€‡000โ€‡โ€‡โ€‡โ€‡โ€‡000โ€‡โ€‡800371650โ€‡โ€‡205847805โ€‡โ€‡โ€‡


Command Line ASCII Art Generator

ASCIIcli is a command line interface that is powered by Python3. You can generate ASCII art by importing an image and then selecting the character set that you want to generate with.

Installation & Building

PIP

The easiest way to install ASCIIcli is by using the PyPI library.
You can run pip install ASCIIcli on any command-line with Python3 in order to install it.

Releases

If you are unable to use the PyPI library you can access ASCIIcli by going to our releases page.
There you can download the .exe file and run the CLI by going to the folder that the program is downloaded in and running .\asciicli


Usage

asciicli C:/full/path/to/your/image [-h] [-percent VALUE] [-set VALUE] [-gray VALUE] [-random] [-invert]

If you have downloaded the application through pip input the following command in the terminal:
asciicli C:/full/path/to/your/image -p 10 -s 1 -r

If you are running the .exe package you will need to slightly alter the command by calling the exact folder of ASCIIcli
.\path\to\asciicli.exe C:/full/path/to/your/image -p 10 -s 1 -r

Assuming the file is 1024x219, this command will generate a .txt file that is 21 lines long with each line taking up 201 characters using the character set to one. The -s variable is optional as the default character set is one. Random has been set to true and it will take the image from assets/input.jpg and generate a .txt file titled input-ascii.jpg in the same folder as the image.

Random and Invert are will take effect when called upon with the -random/-r and -invert/-i arguments, whereas the Gray and Set arguments are all integers.

Basic Latin & Latin Supliments

Set 1: a --> z (lowercase)
Set 2: A --> Z (uppercase)
Set 3: 0 --> 9 (numerals)
Set 4: ,, :, :, -, โ€ณ, ., &, @, ^, /, , -, =, !, ยก, ?, ยก, ยฟ, ๐Ÿ™ป, |, ยฆ, โ€–, โ€ข, ยท, ยฉ, โ„—, ยฎ, โ€œ, โ€, ', ", ยซ, ยป, (, ), [, ], {, }, ยถ, ยง, โ€ , โ€ก, โง, โ—Š (punctuation & typographical symbols)
Set 5: ยค, ยต, ยข, ยฅ, ยฃ, $, %, #, โ„–, ยบ, ยช, %, ยฐ, +, -, รท, ร—,
, /, ยฑ, ยฌ, ~, _, ^, <, > (mathematical symbols)

Block Elements & Geometric Shapes

Set 6: โ–‘, โ–’, โ–“, โ–ˆ (Rectangle element characters)
Set 7: โ–ก, โ–ข, โ—ซ, โ—ฐ, โ—ฑ, โ—ฒ, โ—ณ, โ—ง, โ—จ, โ—ฉ, โ—ช, โ—˜, โ–ค, โ–ฅ, โ–ฆ, โ–ง, โ–จ, โ–ฃ, โ–ฉ, โ– 


LICENSE