Contents Saving, Versions and sync

Keeping your work

Saving, Versions and sync

Check that your words reached the file, look back at an earlier version, and review changes that arrived from another editor, device or person.

Check the save status

Proscenium saves as you write. Look for Saved and the time in the status bar, or press ⌘SCtrl+S to save now. Not saved means the last save failed.

If the app reports that it could not save, read the message before switching plays or moving files. Check that the Plays folder is available and that the disk has space. Words kept in Versions after a failed save are not yet the current file on disk.

Read an earlier version

Proscenium keeps versions of your scripts, documents, character sheets and outline notes as you write: one when a session starts, at most one every five minutes while you keep writing, and one more once you have stopped for two minutes, so each session ends on what you wrote.

  1. Open the document you want to look back through.
  2. Choose Versions… from the script-name menu, or Play › Versions… in the menu bar. Changes opens on your own writing sessions for that document, newest first, under the day you wrote them.
  3. Select a session (You wrote, with its times) to see what you changed in it. Whole sitting shows the session as one change; choose one of the times beside it to see that saved version against the one before.
  4. To go back, choose Restore as It Was Before… for the whole session, or Restore This Version… for the version you picked, and read the confirmation before choosing Restore.

Restoring replaces the current document text. Proscenium keeps the current text as a version first, so you can return to it.

Use ↑ and ↓, or Newer and Older, to step through the list. All, Mine and From Outside choose whose changes are listed, and Which document narrows it to one. A session holds only what you wrote: a change that arrived from somewhere else ends it and is listed on its own.

Versions stay on this computer. The history is stored in Proscenium’s local app data. It does not travel with a copied or synced play folder. Keep a separate backup of work you need to retain.

Read a change on the page

Every change opens On the Page: the text as it now stands, with the words that were cut struck through and the words that were added underlined where they are. A script is shown in your play’s format, with a rule in the left margin beside each changed line. A note, a character sheet or the outline notes are shown on their own page the same way, with their headings, lists and emphasis as you wrote them. Unchanged lines are left out, marked ⋯; where the next change is in another scene, the act and scene are named beside it.

Previous change and Next change, beside the document’s name, go from one marked place to the next and say how many there are.

Choose Line by Line above the list for the change as added and removed lines of the file instead. Your choice is remembered, for every change you open.

Review outside changes

Choose Changes in the toolbar or press ⌘5Ctrl+5 when a file has been changed outside Proscenium: in another app, on another device, or by someone you sent the play to. The change is listed as Changed somewhere else, with the document, where in it and how many words were added and cut. The number on Changes counts what you have not seen yet; it clears as soon as Changes is in front of you, and the changes that were new stay marked New while you are there.

Changes opens on the newest change you have not seen, drawn on the page beside the list; in a narrow window it opens under its row. A run of saves to one file from somewhere else, one after another with nothing of yours between, is one change: choose one of its times to see a single save against the one before, or All of its saves again for the whole run.

A change from somewhere else is already in the file. To undo it, choose Revert… and confirm: the file goes back to how you had it, and what it said is kept in Versions. If the file has changed again since, the change offers Restore as It Was Before… instead, which puts back your text from when the change arrived. Trade edits with a collaborator follows a script out to a reader and back.

While the open script has a change from somewhere else that you have not seen, the toolbar offers Changes in text. Turn it on to see that change marked in the script itself, and use Previous change and Next change to go through it. Nothing it draws is typed into or saved. Afterwards, Show in Script on the change in Changes draws it again.

If a script was changed in two places at once, a banner says so and keeps both versions. Compare the words, then choose Keep this one or Use the other, rather than relying on filenames or modification times.

Write across devices

Proscenium works with the files in your selected folder. iCloud Drive, OneDrive or another sync service is responsible for carrying those files to another device.

Before moving to another machine, let the app save and let the sync service finish. On the other machine, wait for the files to arrive before opening the play; a play that arrives while the Plays screen is open is listed there as it comes in. Avoid editing the same script on two machines at once.

A missing binder row can mean a file has not arrived yet. Check Finder (File Explorer on Windows) and the sync service before treating it as a deletion.

Recover unsaved words

After an interrupted session, a banner says Proscenium closed before your changes were saved. Choose Review… to open Unsaved Changes, read the offered text and compare it with the script. Then choose Recover These Changes, Not Now or Discard.

The current text is kept in Versions before restoration. If you discard the recovery offer, those recovered words remain available in Versions.

If a save problem continues, use Send Feedback and include the error message you saw.

Something missing or wrong on this page? Tell us on GitHub. No account needed to read; a free one to write.