Comparing Revisions

Comparing Revisions

When a new draft arrives, you need to know exactly what changed. SceneItAll lets you compare any two revisions side by side, highlighting additions, removals, and modifications.

Prerequisites

  • You need at least two revisions of a script uploaded to the same episode.

Entering Compare Mode

  1. In the script viewer, click the Compare Revisions button in the script header.
  2. A dropdown appears listing all available revisions. Select the revision you want to compare against.
  3. The viewer switches to compare mode, showing both revisions.

Comparing two non-current revisions

The left pane is always the revision you are currently viewing. The right pane is the revision you pick from the compare dropdown (every other active revision for that episode, newest first).

To compare, for example, revision V3 against V5: open V3 from the version menu in the script footer, enter compare mode, then choose V5 on the right. You cannot compare a revision to itself — it never appears in the right-hand list, and the API returns 422 if the same script ID is sent twice.

Archived revisions are not listed in compare mode; restore them from archive first if you need to diff them.

View Modes

Compare mode offers two ways to view differences:

Full Script View

Displays both revisions as continuous scrollable text, with differences highlighted inline:

  • Left side background — Tinted with the colour of the revision you’re currently viewing (e.g. Blue if the left pane is the Blue revision).
  • Right side background — Tinted with the colour of the revision you selected from the compare dropdown.
  • No highlight — Unchanged content.

Highlight intensity uses a soft 35% alpha so the underlying text stays legible. White revisions render as a faint neutral grey so the diff boundary is still visible against the page.

Use the “Show Changes Only” checkbox to hide unchanged content and focus on what’s different.

Scene View

Displays a collapsible list of scenes from both revisions. Each scene row shows:

  • Scene number.
  • Location (INT/EXT, location name).
  • Time of day.
  • Page length.

Click a scene row to expand it and see the detailed content differences. Scenes that were added appear with a green-tinted background.

At the bottom of the compare view, a stats bar summarizes the differences:

  • Added (green) — Number of new scenes.
  • Removed (red) — Number of deleted scenes.
  • Changed (orange) — Number of modified scenes.

Switching Between Views

Use the segmented control in the compare header to toggle between “Full Script” and “Scene View” at any time.

Exiting Compare Mode

Click the “Close Revisions” button in the compare header to return to the normal script viewer.

Tips

  • Use Scene View for a quick overview of what changed, then switch to Full Script to read the actual text differences.
  • The “Show Changes Only” filter is useful for large scripts where only a few scenes were modified.
  • Compare mode preserves your navigation position — you can switch back and forth between views without losing your place.