MarginalHacks.com DaveSource.com
scurvy
 

What is it?

scurvy comes from "screen/script" and "vi/vim"

It's a tool that lets you easily write screenplays or scripts in a simple text format, then scurvy will output them in the proper screenplay format.

Scurvy can also import some RTF and Final Draft formats, as well as outputting/converting to a variety of formats as well.

Finally, I've included some vim syntax files to do coloring of the scurvy input and formal screenplay format.

License:

This software is essentially free, but please read my payment spiel
Please read the full license

Example:

The following input: 

YM:=Young Man
EXT. SIDEWALK - DAY
	YOUNG MAN is walking down the street.
	He passes SATAN, a snappily dressed man with horns.

Satan:	Psssst!!!  Hey buddy!
YM:	Who me?
Satan:	Riiiight!  Would you like to buy an "O?"
YM:	(confused)	An O?
Satan:	Shh...  It'll cost you just a nickel!
YM:	(confused, annoyed)	A nickel?
Satan:	Shh...  Riiight!
		Dissolve

Can create the following output: 

          EXT. SIDEWALK - DAY
          
          YOUNG MAN is walking down the street.
          
          He passes SATAN, a snappily dressed man with horns.
          
                              SATAN
                    Psssst!!!  Hey buddy!
          
                              YOUNG MAN
                    Who me?
          
                              SATAN
                    Riiiight!  Would you like to buy 
                    an "O?"
          
                              YOUNG MAN
                         (confused)
                    An O?
          
                              SATAN
                    Shh...  It'll cost you just a 
                    nickel!
          
                              YOUNG MAN
                         (confused, annoyed)
                    A nickel?
          
                              SATAN
                    Shh...  Riiight!
                                                  DISSOLVE

Download:

There's a single perl script and a man page (though the perl script has POD documentation)

If you're using the vim editor then I have some syntax files that will do coloring of both scurvy input files (provided they end in .scr) and the basic screenplay output (provided it ends in .screen).

To install these, put them in your home .vim/syntax or in your global vim syntax directory (something like /usr/share/vim/syntax):

.vim/syntax/scurvy.vim
.vim/syntax/scurvyScript.vim

Then set the filetypes in vim. You can add this to filetype.vim in your home .vim or the global .vim installation, or else to your local .vimrc: 

" scurvy from MarginalHacks.com
au BufNewFile,BufRead *.scr    setfiletype scurvy
au BufNewFile,BufRead *.script setfiletype scurvyScript

Since scurvy relies on tabs and some people use 'expandtab' it's recommended you also add this to your .vimrc: 

" scurvy needs tabs
au FileType scurvy set noexpandtab
au FileType scurvyScript set noexpandtab
(Thanks Aaron Fay for noticing this!)

Documentation?

Read the man page or POD docs, and see the usage:

% scurvy -h

Requires:

  1. Perl, which kicks ass

Install

It's just a perl script. No install required.

Revision History:

See the CHANGELOG

Bugs:

It can't output a good screenplay unless you write one first.

The RTF and Final Draft input formats are new and may have problems with variations on those formats - you might need to play with the -in_indent option to properly parse formats that have left margins.

Many examples are in the man page, don't be afraid to read it.

Freshmeat?

You bet.