Skip to content
screenjson

screenjson-cli

Decrypt a ScreenJSON document

Recover plain text from an encrypted ScreenJSON document using the shared secret.

Last updated January 2026

Command

screenjson decrypt -i cipher.json -o plain.json --key "AtLeast10Chars!"

From an environment variable

export SCREENJSON_ENCRYPT_KEY="AtLeast10Chars!"
screenjson decrypt -i cipher.json -o plain.json

Decrypt as you export

Skip the intermediate — decrypt on the way out to a screenplay format:

screenjson export -i cipher.json -f fdx --decrypt "AtLeast10Chars!" -o script.fdx

Things to know

  • Decryption is strict: an incorrect key fails with a clear error, rather than producing junk output.
  • analysis is never encrypted, so decryption doesn’t touch it.
  • If any element declared its own encrypt overrides (per-element encryption), the CLI handles that transparently.

Next