https://github.com/ihefty/termimage
Termimage: Convert images to ASCII art with color support in the terminal using the Tender.
https://github.com/ihefty/termimage
ascii ascii-art termimage
Last synced: 4 months ago
JSON representation
Termimage: Convert images to ASCII art with color support in the terminal using the Tender.
- Host: GitHub
- URL: https://github.com/ihefty/termimage
- Owner: IHEfty
- License: mit
- Created: 2024-10-18T15:48:52.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-03T14:17:22.000Z (about 1 year ago)
- Last Synced: 2025-03-21T00:44:33.494Z (10 months ago)
- Topics: ascii, ascii-art, termimage
- Language: Batchfile
- Homepage:
- Size: 15.6 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Termimage
This project, written using the [**Tender**](https://github.com/2dprototype/tender-free), converts images to ASCII art and displays them in the terminal with optional color support.
## Requirements
To use this project, you need to install the [**Tender**](https://github.com/2dprototype/tender-free). Clone and install Tender by following the instructions from the Tender GitHub repository:
```
git clone https://github.com/2dprototype/tender-free.git
cd tender-free
```
## Running the Project
Once you have Tender installed, you can run the project using `cli.td`. Here's how:
```
tender cli.td
```
This will render the embedded image `download.jpg` as ASCII art in the terminal.
### Customizing the Image
To display a different image, replace `download.jpg` with the name of your own image file. Make sure the image is saved in the same folder as the script.
Example:
```tender
data := embed("your_image.jpg")
sysout t.to_ascii(data, 40, 30, true)
```
Feel free to modify the width, height, and whether color is enabled by adjusting the parameters in the script.
## Files
- **termcolor.td**: Provides utilities for matching RGB values to ANSI color codes.
- **termimage.td**: Contains the logic for decoding an image and converting it to ASCII art.
- **cli.td**: The main script that processes and displays an embedded image.
Enjoy experimenting with different images and settings!
---
## **Explore More**
To explore more **Tender** projects and get access to additional code examples, visit the following repository:
[1000+ Codes in Tender](https://github.com/IHEfty/1000-Codes-in-Tender/)
This repository contains a rich collection of Tender-based code samples, ranging from simple applications to complex utilities, allowing you to enhance your understanding of **Tender** and its capabilities.