Skip to content
screenjson

screenjson-cli

Convert FadeIn to ScreenJSON

Convert a FadeIn .fadein archive (OSF XML inside a ZIP) to ScreenJSON.

Last updated January 2026

What you need

  • A .fadein file. (FadeIn files are ZIP archives containing document.xml in the OSF format; the CLI unpacks this for you.)
  • screenjson on your PATH, or Docker.

Convert

screenjson convert -i screenplay.fadein -o screenplay.json

Force the format

Useful if the file was renamed without its extension:

screenjson convert -i script.zip -f fadein -o screenplay.json

In Docker

docker run --rm -v "$PWD:/data" screenjson/cli \
  convert -i /data/screenplay.fadein -o /data/screenplay.json

Things to know

  • FadeIn’s character list is carried through to ScreenJSON’s characters array with stable UUIDs.
  • Revision markers and colour status from FadeIn are preserved in document.layout.status and per-element revisions.
  • Notes with colour markers are preserved on the element they were anchored to.

Next