Shotlists from Fountain Screenplays

Slugline is all about the writing experience. But the Fountain screenplay format is about more than that. Plain text is great for writing, but it's also a perfect archive format. And since it's compatible with anything, it enables some cool production workflows.

We even mentioned this in the Slugline documentation. From Help → Extending Fountain:

Fountain's Notes [[like this one]] can contain any text you like, including multiple paragraphs. Since Notes don't print, you can use them to store all kinds of useful information, such as notes on revisions, character bios, or even text that can have special, nerdy powers.

As an example of how you could build a workflow around Notes, you could embed a shotlist right into your script. It might look something like this:

BOURNE running in the sun.  [[SHOT: WIDE of BOURNE running on the beach.]]  A punishing pace along the sand.  Moving strong.  Effortless.  Deep into it.  Focused.  [[SHOT: CU BOURNE running, his face intense.]]  The stunning conjunction of sun and scenery are lost on him.

It would be a simple matter (for a nerd) to hack up a script that would spit out only the Notes that start with "SHOT:", grouped by Scene Headings. Instant shotlist from an annotated screenplay!

A "simple matter" that's well beyond me, of course, so I pulled a lazyweb (in the best tradition of my involvement with Fountain) and asked folks on Twitter for help.

In short order, Matthew McCowan responded with a beautiful little Perl script that did exactly what I had in mind. What it does is take any Notes that begin with Shot: and turn them into numbered lists. Scene Headings are also included for context. So this Fountain:

...becomes this plain text:

## INT. SAN FRANCISCO APARTMENT - DAY

1. Exterior establishing, Scott's SF apartment.
2. Wide, Scott's apartment. Scott is painting at an easel.
3. OTS to painting.

## INT. HALLWAY, SCOTT'S APARTMENT BUILDING - A MOMENT LATER

1. Scott at the mailbox, opening, sifting through.

...which renders like this in Markdown:

INT. SAN FRANCISCO APARTMENT - DAY

  1. Exterior establishing, Scott's SF apartment.
  2. Wide, Scott's apartment. Scott is painting at an easel.
  3. OTS to painting.

INT. HALLWAY, SCOTT'S APARTMENT BUILDING - A MOMENT LATER

  1. Scott at the mailbox, opening, sifting through.

You can use a Markdown-aware text app such as Byword or Marked to export or print a clean, attractive shotlist, automatically generated from your screenplay.

Matthew has given me permission to share his work here. Please feel free to download and use these:

This is just the beginning of what's possible with simple, open, plain-text formats like Fountain, and we hope to see many more tools like this. Fountain is an ecosystem, and as the number of apps and services that support it grows, the fundamental design premise of Slugline is strengthened. We get to focus on providing you with the simplest, best writing experience possible, without needing to clutter the app with every imaginable feature. Your Fountain screenplay is infinitely compatible, portable, and future-proof; and easily becomes the basis of any variety of custom workflows.

Stu MaschwitzHow to, Tools