Skip to content
screenjson

screenjson-cli

Export ScreenJSON to FDX

Emit a valid Final Draft .fdx file from a ScreenJSON document.

Last updated January 2026

Command

screenjson export -i screenplay.json -f fdx -o screenplay.fdx

Reads screenplay.json, writes a Final Draft file that Final Draft itself will happily open.

Auto-detect output format

The CLI can infer the output format from the filename:

screenjson export -i screenplay.json -o screenplay.fdx

Primary language

If your document is multi-language, choose which language the emitted FDX uses:

screenjson export -i screenplay.json -f fdx --lang fr -o script-fr.fdx

Decrypt encrypted content on the way out

screenjson export -i encrypted.json -f fdx --decrypt "SharedSecret123" -o script.fdx

Things to know

  • Every ScreenJSON element maps onto a Final Draft paragraph type: action → Action, character → Character, dialogue → Dialogue, parenthetical → Parenthetical, shot → Shot, transition → Transition, general → General.
  • Character cues honour the display field when present (e.g. MARA (V.O.)); otherwise the canonical character name is used.
  • Dual dialogue is preserved via Final Draft’s DualDialogue container.

Next