@deckflow/deck2html

@deckflow/deck2html

PPTX / DOCX → HTML converter (proprietary). One package; Free vs Licensed is selected by a signed .lic at runtime, or use Cloud for remote conversion.

Product modes

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

Install

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.

Usage

# 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 when the .lic is issued (via @deckflow/deck-secure). Portable licenses omit it.

Platform packages

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

License

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.

Links

• npm: https://www.npmjs.com/package/@deckflow/deck2html
• Issues: https://github.com/deckflow/deck2html/issues