Metadata-Version: 2.1
Name: pdftty
Version: 0.0.2
Summary: A PDF viewer for the terminal
Home-page: https://github.com/kpj/pdftty
License: MIT
Author: kpj
Author-email: kpjkpjkpjkpjkpjkpj@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Pillow (>=8.0.0,<9.0.0)
Requires-Dist: ansicolors (>=1.1.8,<2.0.0)
Requires-Dist: click (>=7.1.2,<8.0.0)
Requires-Dist: numpy (>=1.19.2,<2.0.0)
Requires-Dist: pdf2image (>=1.14.0,<2.0.0)
Requires-Dist: urwid (>=2.1.2,<3.0.0)
Project-URL: Repository, https://github.com/kpj/pdftty
Description-Content-Type: text/markdown

# pdftty

[![PyPI](https://img.shields.io/pypi/v/pdftty.svg?style=flat)](https://pypi.python.org/pypi/pdftty)

A PDF viewer for the terminal.


## Installation

```bash
$ pip install pdftty
```

Make sure to also install [libcaca](https://github.com/cacalabs/libcaca) if you want to use the `CACA` rendering engine.


## Usage

```bash
$ pdftty --help
Usage: pdftty [OPTIONS] <file>

  View PDFs in the terminal.

Options:
  --page INTEGER               Page of PDF to open.
  --render-engine [ANSI|CACA]  Which engine to use to render PDF page as text.
  --help                       Show this message and exit.
```





https://github.com/Belval/pdf2image
https://github.com/djentleman/imgrender/blob/master/imgrender/main.py


## Urwid tips:

* Widget classes: http://urwid.org/manual/widgets.html
* Widget reference: http://urwid.org/reference/widget.html


## poetry tipps

poetry install
poetry shell
\# do tests
python -m pdftty.main test.pdf

