Metadata-Version: 2.4
Name: wj-termimage
Version: 1.0.0
Summary: Display images in the terminal using ANSI colour and Unicode half-block graphics
Project-URL: Homepage, https://pypi.org/project/wj-termimage/
Author: WaterJuice
License-Expression: MIT
License-File: LICENSE
Keywords: ansi,console,image,jpeg,terminal
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# wj-termimage

Display images in the terminal using ANSI 24-bit colour and Unicode half-block graphics.

## Features

- Pure Python 3.14+ — no external dependencies
- Built-in image decoding (JPEG baseline + progressive, PNG, BMP)
- Three colour modes: 24-bit true colour, 256-colour, and 8-colour basic ANSI
- Area-averaged downscaling for smooth output (nearest-neighbour optional)
- Preserves aspect ratio, fits to terminal size by default
- Optional `--full-width` mode for scrollable output

## Installation

```bash
pip install wj-termimage
```

## Usage

```bash
# Display an image (fits to terminal)
wj-termimage photo.jpg

# Display at full terminal width (may scroll)
wj-termimage --full-width photo.jpg

# Use nearest-neighbour scaling (faster, pixelated)
wj-termimage --nearest photo.png

# Use 256-colour or 8-colour mode for limited terminals
wj-termimage --colour 256 photo.jpg
wj-termimage --colour 8 photo.jpg

# Save ANSI output to a file
wj-termimage --output render.txt --width 120 photo.bmp
```

## Licence

MIT — Copyright (c) 2026 WaterJuice
