Skip to main content

Terminal Image Viewer

License

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

Metadata

Release files for tiv 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tiv 0.3.1
File Size Uploaded Provenance
tiv-0.3.1.tar.gz 4.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for tiv 0.3.1
File Interpreter ABI Platform
tiv-0.3.1-py3-none-any.whl Python 3 none any Details

Total release size: 9.5 kB

Release files / tiv-0.3.1.tar.gz

Download URL tiv-0.3.1.tar.gz
Size 4.9 kB
Tags Source
SHA-256 checksum
How to use checksums
af30ee677ab26f14df5c421c4548ae42a74fb172172be3082c982f6799d917da
BLAKE2b-256 checksum
How to use checksums
8aa5bdaa55d3c3280f37f3363176c333fb6b58693cdb7c1afa38f761e3e07d34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / tiv-0.3.1-py3-none-any.whl

Download URL tiv-0.3.1-py3-none-any.whl
Size 4.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c7be01c202342464f97f3199609d87193e5fdd0c5bde88f1558d3ac2efd3a7fe
BLAKE2b-256 checksum
How to use checksums
5689d4509914d01028bacd23043ba54bc7322ce7a7118a63781724c89d427ca0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Security for tiv 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page