Posts tagged Tools
Printing Notes in Slugline Screenplays

To help you keep your writing organized and your ideas flowing, Slugline uses Fountain’s simple, embedded Notes. Like everything in Slugline, they are just plain text. But they have some superpowers, such as optionally appearing in the Outline Navigator, and, of course, not printing in your final screenplay.

But what if you want them to print? Here are three ways to do that, including a free applet for generating a Notes Report from a Fountain Screenplay.

A Slugline Notes Refresher

Slugline’s Notes are wrapped in [[double brackets]], and are highlighted in sticky-note yellow. They can be in-line with any text in your screenplay outside of the Title Page, or they can be on their own line. You can create Notes by manually typing the brackets (even in an app other than Slugline!), but there are some shortcuts that make managing Notes even easier.

  • If you type the two open brackets [[, Slugline automatically creates the closing pair ]] and places the insertion point inside.
  • Press ⌘Y to create a new, empty Note.
  • With the insertion point inside a Note, press ⌘Y to delete the brackets, which converts the Note to normal text.
  • If you’re typing at the end of a Note and you press Return, Slugline will move the insertion point to just after the Note.
  • With the Outline Navigator visible (⌘3), you can show/hide Notes in the Outline by pressing ⌘7.

You can use these notes however you like. They are meant just for you, the writer, so they don’t show up in Preview or Print — just like ScriptNotes in Final Draft, for example.

Still, it might be useful to print these kinds of notes every once in a while, so here are some methods for doing just that.

Synopses: Like Notes, But Optionally Printable

Notes don’t print, but there's something similar to a Note that can optionally be printed: A Synopsis element. Synopses join Sections in forming Slugline’s powerful built-in outlining.

  • Sections start with pound signs, and are hierarchical. A Section that starts with ## is considered to be nested within a Section that starts with #.
  • Synopses start with an equals sign =.

Both Sections and Synopses are invisible in print by default, but Slugline has a special option to print them if you like. This setting is saved with the screenplay itself.

Typically, a Synopses follows a Section element, like this:

But you can also place a Synopsis element anywhere in a scene:

If you get in the habit of making your Notes this way, with Synopsis elements, then you can toggle their printability using File → Document Settings → Include Outline Elements.

Just remember that including these elements will affect your page count.

Generate a Notes Report

Final Draft doesn’t support printing its notes inline, but it does allow you to generate a “Notes Report.” Through the power of plain text, it’s easy to do the same with Slugline.

Since Notes contain double brackets, it’s easy to filter for them. I created a simple “droplet” application that does just this, and saves the results to a plain text file. This is basically a bare-bones app wrapped around the Unix grep command, if you’re curious.

 
 

The only downside is that there are no page or scene numbers in the report. Still, it can be very handy to have all your notes, and just your notes, in a separate, printable document.

This app takes the Screenplay on the left and generates the Notes Report on the right.

Printing Notes Inline

Still, the dream of many is to print Slugline’s Notes right in place. And again, thanks to the power of text, that’s a pretty straightforward thing.

Remember that the [[double brackets]] are the trigger that Slugline uses to highlight your Notes, and to ignore them at printing time. Since these brackets are just text in your document, and since it’s unlikely that your screenplay has sets of double brackets that aren’t related to Notes, all we have to do is search and replace them with something else — ideally something easy to search and replace back into brackets!

You could do this with Slugline’s built-in Find and Replace (under Edit → Find), or you could use a free and handy app called MassReplaceIt from HexMonkey Software.

MassReplaceIt lets you batch search/replace multiple matches in multiple files at once. It writes its changes back to the input file(s), so here’s a big, fat warning:

Always make a copy of your screenplay before you try this!

Here’s how I have MassReplaceIt set up:

I saved these settings in MassReplaceIt as Print Notes and Hide Notes, so that I could recall them easily. Note that for them to work properly, you must turn off Search whole words only under Options.

Run Print Notes on the copy of your screenplay, and here’s what you get:

Before

After

All the Notes become regular, printable text. The double asterisks make them bold, so they pop off the page. The asterisks, of course, don’t print:

Print preview of printable notes

But again, notice that rendering the notes did affect the pagination of our screenplay.

In case you do some important editing in this visible-Notes version of the screenplay, you can always use Hide Notes to put the double brackets back.

Avoiding an Obvious Amadeus Joke

Are any of these solutions the dream-come-true of printing an annotated screenplay? Maybe not. It’s a hard problem to solve elegantly, which is probably why no one has done it yet. But while we think about ways to make this even better, I hope this article serves as a reminder that when you write your screenplays in an open, universally-compatible text format like Fountain, there’s no end to the powerful workflows you might create for yourself.

Extract a Pretty Outline from a Fountain Screenplay

Fountain screenplay in Slugline on the left. Outline-only document in Byword on the right. All powered by nothing but text.

Matthew McCowan, creator of the Shotlists from Fountain tool, is at it again. Responding within hours to my request, he whipped up Outline From Fountain, a utility for creating Markdown-formatted outline documents from a Fountain file containing Sections and Synopses.

The Automator app takes a Fountain file and extracts only the Sections and Synopses, reformatting them into a heirarchical bulleted list in Markdown format. You can then use a Markdown app, such as Byword or the awesome new Marked 2, to view and export your outline with any styling you desire.

Once again, Matthew has generously made his work available to the Fountain community:

We're thrilled to see the Fountain ecosystem expanding with simple but powerful tools like this. Follow us on Twitter and let us know what kind of tools you'd like to see for working with Fountain files!

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