PPTX / DOCX → HTML converter (proprietary). One package; Free vs Licensed is selected by a signed .lic at runtime, or use Cloud for remote conversion.
| Mode | How | Behavior |
|---|---|---|
| auto (default) | Omit --mode, or --mode auto |
Valid local .lic → same as license; otherwise free |
| free | --mode free |
Force Free local (Community degradations) |
| license | --mode license (requires valid .lic) |
Full local engine (alias: licensed) |
| cloud | --mode cloud |
Remote Licensed conversion via DeckFlow Cloud |
npm install @deckflow/deck2html
Do not omit optional dependencies (--omit=optional / --no-optional); the native binary lives in a platform package such as @deckflow/deck2html-darwin-arm64.
# Free local (Community degradations when no valid license) npx deck2html deck.pptx -o ./out # Licensed local npx deck2html deck.pptx -o ./out --license ~/.deckflow/deck2html.lic # defaults also accept ~/.deckflow/deckuse.lic (first valid wins) # or: export DECK2HTML_LICENSE=~/.deckflow/deck2html.lic # Force Free even with a valid license npx deck2html deck.pptx -o ./out --mode free # Require Licensed local npx deck2html deck.pptx -o ./out --mode license # Cloud (full fidelity via remote Licensed worker) npx deck2html deck.pptx -o ./out --mode cloud # Auth for higher cloud quota (shares ~/.deckflow/credentials with html2deck) npx deck2html auth login export DECK2HTML_API_KEY=…
const { getBinaryPath } = require('@deckflow/deck2html'); const { spawnSync } = require('child_process'); spawnSync(getBinaryPath(), ['deck.pptx', '-o', './out'], { stdio: 'inherit' });
| Flag / env | Meaning |
|---|---|
--license <path> |
Optional .lic → Licensed when valid (unless --mode free) |
DECK2HTML_LICENSE |
License path env |
--mode auto|free|license|cloud |
Default auto from certificate. cloud = remote convert; free forces Free; license requires a valid .lic (alias: licensed) |
DECK2HTML_API_KEY |
Cloud API key (optional; guest mode otherwise) |
DECK2HTML_CONFIG_DIR |
Credentials dir (default ~/.deckflow) |
--check-license |
JSON probe; exit 0 if valid (machineBound / machineId when bound) |
fingerprint |
Print 64-char hex machine id for optional single-machine .lic binding |
Machine binding is optional at issue time (IssueLicense --machine-id <hex>). Portable licenses omit it.
| Package | OS | Arch |
|---|---|---|
@deckflow/deck2html-darwin-arm64 |
macOS | arm64 |
@deckflow/deck2html-darwin-x64 |
macOS | x64 |
@deckflow/deck2html-linux-x64 |
Linux | x64 |
@deckflow/deck2html-win32-x64 |
Windows | x64 |
Proprietary. See LICENSE. Free mode may be used under the limited terms in that file; full local features require a DeckFlow-issued .lic; Cloud mode is governed by DeckFlow Cloud terms.