tiv 0.3.1

Render images as ANSI colors in a terminal

Terminal Image Viewer

Render JPEG, PNG, GIF, and SVG images as ANSI colors in a terminal.

Source: https://gitlab.nul.one/mush/tiv

Installation

Install with pipx (recommended)

pipx install tiv

Install from a checkout

pipx install .

Install from git

pipx install git+https://gitlab.nul.one/mush/tiv.git

For development, install the package and its test and lint tools into a virtual environment:

python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/python -m pip install -e '.[dev]'

Usage

tiv [OPTIONS] IMAGE [IMAGE [IMAGE...]]

Options

• -w, --width INTEGER - Set image width in number of terminal characters. Defaults to the current terminal width.
• -a, --aspect-ratio FLOAT - Specify character aspect ratio (width:hight). Default is 0.5.

Development

python -m pytest
python -m ruff check .
python -m ruff format --check .
python -m build