i2a
i2a creates ASCII art from images right on your terminal.
Installation
Step 1: Install dependencies
OSX:
$ brew install libtiff libjpeg webp little-cms2
Linux (Ubuntu):
$ sudo apt-get build-dep python-imaging
$ sudo apt-get install libjpeg8 libjpeg62-dev libfreetype6 libfreetype6-dev
For other operating systems, check out the instructions on this page .
Step 2: Install i2a
Option 1: Pip
$ pip install i2a
Option 2: From source
$ git clone --recursive http://github.com/mavidser/i2a.git
$ cd i2a/
$ python setup.py install
Usage
Basic usage
$ i2a image.jpg
Colored output
$ i2a --colors image.jpg
Write the art to a file
$ i2a image.jpg > ascii.txt
If the terminal has a light background
$ i2a image.jpg --invert
or
$ i2a image.jpg --bg=BLACK
Options
A complete list of available options:
--colors : Show colored output. i2a assumes that the terminal supports 256 colors.
--bold : Show bold characters. Makes the output is easier on eyes.
--invert : Invert the colors. Suitable for a light background.
--bg=(BLACK|WHITE): Specify your own background color.
--height=<val> : Set the height in number of characters.
--width=<val> : Set the width in number of characters.
--contrast=<factor> : Manually set contrast (default value: 1.5, for original image: 1.0).
--alt-chars : Use an alternate set of (more detailed) characters.
Contributing
Create an issue in the issue tracker describing the feature.
Fork the project.
Create a new branch - git checkout -b new-feature
Commit the changes and push to your branch - git push origin new-feature
Open a pull request, referencing the issue you created.
License
See the LICENSE file.
Metadata
Release files for i2a 1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| i2a-1.3-py3-none-any.whl | Python 3 | none | any | Details for i2a-1.3-py3-none-any.whl |
Release files / i2a-1.3-py3-none-any.whl
| Download URL | i2a-1.3-py3-none-any.whl |
|---|---|
| Size | 6.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4b46069618277642c674b92b4a968b5fc994a8c6edaf89e7c115edfdb9af7bcb
|
|
BLAKE2b-256 checksum How to use checksums |
1de2bddc0adb39697bbe790bed3e399b687e0047665085289737720e71b77bd1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.34.0 CPython/3.6.0
|
Security for i2a 1.3
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.