pitch2pdf CLI

Name: pitch2pdf
Author: pitch2pdf

Convert presentations to PDF from your terminal. Scriptable, pipeable, and designed for AI agents.

Install

npx pitch2pdf-cli https://pitch.com/v/your-deck

Or install globally:

npm install -g pitch2pdf-cli

Usage

pitch2pdf <url> [options]

Options:
  --email <email>        Email for protected presentations
  --password <password>  Password for protected presentations
  -o, --output <path>    Output file path (use - for stdout)
  --json                 Output NDJSON events to stdout
  --no-progress          Suppress progress output
  --api-url <url>        Custom API URL
  -V, --version          Show version
  -h, --help             Show help

Examples

Convert a Pitch presentation:

pitch2pdf https://pitch.com/v/my-deck

DocSend with email authentication:

pitch2pdf https://docsend.com/view/abc --email you@company.com

Save to a specific file:

pitch2pdf https://docs.google.com/presentation/d/1abc/pub -o slides.pdf

Pipe to another command:

pitch2pdf https://canva.com/design/abc/token/view -o - | wc -c

JSON output for scripting:

pitch2pdf https://pitch.com/v/deck --json
# Each line is a JSON object:
# {"status":"processing","stage":"loading","jobId":"abc123"}
# {"status":"processing","stage":"capturing","currentSlide":1,"totalSlides":10}
# {"status":"completed","jobId":"abc123","numSlides":10,...}
# {"event":"saved","path":"deck.pdf","size":2451623}

Exit Codes

Code	Meaning
0	Success
1	General error (invalid URL, server error)
2	Network error
3	Authentication required or failed
4	Bot detection blocked the request
5	Timeout
6	Connection dropped during conversion
7	PDF download failed
130	Interrupted (Ctrl+C)

Environment Variables

Variable	Description
`PITCH2PDF_API_URL`	Override the default API URL
`PITCH2PDF_EMAIL`	Email for protected presentations (avoids passing via CLI arg)
`PITCH2PDF_PASSWORD`	Password for protected presentations (avoids exposure in process list)

Free Tier

The CLI uses the free tier: first 10 slides at full resolution, remaining slides as preview thumbnails. For full deck with OCR-powered searchable text, upgrade at pitch2pdf.com.