The project aims to build a Python comic viewer (PDF, CBZ, CBR supported) with multiple output options.
PDF reading is available through pdf2image (which depends on poppler)
As of today, the output can be sent to:
- anything pygame supports (i.e.: SDL/OpenGL)
- terminal (via Chafa)
- Inky paper LCD (on RaspberryPI)
The command pip install Oilele should work, with the following options:
- [inky]
- to enable Raspberry GPIO Inky output
- [rar]
- to be able to open cbr archives (requires librar on the O.S.)
To install with all dependencies:
pip install Oilele[rar,inky]
Dependencies can usually installed by your favorite package manager:
- Debian based
- apt install poppler chafa
- Mac
- brew install poppler chafa
Run with (can replace oilala with faccela_vedé or faccela_toccá):
oilala <filename> (opens <filename> via pygame) oilala -A <filename> -v (opens <filename> with Chafa, verbose output) oilala -I <filename> -p 32 (opens <filename> at page 32 on Inky impressions)
The -A option (--ascii) is only available if you have Chafa installed (minimum 1.2 which has the -f option). Alternatives to pdf2image (which depends on poppler) being considered:
- PyMuPDF, it includes support for CBZ and some epub formats. Depends on the MuPDF library
- pikepdf, depends on the QPDF CLI
Please report any problem via the GitHub issues feature, with possible solutions, or even pull requests if appropriate.