Metadata-Version: 2.1
Name: pixcat
Version: 0.1.0
Summary: Display images on a kitty terminal with optional resizing.
Home-page: https://github.com/mirukan/pixcat
Author: miruka
Author-email: miruka@disroot.org
License: LGPLv3
Keywords: kitty api cli terminal print display resize scale image picture graphic icat
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Environment :: Console
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Classifier: Topic :: Terminals
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
Requires-Python: >=3.6, <4
Description-Content-Type: text/markdown
Requires-Dist: blessed
Requires-Dist: docopt
Requires-Dist: pillow
Requires-Dist: dataclasses; python_version < "3.7"

# pixcat

[![PyPI downloads](http://pepy.tech/badge/pixcat)](
    http://pepy.tech/project/pixcat)
[![PyPI version](https://img.shields.io/pypi/v/pixcat.svg)](
    https://pypi.org/projects/pixcat)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/pixcat.svg)](
    https://pypi.python.org/pypi/pixcat)

**WORK IN PROGRESS**

Display images on a [kitty](https://sw.kovidgoyal.net/kitty/) terminal
with optional custom/thumbnail/fit-to-screen resizing.  
Developped with the goal to be a more powerful alternative to `kitty icat`,
while also providing an usable Python 3.6+ API.

## Usage

CLI:

```sh
    pixcat --help
```

Python library (no documentation yet):

```python3
    import pixcat
    ...
```

## Installation

Requires Python 3.6+, tested on GNU/Linux only.

```sh
    pip3 install --user --upgrade pixcat
```


