Asciify Term
Asciify Term is a modern, cross-platform CLI utility that renders high-resolution images as ASCII art directly in your terminal.
Originally built as a creative toy, it has evolved into a powerful DevOps utility for verifying image assets in headless environments (SSH, Docker, WSL) where GUI viewers are unavailable. It supports local files, remote URLs, and TrueColor rendering.
🚀 Features
- Terminal-First Workflow: Instantly render images to stdout with zero configuration.
- Headless Support: Perfect for verifying plot.png or asset files on remote servers via SSH.
- URL Support: Fetch and render images directly from the web (http://...) without manual downloading.
- TrueColor Support: Renders images in full 24-bit ANSI color.
- Smart Resizing: Automatically fits the output to your current terminal window dimensions.
- Export Options: Save outputs as plain text .txt or color-preserving .html.
- Legacy Interactive Mode: A guided menu system for creative exploration.
Installation
Install directly from PyPI:
pip install asciify-term
Usage
1. The Quick Scan (Default)
The primary use case is to quickly view an image in your terminal. The output automatically scales to fit your window.
# Local File
asciify -i image.jpg
# Remote URL
asciify -i https://example.com/logo.png
2. Color Mode
To view the image with its original colors (using ANSI escape codes):
asciify -i image.jpg --color
3. Saving Output
You can save the generated art to a file instead of (or in addition to) printing it.
Save to current directory (Auto-named):
asciify -i image.jpg -s
# Creates: ascii_image_TIMESTAMP.txt
Save with custom name/location:
# Save as specific filename (no extension needed)
asciify -i image.jpg --output-file-name my_art
# Save to a specific folder
asciify -i image.jpg --output-folder ./art_gallery
Save as HTML (Preserves Color):
asciify -i image.jpg --color --html
4. Customizing Dimensions
By default, asciify fits the image to your terminal. You can override this:
# Force specific width (Height auto-calculated)
asciify -i image.jpg --width 100
# Force specific width AND aspect ratio
asciify -i image.jpg --width 100 --aspect-ratio 2.0
# Downsize by a factor of 4
asciify -i image.jpg --downsize 4
5. Managing Charsets
You can change the characters used for rendering (e.g., standard ASCII, blocks, braille).
List available charsets:
asciify --show-charsets
Use a specific charset for one run:
asciify -i image.jpg -c blocks
Set a new default charset (Persistent):
asciify --set-charset blocks
# All future runs will now use 'blocks' by default
Advanced: Interactive Mode
For a more guided, "creative" experience with animations and previews, use the --full flag. This launches the legacy interactive menu.
asciify --full
Configuration Reference
| Flag | Description |
|---|---|
| -i, --input-file | Path to local image OR URL (http://...). |
| --color | Enable TrueColor ANSI output. |
| -s, --save | Save output to current directory. |
| --output-folder | Specify folder for saved output. |
| --output-file-name | Specify filename (without extension). |
| --html | Save as .html file. |
| --width | Set target width. |
| --height | Set target height. |
| --aspect-ratio | Force specific aspect ratio. |
| --downsize | Downsize image by factor n. |
| -c, --charset | Use specific charset string. |
| --show-charsets | List all built-in charsets. |
| --set-charset | Set default charset preference. |
| --full | Launch legacy interactive mode. |
License
Distributed under the MIT License. See LICENSE for more information.
1 maintainer
Metadata
1 maintainer
Release files for asciify-term 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 2.0 MB
Release files / asciify_term-0.5.0-cp314-cp314-win_amd64.whl
| Download URL | asciify_term-0.5.0-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 135.8 kB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
93dbf35009e0cf10c0cc6068b6dff0427a0aa3bde14b4e6a9c0ebb2dbf0cf21e
|
|
BLAKE2b-256 checksum How to use checksums |
d61115f2033c27a3df650139749f50e7cb6c7aa62a1372ae3a7c7100799ad2e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp314-cp314-manylinux_2_24_x86_64.whl
| Download URL | asciify_term-0.5.0-cp314-cp314-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 283.4 kB |
| Tags | CPython 3.14 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
5ad6559cfc1d726a5c7d467c597fd88ebb6ff6d8aa3b5117736c9f66b0fc005a
|
|
BLAKE2b-256 checksum How to use checksums |
3b7307698b16a4780c2942dc49962a643bcd041b639cdc6f2efc267669f2505d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | asciify_term-0.5.0-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 241.7 kB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6cb0ea60a045bf51d1a29e83feb775e1390999628ca592dbb76972c3a24efd07
|
|
BLAKE2b-256 checksum How to use checksums |
621c0d0aabae56a85308140b05d0cf92d6b4177ed285cd88197b782c146f0767
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp313-cp313-win_amd64.whl
| Download URL | asciify_term-0.5.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 135.8 kB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
c4f33ed092cbc1211a388309fb4a3b50132ca6e39412e11b0da30f2b1a7c6a70
|
|
BLAKE2b-256 checksum How to use checksums |
05048075b3982b65893c7ee1a3691777d2429aca811692ec4cedfa42b90a89c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp313-cp313-manylinux_2_24_x86_64.whl
| Download URL | asciify_term-0.5.0-cp313-cp313-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 283.4 kB |
| Tags | CPython 3.13 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
1a62abeae1842a5a41e3763f4daeb6ad7a9ce4dd39c1112325d013d9890f9d9d
|
|
BLAKE2b-256 checksum How to use checksums |
859c049aa183e0bacceedd1c50db1d3c318d3bdc1e0d88574ade2a5891381a26
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | asciify_term-0.5.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 241.7 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3454d70b780e1277c706fd13476806321f17fe36a84aba1017cbe253fdf70548
|
|
BLAKE2b-256 checksum How to use checksums |
ac7fe747674fad8fe845e97c54225dd05c9db3b63a9324986853093c12c4f7e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp312-cp312-win_amd64.whl
| Download URL | asciify_term-0.5.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 135.7 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f522a4b46e138d98da4543899c1aa75febead977ea0f1e00d2abc7402978087f
|
|
BLAKE2b-256 checksum How to use checksums |
55245a243e17cced841b9e5ac09c0bd444c1e21e73cbdf55805f6dec466932a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp312-cp312-manylinux_2_24_x86_64.whl
| Download URL | asciify_term-0.5.0-cp312-cp312-manylinux_2_24_x86_64.whl |
|---|---|
| Size | 283.6 kB |
| Tags | CPython 3.12 Linux glibc 2.24+ x86-64 |
|
SHA-256 checksum How to use checksums |
d3bd1af77871525dd2989a8c2350d399ef11d103ac215a5a04d031f556903b41
|
|
BLAKE2b-256 checksum How to use checksums |
63ba4023bbfd4ff0622eb33ad464c06ff93a0a9749b2edac991fd92bad0284ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / asciify_term-0.5.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | asciify_term-0.5.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 241.6 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a4d3cc28ee003c8dbccf8374bb2271af3a104a1e6d8a6f9bbabc764e05b8aa45
|
|
BLAKE2b-256 checksum How to use checksums |
68642bdc7832ba1eba77c4450bd6decf9ede15c1f525a5e63bf223d7baa3de38
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logSecurity for asciify-term 0.5.0
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.
Full provenance
All 9 files in this release have been uploaded with provenance metadata.
Attestation for asciify_term-0.5.0-cp314-cp314-win_amd64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logA 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.
