Metadata-Version: 2.4
Name: terminal-image
Version: 0.1.0
Summary: Display images in the terminal using ANSI colors
Author-email: Soundhearddev <letdes50@gmail.com>
License-Expression: Apache-2.0
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: opencv-python>=4.0.0
Dynamic: license-file

# terminal-image

Display images in your terminal using ANSI true color escape codes.

## Features

- Display PNG/JPG images in the terminal
- ANSI 24-bit true color support (works in most modern terminals)
- Automatically fits image to terminal size
- Simple CLI usage

## Installation

Install using pip:

```
pip install terminal-image
```

Or install locally from source:

```
git clone https://github.com/Soundhearddev/terminal-image.git
cd terminal-image
pip install -e .
```

## Usage

Display an image in the terminal:

```
timage path/to/image.png
```

You can also add an optional delay (in seconds) before the program starts:

```
timage path/to/image.png 5
```
 
### preview

| Original image            | Terminal output                    |
|---------------------------|------------------------------------|
| ![Original](test3.png)    | ![Preview](Screenshots/cat.png)   |

## Requirements

- Python 3.7+
- A terminal that supports ANSI true color
- opencv-python
