Skip to content

Fountain autocomplete, syntax highlighting, and export to PDF; modifications for Indic Languages. Signficant deviations from standard screenplay script output

License

Notifications You must be signed in to change notification settings

sivarajd/betterfountain-indic

Repository files navigation

NOTE on Indic Modifications to Better Fountain:

Standard fountain markup works pretty well for Indian languages. However, as the glyphs are always of variable width, the fonts and alignments do not work out of the box. Besides the standard output format requires minor changes to address local sensibilities. This fork tries to do minimal changes to the fountain markup and Better Fountain to get it working for Indian languages.

As most of these changes won't be applicable for Better Fountain main tree, I am not planning to send a pull request. Let me know if it is worth generalising.

Changes in this initial version:

  • Font size changes for title, scene heading; new Subtitle tag.
  • Move title to the left instead of center
  • Display scene number in the outline
  • Parameter adjustments in print.js
  • Add p in front of page number instead of . after
  • Underline the character names
  • Minor line height alingments.

To develop this version:

  • Clone the repository
  • Open the folder in Visual Studio Code
  • Run npm install
  • On the debug window click Run Extension
  • You will need node to get it running

To run this version:

  • Download the vsix package file.
  • Run the following to install the package. $ code -install-extension betterfountain-indic-1.8.11-m1.vsix

Original README follows:

This is an extension for Visual Studio Code which allows you to write screenplays using the fountain syntax quickly and efficiently. (If you're already confused click here).

Unlike other screenwriting software (such as Final Draft) BetterFountain focuses on removing friction between you and the text - there's no page breaks, no large unintuitive menus and overlapping windows, no delays when you press "Enter" after having written some dialogue, no slow loading documents, none of that. Just text and a handfull of unintruding features which remove even more friction between the story in your head and a finished screenplay.

And because it's an extension for vscode, you get access to some incredibly advanced features, such as Real-time collaboration with other screenwriters - Better Fountain is the only free and open-source screenwriting tool which allows you to use such features.

Install it here

Sponsor on GitHub ❤

Discuss on Discord

Screenshot of BetterFountain in dark mode https://piersdeseilligny.com/work/software/betterfountain/

Features

  • Full syntax highlighting (even for stuff like lyrics!)
  • Smart autocomplete for recurring characters and scenes, as well as title page keys.
  • Industry-standard PDF generation
    • Includes scenes and sections as PDF bookmarks, for easy navigation in your reader of choice
    • Possible to highlight any specified characters in the PDF
  • Full screenplay outline
    • Includes sections, scenes, notes, and synopses (the visiblity of each type of item being easily and quickly toggleable)
  • "Folding" scenes and sections
  • Live preview of the formatted screenplay
  • Advanced interactive statistics about your screenplay
  • Custom font support (Add "Font:" at the top of your .fountain screenplay, with the other title page keys, followed by the name of a font installed on your system)
  • Approximation of a screenplay's duration (in the status bar)
  • Other cool stuff
    • Go straight to writing dialog after a parenthetical by pressing enter, while the cursor is still inside it
    • Jump to scenes/sections in the .fountain and live preview when clicking on the outline
    • Scroll-sync preview, with active line indication/selection

Screenshot of Statistics pages

Why?

Writing with fountain lets you focus on the essential. With the addition of autocomplete and syntax highlighting, you have the ultimate clutter-free ultra-fast solution for writing screenplays. And because it's an extension for vscode, it's free and cross-platform, and you get lots of other cool features such as integrated source control and near-infinite extensibility.

Usage

Just open a .fountain file in Visual Studio Code, and everything should work as expected. You can open the live preview and export to PDF by opening the command palette (Ctrl+Shift+P or F1) and searching for "Fountain".

You can modify various options related to PDF Export in the settings, under "Fountain PDF Export".

And to get an approximate duration of your screenplay, just look at your status bar, in the bottom right corner.

TODO

Here are some features I would like to add, but don't really have time to right now, in an approximate order of difficulty/priority:

  • Fountain cheat sheet panel

  • More statistics (a 'Scenes' section, and per-character reports)

  • PDF Export panel, with more advanced features presented in a more user-friendly way

  • Optionally leaving synopses visible when folding

  • Built-in screenplay templates (such as Blake Snyder's beat sheet)

  • Import screenplays from PDF files

  • Some sort of system that would allow the storage of character information alongside the script

I will probably add these features when I have time, but if you're up for the challenge I'm more than happy to accept your pull requests.

Thanks / Third-party licenses

Why visual studio code? I thought this was about screenwriting?

Screenwriting is just about writing text, and Visual Studio Code is a great text editor. You don't need to know anything about programming to use it. Here's what you need to do to get started using BetterFountain:

About

Fountain autocomplete, syntax highlighting, and export to PDF; modifications for Indic Languages. Signficant deviations from standard screenplay script output

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published