Metadata-Version: 2.1
Name: ASCIIcli
Version: 0.1.0
Summary: A command-line tool that converts images to ASCII art.
Home-page: https://github.com/mrq-andras/asciicli
Author: mrq-andras
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

---
  
"   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](https://pypi.org/project/asciicli/).
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](https://github.com/mrq-andras/asciicli/releases). 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 [-h] [--percent] [--set] [--random] [--invert] [--darkness] C:/full/path/to/your/image`

Set 1: A --> Z  
Set 2: 0 --> 9  
Set 3: 0, O, o, 8, 9, 6, @, &, ., ", :  
Set 4: ▀, ▄, ▌, ▐, ■, ◽, ◆, ►, ●, ░, ▒, ▓, █  
Set 5: !, @, #, $, %, ^, &, *, (, ), _, +, -, =  

**_NOTE: SET 5 MIGHT NOT DISPLAY CORRECTLY IN CERTAIN FONTS OR EDITORS_**

If you have downloaded the application through pip input the following command in the terminal:  
`asciicli --percent 20 --set 1 --random True C:/full/path/to/your/image`

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 --percent 20 --set 1 --random True C:/full/path/to/your/image`

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 `--set 1` 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 boolians and must be set to True/False, whereas Darkness, Set, Height and Width are all integers.

---
[`LICENSE`](./LICENSE)
