wsl-html-pdf
v1.0.0
Published
Cross-platform CLI tool to convert HTML files or URLs to PDF with dynamic sizing.
Maintainers
Readme
HTML to PDF Converter
A simple and efficient CLI tool to convert HTML files or URLs into high-quality PDFs with dynamic sizing. This tool is particularly useful for converting Gemini Canvas-style HTML or any complex web content that requires custom dimensions.
Features
- Dynamic Sizing: Automatically calculates content dimensions to prevent clipping.
- Cross-Platform: Works on Windows, Linux, and macOS (including WSL2).
- URL & Local File Support: Convert online content or local HTML files easily.
- Minimal Configuration: Sensible defaults for high-quality output.
Installation
Local Installation
npm installGlobal Installation (Use everywhere)
To use the wsl-html-pdf command from any folder on your machine:
npm install -g .Usage
Local Usage
node index.js <URL, FilePath, or DirectoryPath>Global Usage (if installed globally)
wsl-html-pdf <URL, FilePath, or DirectoryPath>Examples
Convert a single local file:
wsl-html-pdf ./my-report.htmlConvert an entire directory (Batch Conversion):
wsl-html-pdf ./canvas-exports/It will scan for all .html files in the folder and create a PDF next to each one.
Convert a URL:
wsl-html-pdf https://example.comPrerequisites for WSL2 Users
If you are running this on WSL2, you may need to install the following dependencies. Note that for Ubuntu 24.04+, some packages use the t64 suffix (e.g., libasound2t64 instead of libasound2).
sudo apt update && sudo apt install -y libnss3 libatk1.0-0t64 libatk-bridge2.0-0t64 libcups2t64 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2t64If you are on an older version of Ubuntu, replace the t64 packages with their standard names (e.g., libasound2).
License
Unlicensed
