https://github.com/jibstack64/ascii

A standalone executable that converts a standard image into viable ASCII art.
https://github.com/jibstack64/ascii

ascii ascii-art ascii-art-generator go image

Last synced: 9 months ago
JSON representation

A standalone executable that converts a standard image into viable ASCII art.

• Host: GitHub
• URL: https://github.com/jibstack64/ascii
• Owner: jibstack64
• License: mit
• Created: 2023-01-08T18:24:06.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-01-08T21:23:51.000Z (over 2 years ago)
• Last Synced: 2025-02-14T12:55:31.203Z (about 1 year ago)
• Topics: ascii, ascii-art, ascii-art-generator, go, image
• Language: Go
• Homepage:
• Size: 1.89 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ascii

![GitHub](https://img.shields.io/github/license/jibstack64/ascii) ![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/jibstack64/ascii) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/jibstack64/ascii) ![GitHub all releases](https://img.shields.io/github/downloads/jibstack64/ascii/total)

A standalone executable that converts a standard image into viable ASCII art.

Syntax: `./ascii <--in> photo.png [--out] out.txt [--scale] 0.5 [--stretch] 0.5 [--print] [--close-colour] [--true-colour]`

> Often, you may require a very low scale factor (>0.1), particularly for larger images.

### Arguments

#### Required:

- `--in ` - Specifies the input image. Can be `png` or  `jpg/jpeg`.

  

#### Optional:

- `--out ` - Specifies the output file. If none is provided, this is disabled.

- `--scale ` - Scales the result, making it more viable to be printed in a console. Must be above `0` (e.g. `0.5` would halve the size of the result). Defaults to `0.5`.

- `--stretch ` - Stretches the result horizontally. This is useful for larger images. Must be above `0`. Defaults to `1`.

- `--print` - Prints the result to the console once finished.

- `--pretty` - When `--print` is passed, output is printed layer-by-layer.

- `--close-colour` - Colours the output by rounding RGB values to the closest available ANSI codes.

- `--true-colour` - Colours the output using exact RGB-ANSI codes. Not supported on most consoles. 

### GIFs

Download and use the `gif.py` script to generate an ASCII gif! Syntax: `python gif.py   [frames]`.

You can use the `view.py` script to view the generated ASCII gif: `python view.py `.

> ### Example

> ![image](https://github.com/jibstack64/ascii/raw/master/examples/smiley.png)