README.md

athenapdf

The CLI component of athenapdf.

A simple CLI tool to convert HTML to PDF from a local file or a URL to a web page using Electron (Chromium).

It can be used anywhere with Docker installed, even in a headless environment (i.e. no display server).

Alternative / drop-in replacement for wkhtmltopdf
Uses the latest, stable release of Chromium, and its Blink web rendering engine:
- Supports the latest HTML5, and CSS3
- Supports JavaScript, and AJAX
- Supports internal linking / page anchors within a PDF
- More: https://www.chromestatus.com/features
Supports local HTML files, and remote URLs
Supports writing to standard output: you can take advantage of UNIX piping / redirects
Supports rendering in:
- Landscape or portrait
- A3, A4, A5, Legal, Letter, and Tabloid page size
Adjustable PDF generation delay
Adjustable, built-in timeout mechanism
Adjustable cache control
Adjustable browser zoom settings
Adjustable margin sizes
Automatically falls back to screen stylesheets if no print stylesheet is defined
Aggressive mode: declutter web pages, and improves readability
Bypass paywalls for most digital publications with a single -B flag (experimental feature)
Dockerized:
- Easy to set up, distribute, and run
- Runs in headless mode (the display server is handled for you)
- Out-of-the-box support for a broad range of foreign characters
Actively maintained, and production tested