Editing Fountain Files with Storyist for iOS

Fountain is a plain text markup syntax for screenplays developed by John August, Nima Yousefi, and Stu Maschwitz.

The great thing about Fountain files is that they are just plain text. This means:

  • You can edit them with any plain text editor.
  • You can compare them with any plain text comparison tool.
  • You can archive them using any version control system.

The only drawbacks are that there is a special syntax to learn, and, with a plain text editor, you don't write in standard script format.

That's where Storyist can help.

When Storyist for iOS opens a Fountain file, it formats the script so you can edit it using the built-in WYSIWYG screenplay editor. Changing screenplay elements is as simple as tapping the element in the extended keyboard. Or, if you have a Bluetooth keyboard attached, you can use the familiar tab and return shortcuts to change elements.

Fountain file in the Storyist editor
Fountain file in the Storyist editor

The file itself is stored as plain text using the Fountain markup syntax, so when you sync the file, that's what is transferred--plain text.

To edit a Fountain file:

  1. Copy or sync a text file with the extension of ".fountain" to the top-level "My Projects" view in Storyist for iOS.
  2. Tap the file to open it.
  3. Start writing.

Note: You can also import and export Fountain files to/from Storyist projects as you would any other FDX, RTF, or plain text file. See the Storyist Users Guide (available for download at the support page) for more information on how to do that.

Plays Well with Others

Storyist for iOS works great with other plain text apps like iA Writer or TextTastic.

To send a Fountain file to Storyist from another app:

  1. Open the file in a plain text editor that supports the "Open In" menu.
  2. Select Storyist from the list of options that appears.

Opening a Fountain file in Storyist from iA Writer
Opening a Fountain file in Storyist from iA Writer

Note: Fountain files must have the .fountain extension for Storyist to recognize them as Fountain files.

You can also send a Fountain file to any app that advertises that it can open plain text files.

To send a Fountain file from Storyist to another app:

  1. Open Storyist and navigate to the folder containing the file you want to share.
  2. Tap the Edit button in the toolbar.
  3. Select the file you want to share.
  4. Tap the Export (Share) icon in the toolbar.
  5. Tap Send to App.
  6. Choose the format you want to send the file in.
  7. Choose the app you want to send the file to.

Sending a Fountain file to another app
Sending a Fountain file to another app

You can also export the script in any of the formats that Storyist supports. This means you can use Storyist for iOS to:

  • Convert from Fountain to FDX.
  • Convert from FDX to Fountain
  • Convert from Fountain to PDF.
  • Convert from FDX to PDF.