wj-termimage 1.0.0

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

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

pip install wj-termimage

Usage

# 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