Usage

Paper-Muncher is a document rendering tool that converts web documents into high-quality PDFs or rasterized images using the Vaev layout engine. It supports HTTP and local I/O, and CSS units for layout configuration.

Commands

print

paper-muncher --unsecure print <input> -o <output> [options]

Renders a web document to a print-ready file (typically PDF).

Options:

• --scale <scale>: Logical resolution (default: 1x)
• --density <density>: Output pixel density (default: 1x)
• --paper <name>: Paper stock (default: A4)
• --orientation <orientation>: portrait or landscape (default: portrait)
• -w,--width <length>: Override paper width (e.g. 210mm, 8.5in)
• -h,--height <length>: Override paper height
• -f,--format <uti>: Output format (default: public.pdf)
• -o,--output <output>: Output file or URL (default: stdout)
• --unsecure: Allows paper-muncher to access local files and the network. If omitted it will only get access to stdin and stdout.
• --timeout <duration>: Adds a timeout to the document generation, when reached exits with a failure code.
• -v,--verbose: Makes paper-muncher be more talkative, it might yap about how its day's going

Examples:

paper-muncher --unsecure print article.html -o out.pdf
paper-muncher --unsecure print article.html -o out.pdf --paper Letter --orientation landscape
paper-muncher --unsecure print article.html -o https://example.com/doc.pdf --output-mime application/pdf

render

paper-muncher --unsecure render <input> -o <output> [options]

Renders a web document to a raster image (BMP, PNG, etc.).

Options:

• --scale <scale>: CSS resolution (default: 96dpi)
• --density <density>: Pixel density (default: 96dpi)
• -w,--width <length>: Viewport width (default: 800px)
• -h,--height <length>: Viewport height (default: 600px)
• -f,--format <uti>: Output format (default: public.bmp)
• --wireframe: Show wireframe overlay of the layout
• -o,--output <output>: Output file or URL (default: stdout)
• --unsecure: Allows paper-muncher to access local files and the network. If omitted it will only get access to stdin and stdout.
• --timeout <duration>: Adds a timeout to the document generation, when reached exits with a failure code.
• -v,--verbose: Makes paper-muncher be more talkative, it might yap about how its day's going

Examples:

paper-muncher --unsecure render page.html -o out.bmp
paper-muncher --unsecure render page.html -o out.png --width 1024px --height 768px --density 192dpi
paper-muncher --unsecure render page.html -o out.png --wireframe

NOTE: <scale>, <density>, <orientation>, <length>, <duration> all use CSS unit synthax