Skip to main content

Python bindings for Chafa. Visualize images with text in python.

Project description

 

chafa.py

 

Terminal graphics with Python!

📙 Docs  -  🌱 Tutorial  -  💾 Examples

PyPI   GitHub Workflow Status   Sneks

What is this?

Have you ever wanted to display an image in your TUI Python application? Well, now you can!

Chafa is a wonderful command-line utility, created by Hans Petter Jansson, for visualizing images in the terminal. In Jansson's own words:

The future is (still) now!

The premier UX of the 21st century just got a little better: With chafa, you can now view very, very reasonable approximations of pictures and animations in the comfort of your favorite terminal emulator. The power of ANSI X3.64 compels you!

chafa.py is a python wrapper for the chafa library so you can use rad graphics in your cool Python applications! The chafa.py library tries to be intuitive and aims to produce very readable code.

Features include:

  • ⚡ Modern and intuitive Python API
  • 📖 Extensive documentation and a tutorial
  • 📟 Generate text based approximations of images in (almost) any terminal emulator
  • 6️⃣ Sixels, 😸 Kitty and 🍎 ITerm2 image protocols support
  • 🐧 Linux, 🍎 MacOS (x86 and ARM), 🪟 Windows support

Example

Here is a picture of a cute snake rendered to text using chafa.py:

✏️ Code

For more examples, head on over to the docs at chafapy.mage.black.

from chafa import *
from chafa.loader import Loader

# The font ratio of JetBrains Mono (width/height)
FONT_RATIO = 11/24

# Create a canvas config
config = CanvasConfig()

# Configure the canvas geometry
config.width  = 40
config.height = 40

# Load the snake
image = Loader("./snake.jpg")

# Configure the ideal canvas geometry based on our FONT_RATIO
config.calc_canvas_geometry(
   image.width,
   image.height,
   FONT_RATIO
)

# Init the canvas
canvas = Canvas(config)

# Draw to the canvs
canvas.draw_all_pixels(
   image.pixel_type,
   image.get_pixels(),
   image.width, image.height,
   image.rowstride
)

# Print the output
output = canvas.print()

print(output.decode())

Where can I get it?

Chafa.py is available on PyPI. You can install it by running

pip install chafa.py

If you want to use the included Loader class to load images, you will also need to install MagickWand.

Dependencies

  • Python 3.8 or later

Optional Dependencies

📬 P.S. The snakes don't bite (I think...) 🐍🐍🐍🐍🐍

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

chafa.py-1.2.0.tar.gz (4.2 MB view hashes)

Uploaded Source

Built Distributions

chafa.py-1.2.0-cp313-cp313-win_amd64.whl (2.2 MB view hashes)

Uploaded CPython 3.13 Windows x86-64

chafa.py-1.2.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl (603.4 kB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.28+ x86-64

chafa.py-1.2.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl (475.8 kB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ ARM64 manylinux: glibc 2.28+ ARM64

chafa.py-1.2.0-cp313-cp313-macosx_14_0_arm64.whl (853.0 kB view hashes)

Uploaded CPython 3.13 macOS 14.0+ ARM64

chafa.py-1.2.0-cp313-cp313-macosx_13_0_x86_64.whl (951.2 kB view hashes)

Uploaded CPython 3.13 macOS 13.0+ x86-64

chafa.py-1.2.0-cp312-cp312-win_amd64.whl (2.2 MB view hashes)

Uploaded CPython 3.12 Windows x86-64

chafa.py-1.2.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl (603.4 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.28+ x86-64

chafa.py-1.2.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl (475.8 kB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ARM64 manylinux: glibc 2.28+ ARM64

chafa.py-1.2.0-cp312-cp312-macosx_14_0_arm64.whl (853.0 kB view hashes)

Uploaded CPython 3.12 macOS 14.0+ ARM64

chafa.py-1.2.0-cp312-cp312-macosx_13_0_x86_64.whl (951.2 kB view hashes)

Uploaded CPython 3.12 macOS 13.0+ x86-64

chafa.py-1.2.0-cp311-cp311-win_amd64.whl (2.2 MB view hashes)

Uploaded CPython 3.11 Windows x86-64

chafa.py-1.2.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl (603.4 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.28+ x86-64

chafa.py-1.2.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl (475.8 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARM64 manylinux: glibc 2.28+ ARM64

chafa.py-1.2.0-cp311-cp311-macosx_14_0_arm64.whl (853.0 kB view hashes)

Uploaded CPython 3.11 macOS 14.0+ ARM64

chafa.py-1.2.0-cp311-cp311-macosx_13_0_x86_64.whl (951.2 kB view hashes)

Uploaded CPython 3.11 macOS 13.0+ x86-64

chafa.py-1.2.0-cp310-cp310-win_amd64.whl (2.2 MB view hashes)

Uploaded CPython 3.10 Windows x86-64

chafa.py-1.2.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl (603.4 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.28+ x86-64

chafa.py-1.2.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl (475.8 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARM64 manylinux: glibc 2.28+ ARM64

chafa.py-1.2.0-cp310-cp310-macosx_14_0_arm64.whl (853.0 kB view hashes)

Uploaded CPython 3.10 macOS 14.0+ ARM64

chafa.py-1.2.0-cp310-cp310-macosx_13_0_x86_64.whl (951.2 kB view hashes)

Uploaded CPython 3.10 macOS 13.0+ x86-64

chafa.py-1.2.0-cp39-cp39-win_amd64.whl (2.2 MB view hashes)

Uploaded CPython 3.9 Windows x86-64

chafa.py-1.2.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl (603.4 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.28+ x86-64

chafa.py-1.2.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl (475.8 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARM64 manylinux: glibc 2.28+ ARM64

chafa.py-1.2.0-cp39-cp39-macosx_14_0_arm64.whl (853.0 kB view hashes)

Uploaded CPython 3.9 macOS 14.0+ ARM64

chafa.py-1.2.0-cp39-cp39-macosx_13_0_x86_64.whl (951.2 kB view hashes)

Uploaded CPython 3.9 macOS 13.0+ x86-64

chafa.py-1.2.0-cp38-cp38-win_amd64.whl (2.2 MB view hashes)

Uploaded CPython 3.8 Windows x86-64

chafa.py-1.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl (603.4 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64 manylinux: glibc 2.28+ x86-64

chafa.py-1.2.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.manylinux_2_28_aarch64.whl (475.8 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARM64 manylinux: glibc 2.28+ ARM64

chafa.py-1.2.0-cp38-cp38-macosx_13_0_x86_64.whl (951.2 kB view hashes)

Uploaded CPython 3.8 macOS 13.0+ x86-64

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