ipython-icat 0.2.0

IPython magic command for displaying images in kitty terminal

ipython-icat

Installation

You can install ipython-icat using pip:

pip install ipython-icat

Requirements

• Python 3.9+
• IPython
• matplotlib
• Pillow (PIL)
• kitty terminal

Usage

Loading the Extension

In your IPython session, load the extension:

%load_ext icat

Displaying Matplotlib Plots

To use the kitty backend for matplotlib:

%plt_icat

After running this command, any matplotlib plots you create will be displayed directly in your kitty terminal.

Displaying Images

To display an image file or a PIL Image object:

%icat path/to/your/image.jpg

or

from PIL import Image
img = Image.open('path/to/your/image.jpg')
%icat img

You can also resize the image when displaying:

%icat path/to/your/image.jpg -w 300 -h 200

Features

• Display matplotlib plots directly in kitty terminal
• Show PIL Image objects or image files
• Resize images on display
• Seamless integration with IPython workflow

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• matplotlib-backend-kitty for the original implementation
• matplotlib and Pillow for their excellent libraries
• kitty terminal for supporting image protocol

Contact

If you have any questions or feedback, please open an issue on the GitHub repository.