Skip to content

quickstart.md

Latest commit

 

History

History
123 lines (88 loc) · 2.63 KB

quickstart.md

File metadata and controls

123 lines (88 loc) · 2.63 KB
Raw

Quick Start

Install

npx -y @deckflow/deckrender@latest deck.pptx

Or install it on your PATH:

npm install -g @deckflow/deckrender
deckrender --version

Requires Node.js 18 or newer. No credentials needed to start.

Render a deck

$ deckrender presentation.pptx
presentation
presentation/
├── 001.png
├── 002.png
└── 003.png

With no -o, DeckRender writes a directory named after the input.

Pick a format

The output extension is enough:

deckrender deck.pptx -o deck.pdf
deckrender deck.pptx -o deck.mp4
deckrender deck.pptx -o slide.png

Or say it explicitly:

deckrender deck.pptx --format pdf -o out/report.pdf

Control size and pages

deckrender report.pdf --pages 1-5 --width 2560 -o pages/
deckrender report.pdf --page 1 --width 640 -o thumb.png

--pages filters what gets downloaded — the backend still renders the whole document, so this saves bandwidth, not cost.

Other inputs

deckrender page.html -o shot.png
deckrender https://example.com -o shot.png
cat page.html | deckrender - --from html -o shot.png
deckrender notes.md -o notes.png

Stdin has no filename to infer from, so --from is required there.

Use a profile

Profiles are named bundles of flags:

deckrender deck.pptx --profile web -o frames/

web means --format image --image-format webp --width 1920 --quality medium. See profiles.md.

Script it

$ deckrender deck.pptx --json
{
  "ok": true,
  "input": "deck.pptx",
  "format": "image",
  "engine": "cloud",
  "route": ["convertor.ppt2image"],
  "pages": 3,
  "outputs": [
    { "page": 1, "file": "deck/001.png", "width": 1920, "height": 1080, "bytes": 184320 }
  ],
  "durationMs": 8123
}

stdout carries only the JSON; progress and warnings go to stderr, so pipelines stay clean:

FIRST=$(deckrender deck.pptx --json | jq -r '.outputs[0].file')

Branch on the exit code: 0 success, 1 render failure, 2 usage, 3 auth. See errors.md.

Log in (optional)

deckrender auth login
deckrender auth status

The token is stored in ~/.deckflow/credentials and shared with every DeckFlow CLI — DeckHTML included. If your machine already has DECKHTML_API_KEY set, or you have run deckops login, DeckRender already uses it.

deckrender config list    # shows every value and where it came from

Next