https://github.com/phoenixr-codes/im2ansi
Convert images into ANSI art (TXT, HTML & SVG)
https://github.com/phoenixr-codes/im2ansi
ansi art fetch html image neofetch svg terminal waifufetch
Last synced: 22 days ago
JSON representation
Convert images into ANSI art (TXT, HTML & SVG)
- Host: GitHub
- URL: https://github.com/phoenixr-codes/im2ansi
- Owner: phoenixr-codes
- License: mit
- Created: 2025-03-18T20:10:11.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-10-25T12:46:42.000Z (8 months ago)
- Last Synced: 2025-12-28T21:18:21.540Z (6 months ago)
- Topics: ansi, art, fetch, html, image, neofetch, svg, terminal, waifufetch
- Language: V
- Homepage:
- Size: 10.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
im2ansi
`im2ansi` is a tool for turning images into ANSI art as seen above. It supports
ANSI (terminal), HTML and SVG output.
## Installation
Go to [Releases][] and download the executable for your system or install it via
[V][V language]:
```console
v install --git https://github.com/phoenixr-codes/im2ansi
```
## Building
Building requires a [V compiler][V language].
```console
v .
```
## Example Usage
> **Show help**
> ```bash
> im2ansi --help
> ```
> **Genrate an ANSI art from `image.png` of size 30 with seed 123 and character set {P,I,K,A,C,H,U}**
> ```bash
> im2ansi -s 30 --path image.png --seed 123 -c PIKACHU > output.ansi
> ```
> **Generate an ANSI art as SVG from `image.jpg` of size 50 and enable debugging**
> ```bash
> im2ansi --path image.jpg -s 50 --format svg --log DEBUG > output.svg
> ```
> **Generate an ANSI art as HTML from `image.jpg` with embedded text**
> ```bash
> im2ansi --path image.jpg -s 80 --format html -c THEENDISNEVER --cycle > output.html
> ```
[Releases]: https://github.com/phoenixr-codes/im2ansi/releases
[V language]: https://vlang.io/