Skip to main content

Show images directly on terminal using Xterm colors.

Project description

Img2sh

Img2sh is a tool to show images directly on terminal. For color images 256 xterm color support is required. This script basically resize the image with antialliasing and quantized its colors to xterm color pallette.

Demo

img2sh demo.jpeg

Result:

usage: img2sh [-h] [-w WIDTH] Image

Show images directly on terminal.

positional arguments:
  Image

optional arguments:
  -h, --help            show this help message and exit
  -w WIDTH, --width WIDTH
                        image width

Installing

It can be easily install using pip.

pip install img2sh --user

Installing from source:

git clone https://github.com/mozanunal/img2sh
cd img2sh
pip install -r requirements.txt
python setup.py install

Development

Setup development environment

Pipenv is using for environment management.

pipenv install --dev

Following command should be executed to create interactive shell in this pipenv.

pipenv shell

Development

In this repo issue based development is active. For any problems or new enhancements please open a issue.

Autopep8 is using for formatting. Pylint is using for linting.

Deployment

The following 2 commands are required to deploy over pypi.

python setup.py sdist bdist_wheel
twine upload --repository-url https://upload.pypi.org/legacy/ dist/*

Licence

MIT

Acknowledges

This package is developed using:

Contributors

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

img2sh-0.1.4.tar.gz (4.5 kB view details)

Uploaded Source

Built Distribution

img2sh-0.1.4-py2-none-any.whl (5.8 kB view details)

Uploaded Python 2

File details

Details for the file img2sh-0.1.4.tar.gz.

File metadata

  • Download URL: img2sh-0.1.4.tar.gz
  • Upload date:
  • Size: 4.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/2.7.15rc1

File hashes

Hashes for img2sh-0.1.4.tar.gz
Algorithm Hash digest
SHA256 fd19f16e8358ea9bd120ef0619d6cbe6033ff32ce1e8245f0f11451dfa05b1d2
MD5 7cd8ab760b4a90d83b3dc5247d1495f1
BLAKE2b-256 7dbf758d5d791efc496da527285b25b6ae5472d65acdc86ce04c88c2680fa2ac

See more details on using hashes here.

File details

Details for the file img2sh-0.1.4-py2-none-any.whl.

File metadata

  • Download URL: img2sh-0.1.4-py2-none-any.whl
  • Upload date:
  • Size: 5.8 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/2.7.15rc1

File hashes

Hashes for img2sh-0.1.4-py2-none-any.whl
Algorithm Hash digest
SHA256 357d5c8eea9db45730aed638a6ec2baccec2ca359dd145310eb29038941e0a73
MD5 e78aa55b1239126a3ab39a41f7a020d6
BLAKE2b-256 99c4cdb927f3146efe930f19731d90f27047ce7b817b8e44964a72034d98b486

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page