Trelby Manual Version 2.2 Trelby developers Copyright © 2012 Trelby developers
Table of Contents
1. Introduction 1.1. Basic concepts 2. Basic usage 2.1. Main window 2.2. Basic editing 2.2.1. Moving around 2.2.2. Deleting eleents 2.2.!. "dding eleents and changing their style 2.2.#. $electing te%t 2.2.&. "uto'copletion 2.2.(. Miscellaneous !. )iew odes !.1. Dra*t !.2. +ayout !.!. $ide by side !.#. ,verviews #. ,ther coands #.1. -ile/ew,pen$ave$ave asClose #.2. -ileevert #.!. -ilerint 3via D-4 #.#. -ile$ettings3Change5+oad5$ave as4 #.&. -ile$ettings$pell chec6er dictionary #.(. 7dit8ndoedo #.9. 7ditCutCopyaste #.:. 7ditCopypaste syste #.;. 7dit$elect scene #.10. 7dit$elect all #.11. 7dit
#.20. $cripts"uto'copletion #.21. $cript>eaders #.22. $cripts+ocations #.2!. $criptTitle pages #.2#. $cript$pell chec6er dictionary #.2&. $cript$ettings3Change5+oad5$ave as4 #.2(. Tools$pell chec6er #.29. Tools/ae database #.2:. ToolsCharacter ap #.2;. ToolsCopare scripts #.!0. Tools
elpCoands #.!2. >elpManual #.!!. >elp"bout &. $ettings &.1.
Chapter 1. Introduction Table of Contents
1.1. Basic concepts This is the anual *or the Trelby screenwriting so*tware. This version o* the anual corresponds to version 2.2 o* the so*tware.
1.1. Basic concepts I* you donAt 6now anything about writing a screenplay get a copy o* a boo6 such as David TrottierAs The $creenwriterAs Bible. This anual will not cover the sae ground but *ocuses on concepts speci*ic to Trelby. Trelby divides a screenplay into a long list o* eleents each with a speci*ic element style. The available eleent styles are $cene $cene header. 7%aple I/T. M,T7+ ,,M ' /I<>T. "ction Describes action. 7%aple ohn grabs the gun *ro the des6. Character " spea6ing characterAs nae. 7%aple >"E. Dialogue $peech. 7%aple Eou could do that sure. ,n the other hand i* you want to live beyond the ne%t inute or so you ight want to rethin6 your approach. arenthetical Describes how the actor should say the *ollowing dialogue. 7%aple 3serious4. Transition Describes a non'standard transition between scenes. 7%aple DI$$,+)7 T,. $hot Describes an in'scene shot. 7%aple T>7 /7C?+"C7. "ct brea6
De*ines an act 3typically used in teleplays4. 7%aple "CT ,/7 or T7"$7. /ote /ote style is used to insert notes to yoursel* or to others about that part o* the script. 7%aple $hould Bobby shoot *irstF.
Chapter 2. Basic usage Table of Contents
2.1. Main window 2.2. Basic editing 2.2.1. Moving around 2.2.2. Deleting eleents 2.2.!. "dding eleents and changing their style 2.2.#. $electing te%t 2.2.&. "uto'copletion 2.2.(. Miscellaneous This chapter discusses basic usage o* Trelby.
2.1. Main window The ain window has the *ollowing parts in it in top'to'botto order a*ter the standard enu bar $cript tabs and status 7ach script gets its own tab with the tabAs nae being the *ilenae o* each script. Eou can clic6 on each tab to change the active script to that one or the @ at the end o* each tab to close that tab. "*ter tabs is a colun showing the current eleentAs style a colun showing what the 7nterTab 6eys would do and a colun showing the currenttotal page nuber. Main te%t area This is where the actual script is shown and edited.
2.2. Basic editing 2.2.1. Moving around The usual oveent 6eys are available 8pDown+e*tight to ove around >oe7nd to ove to startend o* line age 8page Down to ove updown one page 3actually one screen*ul4 and CT+ G >oe7nd to ove to startend o* script. CT+ G 8pDown oves one scene up or down.
2.2.2. Deleting eleents The Delete and Bac6space 6eys delete te%t one character at a tie. They also Hoin eleents to one another i* pressed at respectively at the end or at the start o* an eleent. The Hoined eleent will always have the style o* the preceding eleent.
2.2.!. "dding eleents and changing their style The 7nter 6ey will always create a new eleent. I* the cursor is at the end o* an eleent the new eleent will be an epty one otherwise the current eleent is split at the cursor position. The Tab 6ey will create a new eleent i* the cursor is at the end o* an eleent otherwise it will switch the current eleentAs style. $hi*t G Tab will always switch the eleentAs style. hat 6ind o* eleent 7nterTab$hi*t G Tab will createswitch to is dependent on the current style o* the eleent and is con*igurable by the user 3see $ection &.1.! J7leentsK 4. These values *or 7nterTab are always shown to the right o* the tab'bar. ,ther ways to change an eleentAs style are right'clic6ing with the ouse which will show a enu where you can change the eleentAs style or pressing a short'cut 6ey *or each eleent style. /ote that i* you have selected te%t belonging to ultiple eleents all o* those eleentsA types will be changed. $hi*t G 7nter or CT+ G 7nter will insert a *orced linebrea6.
2.2.#. $electing te%t hen selecting te%t one end o* the selection is always *i%ed and the other one oves around with the cursor. Eou can select te%t by clic6ing and dragging with the ouse 3right'clic6 unselects4 or by pressing CT+ G $pace which sets the *i%ed point o* the selection at current position and then oving around or by pressing soe oveent 6ey together with $hi*t 3e.g. $hi*t G 8p4. Eou can select the current scene with CT+ G ". "*ter youAve selected the desired te%t you can use the cutcopypaste coands to ove te%t around delete it etc. Eou can also press Del or Bac6space to siply delete it. Eou can unselect the selected te%t by pressing 7sc. or siply clic6ing the ouse on the screen.
2.2.&. "uto'copletion "uto'copletion saves typing in scenecharactertransition eleents by showing a list o* other eleents *ro the script that atch the te%t in the current eleent. -or e%aple i* youAve written the characters M, in a new character eleent youAll see a list o* all character eleents that start with M, and i* you want you can select one o* the and that te%t will coplete the current eleent. The auto'copletion list only appears a*ter youAve written at least one character. I* you want to see a list o* all possible choices write a single character and delete it. Eou can ove around in the list with the 8pDownage upage down 6eys. ressing 7nter will
coplete the te%t and start a new eleent while pressing 7nd will coplete the te%t but will not start a new eleent. ressing 7$C will a6e the list go away.
2.2.(. Miscellaneous hen inserting a new epty parenthetical eleent 34 will autoatically be added to it and the cursor positioned in the iddle. +i6ewise when switching a parenthetical eleent to soething else i* it only contains 34 it will be replaced by 3epty4. I* you write a 3 in an epty dialogue or character eleent i* will switch to a parenthetical eleent. I* you press 7nter or Tab at the ending 4 to start a new eleent the 4 will stay in the parenthetical. I* you write 7@T. or I/T. 3case doesnAt atter4 at the start o* any eleent it will switch to a scene eleent autoatically.
Chapter !. View odes Table of Contents
!.1. Dra*t !.2. +ayout !.!. $ide by side !.#. ,verviews This chapter describes the di**erent view odes available. Eou can toggle between the using the )iew'enu or by 6eyboard shortcuts.
!.1. Draft In ADra*tA ode the te%t area consists o* an epty bac6ground with the scriptAs te%t drawn on top. This te%t includes only actual script contents so page headers C,/TI/87D3M,74 and other autoatically added te%ts are not shown at all. age brea6s i* enabled are shown as a horiLontal line 3see $ection &.1.2 JDisplayK 4. easons you ight want to use this ode
Eou want to see only actual words youAve written and not be distracted by page'brea6 related *oratting.
age brea6s do not ta6e space so ore lines *it onto the screen.
ItAs the *astest view ode.
!.2. )ayout A+ayoutA ode shows an alost e%act representation o* the page as it would appear when printed. age borders argins headers C,/TI/87D3M,74 and so on are all shown at their correct places.
ays in which the display in this ode can di**er *ro the printed output
I* pagination is not up'to'date te%t around page brea6s can soeties show in incorrect places. e recoend that when using this ode auto'pagination is 6ept on and the interval at a low value pre*erably 1 second 3see $ection &.1.& JMiscK4.
I* you have scene continueds enabled they will always show as plain C,/TI/87D on top o* the page whereas in the D- output they will be C,/TI/87D 3n4 i* needed 3see $ection &.2.2 J-orattingK4.
!.!. $ide by side A$ide by sideA ode shows ultiple pages side by side as any as *it on your screen. Eou need to use a high resolution display andor sall *onts in order to *it ore than one page on the screen at a tie. ,therwise this ode is the sae as the A+ayoutA ode. /ote that this ode also assues that the entire pages *it vertically on the screen so age updown coands behave soewhat di**erently.
!.#. *verviews There are two overview odes one showing each character as a single pi%el and one showing each character as # pi%els. This is unsuitable *or editing so these odes are ainly use*ul *or getting an overview o* the page layouts.
Chapter #. *ther coands Table of Contents
#.1. -ile/ew,pen$ave$ave asClose #.2. -ileevert #.!. -ilerint 3via D-4 #.#. -ile$ettings3Change5+oad5$ave as4 #.&. -ile$ettings$pell chec6er dictionary #.(. 7dit8ndoedo #.9. 7ditCutCopyaste #.:. 7ditCopypaste syste #.;. 7dit$elect scene #.10. 7dit$elect all #.11. 7dit
#.1;. $criptaginate #.20. $cripts"uto'copletion #.21. $cript>eaders #.22. $cripts+ocations #.2!. $criptTitle pages #.2#. $cript$pell chec6er dictionary #.2&. $cript$ettings3Change5+oad5$ave as4 #.2(. Tools$pell chec6er #.29. Tools/ae database #.2:. ToolsCharacter ap #.2;. ToolsCopare scripts #.!0. ToolselpCoands #.!2. >elpManual #.!!. >elp"bout This chapter describes coands not discussed elsewhere.
#.1. +ile,-ew*pen$ave$ave asClose These do what youAd e%pect the to do.
#.2. +ile,/evert eplaces the open script with the last version o* it saved to dis6.
#.!. +ile,0rint via 0D+ This opens up the current script in your con*igured D- viewer progra *ro which you can print it or Hust see what it loo6s li6e.
#.#. +ile,$ettings,Change3)oad3$ave as These allow you to editloadsave global settings 3see Chapter & Settings4. By de*ault Trelby loads settings *ro a *ile naed de*ault.con* on startup. $ee Chapter : Command line parameters *or custoiLing this.
#.&. +ile,$ettings,$pell chec4er dictionary This opens a dialog allowing you to edit the global spell chec6er user'de*ined dictionary. Insert new words by entering the on separate lines or delete e%isting words by deleting the lines they are on.
#.(. 5dit,6ndo/edo 7very edit operation you do to the script is recorded and can be undoneredone. There is a liit to the
aount o* eory that Trelby will use to store undo history and di**erent edit operations ta6e di**erent aounts o* eory 3adding a single new character ta6es very little eory whereas doing a global -ind=eplace can ta6e a lot o* eory4 but in noral usage you should be able to undo hundreds or even thousands o* edit operations. There are a *ew occasions when undo history is otherwise tried that you should be aware o*
"pplying new script'speci*ic settings clears all undo history.
I* you do a new edit operation while you are in the iddle o* the undo history 3i.e. you have done one or ore undo operations without having done *ollow'up redo operations to restore all your previously ade changes4 all recorded undo history a*ter the current point in it will be discarded.
#.7. 5dit,CutCopy0aste Cut copy and paste wor6 pretty uch the sae way as in every other progra. /ote that these coands use TrelbyAs internal clipboard so canAt be used *or copying te%t to*ro other progras. -or that see below.
#.8. 5dit,Copy,paste syste These copypaste te%t to the syste wide clipboard so can be used *or counicating with other progras. /ote that i* you copy te%t to the clipboard *ro Trelby you ust 6eep Trelby open until youAve pasted the te%t to the destination progra. ThereAs two variants o* the copy coand *oratted and un*oratted. hich one you want to use depends on what youAre trying to do. Best to try out both and see which one wor6s better.
#.9. 5dit,$elect scene $elect all the te%t o* the current scene.
#.1:. 5dit,$elect all $elect all the te%t in the entire script.
#.11. 5dit,;oto page This opens a dialog allowing you to type in a page nuber to Hup to. The 7nter7scape 6eys can be used as shortcuts *or the ,?Cancel buttons.
#.12. 5dit,;oto scene This opens a dialog allowing you to type in a scene nuber to Hup to. The 7nter7scape 6eys can be
used as shortcuts *or the ,?Cancel buttons.
#.1!. 5dit,Insert non'brea4ing space This adds a non'brea6ing space at the current cursor position. This will ensure that the line will not brea6 at this position when it is being typed*oratted in.
#.1#. 5dit,+ind < /eplace This opens a dialog allowing you to search *or and possibly replace te%t. 8sually it operates on all eleent styles but i* you press the More button you can select the eleent styles it operates on which is use*ul when renaing a character and so on. ressing 7nter while the cursor is in either te%t bo% is euivalent to pressing the A-ind ne%tA button. The 7sc 6ey will close the dialog. I* youAre doing partial replacing i.e. replacing soe but not all occurrences o* A*ooA with AbarA the e**icient way to do that is to press Tab until the *ocus is on the A-ind ne%tA button and then use the A-A 3-ind ne%t4 and AA 3eplace4 6eys on the 6eyboard. ress A-A whenever you donAt want to replace that occurrence and AA when you do want to replace it.
#.1&. 5dit,/eove eleents Aeove eleentsA opens a dialog allowing you to select one or ore eleent styles to copletely reove *ro the script. Eou can use this *or e.g. reoving notes be*ore sending out copies o* the script or i* you want a version o* the script with only the dialog only the action or only the scene headers or whatever else you can coe up with.
#.1(. View,$how foratting This toggles whether *oratting in*oration is shown. It consists o* blue lines drawn at the right and le*t argins o* each line plus a red ar6er indicating the type o* the line ending *or that line. $ee *ile*orat.t%t *or in*oration about the di**erent ar6er types. hen using the A-ind errorsA coand i* you canAt *igure out what the error is try switching this on to see i* you have two eleents where you thought you only had one or soething else thatAs not obvious in the noral display. ItAs also use*ul *or seeing e%actly how uch space youAve got le*t on a given line.
#.17. View,+ullscreen Changes the display to *ullscreen ode hiding all distractions. To e%it *ullscreen ode either press
-11 or press the icon at top'le*t corner.
#.18. $cript,+ind ne%t error A-ind ne%t errorA searches through the script starting *ro the cursor position loo6ing *or errors. This eans that to search the entire script *or errors you should *irst position the cursor at the beginning o* the script. I* it *inds any errors it positions the cursor on the line containing the error and displays a essage detailing the error. Eou should *i% the error bac6 up a *ew lines and activate the coand again to search *or ore errors. "lternatively i* you donAt want to *i% the error right now ove the cursor down one line i* you want to search *or ore errors. It can detect the *ollowing errors
"n epty line or a parenthetical eleent containing only 34.
" character eleent that is not *ollowed by a parenthetical or a dialogue eleent.
" parenthetical eleent that does not *ollow a character or a dialogue eleent.
" dialogue eleent that does not *ollow a character or a parenthetical eleent.
)arious error conditions that can only arise *ro bugs in the progra. This includes things li6e overlong lines eleents that have lines with di**erent eleent types invalid characters in the script etc. Eou should never *ind any o* these errors but i* you do you should try to *i% the be*ore saving the script otherwise you ight not be able to load it again. Eou should also noti*y us about the proble so we can *i% it. The essages *or these all say 3B8<4 at the end so they can be identi*ied *ro noral errors.
#.19. $cript,0aginate AaginateA siply repaginates the script. Eou norally donAt need to run this i* you have autoatic repagination enabled but the coand is available *or use when autoatic repagination is disabled or you want iediate repagination *or soe reason.
#.2:. $cripts,"uto'copletion >ere you can de*ine ites to be added to the auto'copletion lists *or $cene Character and Transition eleents and optionally disable auto'copletion *or any one o* the. Transition auto'copletes are pretty generic so by de*ault there are a *ew o* the here but the $cene and Character lists are epty. The ain use *or the are T) shows where you have a recurring cast o* characters and locations and itAs nice to have the always available even i* they havenAt yet been used in the current episodeAs script.
#.21. $cript,=eaders A>eadersA allows you to edit your scriptAs headers. >eaders are lines that are autoatically added to the top o* each page o* the script e%cluding title pages and the *irst page o* the actual script. Topost in the window is a setting *or how any epty lines you want inserted a*ter your header lines. "*ter that is a listbo% o* all the strings in your headers. $elect the te%t string you want to edit in this listbo% and use the adddelete buttons to adddelete te%t strings. Below the listbo% are the settings *or the selected string. Eou can adHust the string te%t style alignent line and positioning. The te%t is *irst positioned according to the alignent setting and then its horiLontal starting position is adHusted by the nuber o* characters given in A@ o**setA. /ote that this paraeter can be negative so *or e%aple i* you want your header string to start 2 characters be*ore the le*t argin select A"lignent +e*tA and A@ o**set '2A. "ny occurrences o* ANO"<7PA in the te%t string will be replaced by the page nuber in the actual headers. -inally there are AreviewA and A"pplyA buttons that you can use to preview your changes. AreviewA opens up a saple page in your D- viewer progra while A"pplyA applies the new headers to the open script so you can e.g. see how the page count o* the script would change.
#.22. $cripts,)ocations This dialog allows you to de*ine what scenes are part o* the sae location 3see $ection 9.2 J+ocation reportK4. The top listbo% shows locations separated by lines o* ''''''''''' while the botto listbo% shows scenes not part o* a user'speci*ied location. In the iddle are A"ddA and ADeleteA buttons *or oving scenes between the two listbo%es. The botto listbo% allows you to select any scenes at once. "n e%aple o* how to use this dialog select the scenes I/T. M,T7+ ,,M ' D"E I/T. M,T7+ ,,M ' D"E ' +"T7 and I/T. M,T7+ ,,M ' /I<>T in the botto listbo% then clic6 A"ddA which adds those three into a single location in the top listbo%. Then i* you want to add ore scenes to the sae location a6e sure one o* the scenes *or the location is selected in the top listbo% select the new scenes you want to add in the botto listbo% and clic6 A"ddA. I* you want to add scenes to a new location select one o* the ''''''''''' lines in the top listbo% as the destination be*ore clic6ing A"ddA.
#.2!. $cript,Title pages ATitle pagesA allows you to edit your scriptAs title pages. Eou can have as any title pages as you want or none at all. "t the top o* the window are adddeleteovene%t buttons. A"ddA adds a page ADeleteA deletes the
current page AMoveA swaps the current page with the ne%t page and A/e%tA changes the view to the ne%t page. The strings listbo% contains all te%t strings *or the current page. $elect the te%t string you want to edit in this listbo% and use the adddelete buttons to adddelete te%t strings. ,n the right side o* the listbo% is a coarse preview showing the appro%iate location o* te%t strings on the current page with the selected te%t string shown in red. "t the botto o* the window are the settings *or the selected te%t string. ThereAs the te%t itsel* 3which can consist o* ultiple lines4 the position o* it and its *ont siLe and style. The aligent setting has three possible options +e*t +e*t'Husti*ied. @'os setting eans the horiLontal position o* the le*tost edge o* the *irst character. Center Centered on the page. @'os setting is ignored. ight ight'Husti*ied. @'os setting eans the horiLontal position o* the rightost edge o* the last character. -inally thereAs a AreviewA button that you can use to get an accurate preview o* all o* the title pages.
#.2#. $cript,$pell chec4er dictionary This opens a dialog allowing you to edit the script'speci*ic spell chec6er dictionary. Insert new words by entering the on separate lines or delete e%isting words by deleting the lines they are on.
#.2&. $cript,$ettings,Change3)oad3$ave as These allow you to editloadsave script *orat settings 3see $ection &.2 J$cript *orat settingsK 4.
#.2(. Tools,$pell chec4er This spell chec6s the current script beginning at the current position. I* you want to spell chec6 the entire script be sure to position the cursor at the *irst line o* the script. I* it *inds any words it doesnAt recogniLe it Hups to that position in the script highlights the word and opens a dialog window that has a te%t bo% *or editing the word and the *ollowing & buttons eplace
eplace the word in the script with the 3odi*ied4 one in the te%t bo%. Eou can also do this by pressing 7nter in the te%t bo%. $6ip $6ip the word *or now. "dd to script dictionary "dd the word to the script'speci*ic dictionary. "dd to global dictionary "dd the word to the 3super'4global dictionary. $uggest replaceent $earch *or the & ost siilar 6nown words and allow choosing one o* the. I* selected that word is put in the te%t bo% and you can either edit it *urther or press AeplaceA at once to replace the word in the script. /ote that this only loo6s at words with the sae two *irst characters as the isspelled word 3ostly *or speed reasons4. $o while it can correct accodoate to accoodate it canAt correct coputer to coputer. "*ter pressing any o* the above buttons the spell chec6er loo6s *or the ne%t isspelled word. I* none are *ound it closes the dialog. Eou can also press the 7sc 6ey at any tie to close the dialog. /ote that the spell chec6er currently only supports the 7nglish language.
#.27. Tools,-ae database A/ae databaseA opens a window allowing you browse and search through a database o* ore than 200000 character naes each nae being categoriLed by its nationality and se%. ,n the le*t side o* the window is a list o* the nae categories. The ain groups available are nationalities but there are soe other interesting groups e.g. $ha6espeare Medieval -lowers etc. $elect the groups you want to search in either a single one by siply clic6ing on it or ultiple ones by holding down CT+ and then clic6ing on ultiple ites. I* you want to go bac6 to the de*ault o* having all the groups selected press the A$elect allA button at the botto o* the list. ,n the upper right side o* the window are the other search paraeters. ThereAs a te%t bo% in which you can write the te%t you want to search *or and two radio button groups. The *irst one a**ects how your search string is used. The string has to atch either a4 at the start o* the nae b4 anywhere in the nae or c4 at the end o* the nae.
The second one selects whether ale*ealeboth naes are included in the search results. The search is always case'insensitive and a blan6 search string atches all naes. "*ter having set all the search paraeters press the A$earchA button at which point the results list will change to contain only the naes atching the search paraeters. " count o* the atching naes is shown at the botto o* the window. Eou can select naes *ro the result list and press AInsertA to insert that nae at your script at the current cursor position.
#.28. Tools,Character ap ACharacter apA opens a window allowing you to insert any character *ro the supported I$,'::&;'1 3i.e. +atin'14 character set into your script.
#.29. Tools,Copare scripts Eou need two di**erent versions o* the sae script open to use ACopare scriptsA. $elect the older one as the *irst script and the newer one as the second script. Trelby then goes through the scripts loo6ing *or changes between the and displays the results as a D- *ile. ThereAs a chec6bo% allowing you to use the sae con*iguration paraeters *or the scripts youAre coparing. This is use*ul i* the scripts di**er in in their *oratting settings because in that case practically the entire script would show up as changed. The D- *ile contains only the changed parts o* the script. The changes are color coded Deleted lines are red added lines are green non'changed lines 3shown *or conte%t4 are white and ar6er lines *or single'line changes are yellow. The changed parts are separated by two gray lines.
#.!:. Tools,;enerate waterar4ed 0D+s This tool allows you to generate ultiple waterar6ed D-s to distribute to ultiple people. aterar6s are handy when you want to let your readers 6now overtly that the script is eant only *or their viewing and is not to be distributed. 7nter details li6e directory *ilenae pre*i% and waterar6 *ont siLe. Eou can have two lines o* waterar6s per *ile and the *irst line is coon in all *iles. The second line *or each *ile is provided as a list under the aterar6s entry bo%. The waterar6 in the D- is applied as slanted te%t in light grey color as part o* the bac6ground o* the page. The waterar6 is applied on every page. " uniue ID is also saved in the A?eywordsA etadata o* the D- *ile as a second source o* identi*ication o* a D- 3i* it is lea6ed with only the waterar6 reoved4.
#.!1. =elp,Coands ACoandsA opens a window showing all the coands and their current 6eyboard shortcuts. It also has a enu allowing you to save this as a >TM+ *ile i* you e.g. want to print it *or re*erence.
#.!2. =elp,Manual AManualA opens this anual youAre reading right now.
#.!!. =elp,"bout A"boutA opens the about screen *or Trelby showing in*oration such as the version o* the progra. It also shows a rando *aous ovie uote.
Chapter &. $ettings Table of Contents
&.1.
eleent types whether to include scene nubers and so on that directly a**ect script *oratting and output but are not tied to any speci*ic script in the sense that they can be reused *or di**erent scripts with no changes. Eou can easily saveload these so you can have ready'ade settings *or di**erent scenarios. This and script'speci*ic settings are copletely plat*or'neutral guaranteeing the e%act sae script output whatever plat*or you use. $cript'speci*ic settings are things that are speci*ic to one particular script li6e title pages header strings and auto'copletion settings and so canAt be reused *or di**erent scripts without changes. >owever i* you want to have a teplate *or these 3e.g. your contact in*oration on the title page is always the sae or youAre writing several episodes o* the sae T) show4 itAs easy Hust *ill in the in*oration you want and save the script as yQteplate.trel then when you want to use that as a teplate open that *ile change whatAs needed and save the script under a new nae.
&.1. ;lobal settings The global settings dialog is *ound under -ile$ettingsChange. It has a list o* categories on the le*t the selected categoryAs settings on the right and three buttons "pply Cancel and ,? on the botto. "pply updates the settings to the ones given in the dialog so you can easily preview your changes without closing the dialog. /ote that pressing Cancel a*ter "pply has no e**ect it only cancels changes that havenAt yet been coitted. The *ollowing sections detail the various settings.
&.1.1. Colors Color con*iguration. These only a**ect the display the D- output is always blac6 on white. The A8se per'eleent'type colorsA chec6bo% controls whether to use the sae te%t color *or all eleent types 3Te%t *oreground4 or whether to use the per'eleent color settings 3Te%t *oreground *or "ction Te%t *oreground *or Character etc.4.
&.1.2. Display The topost listbo% allows you to con*igure what *ont you want to use *or noral bold italic and bold G italic te%t. /ote that you should use the sae siLe *ont *or each one. 3Dra*t view ode only4 The row spacing setting a**ects how any pi%els there are between each row. It has an e**ect only in the ADra*tA view ode. 3Dra*t view ode only4 The Aage brea6 lines to showA setting a**ects how page brea6s are shown. I* you select A/oneA they are not shown at all. A/oralA you see solid gray lines in the scripts indicating actual page brea6 positions. A/oral G unadHustedA you see the solid lines but you also see a dotted gray line that shows where the page could have ended but that the page brea6 position was adHusted bac6wards to honor the settings in $ection &.2.2 J-orattingK. This is use*ul when youAve *inished your script and youAre going through it trying to reduce the page
count. I* *or e%aple you have three lines a Character a arenthetical and a Dialogue eleent all one line and the unadHusted page brea6 line is a*ter the arenthetical line and the actual page brea6 line is above the character line you 6now that i* you can tri Hust one line *ro the page all three lines will then *it on the page instead o* being pushed to the ne%t page.
&.1.!. 5leents This is where you con*igure the interaction paraeters *or each eleent style. "t the top is a cobo bo% where you speci*y what eleent style youAre con*iguring. "ll things below that are eleent'speci*ic settings. The A7nterTab createsA and ATab$hi*tGTab switches toA a**ect what eleent is created when 7nter or Tab is pressed in this eleent style or what eleent style Tab$hi*tGTab switches the eleent to. $ee $ection 2.2.! J"dding eleents and changing their styleK *or ore in*oration.
&.1.#. >eyboard >ere you can con*igure 6eyboard shortcuts *or each coand. /ote that a *ew coand6eys 37nter Tab etc.4 canAt be changed because theyAre an integral part o* the prograAs design.
&.1.&. Misc The de*ault script directory setting allows you to speci*y the de*ault directory *or -ile,pen dialog on progra startup. Eou can speci*y what application you want to use as your D- viewer. ,n indows this is usually "dobe "crobat and the path is soething li6e CRrogra -ilesR"dobeR"crobat 9.0ReaderR"crod!2.e%e. ,n +inu% you can also use "dobe "crobat path being soething li6e usrlocal"dobe"crobat9.0binacroread. Eou can also speci*y arguents to give to the D- viewer progra. A"uto'capitaliLe sentencesA i* on auto'capitaliLes sentences as you write the. I* it capitaliLes soething you donAt want capitaliLed write another letter and then replace the capitaliLed letter by a lowercase one. A"uto'capitaliLe i 'S IA i* on causes solitary AiA characters in the iddle o* sentences to be changed to a AIA character autoatically. Ahen opening a script start at last saved positionA causes the cursor position be restored to the point it was at when the script was saved. Aecenter screen on scrollingA causes oving around the script using updown 6eys to scroll a bit di**erently when cursor is at botto o* the screen and you press down instead o* oving the display down Hust one line it will recenter the display on the cursor. ATyping replaces selected te%tA causes selected te%t to be reoved and replaced with the character
entered whenever a 6ey is pressed and thereAs an active selection. AChec6 script *or errors be*ore print e%port or copareA i* chec6ed causes the progra to run A$cript-ind ne%t errorA *or the entire script autoatically be*ore printe%portcopare operations. This is to avoid printing 100 pages and then *inding thereAs an error on one o* the *i%ing o* which causes repagination o* the entire script and having to print all the 100 pages again. A$how splash screen *or @ secondsA can be used to custoiLe *or how long to show the splash screen on startup *or or to disable showing it copletely. A"uto'paginate intervalA de*ines how o*ten to repaginate the script autoatically. I* you have a particularly slow achine you ight want to increase this nuber. /ote that autoatic repagination is only done when you odi*y the script so you canAt Hust sit bac6 and wait *or the repagination to happen you have to 6eep a6ing changes. 3Eou can always use $criptaginate i* you want iediate repagination.4 A+ines to scroll per ouse wheel eventA needs no e%plaining.
&.2. $cript forat settings $cript *orat settings are *ound in $cript$ettingsChange. It has the sae "pplyCancel,? buttons as the global settings dialog.
&.2.1. 5leents This is where you con*igure the *oratting paraeters *or each eleent style. "t the top is a cobo bo% where you speci*y what eleent style youAre con*iguring. "ll things below that are eleent'speci*ic settings. The $creenrint areas hold *our chec6bo%es CapsBoldItalic8nderlined a**ecting the te%t style *or the eleent. $creen a**ects the editing screen while rint a**ects D- output. The A7pty lines 10 be*oreA setting is linespacing be*ore the eleent divided by 10. $o a value o* 10 eans noral linespacing 1& eans 1.& linespacing 20 is double linespacing etc. The A7pty lines 10 betweenA is the sae but *or intra'eleent linespacing i.e. consecutive lines o* the sae eleent have this uch space between the. The Indent and idth settings speci*y in characters how uch the eleent is indented 3i.e. set o** *ro the le*t argin4 and how wide it is. 10 characters 3in the de*ault 12'point *ont4 eual one inch.
&.2.2. +oratting >ere you can con*igure paraeters a**ecting the *oratting o* the script. The *irst two settings a**ect how any action and dialogue lines there ust be le*t at the end o* a page to allow brea6ing at that position. This only a**ects eleents that are bro6en in the iddle i.e. i* you
have a one'line eleent the page can always end a*ter that. The *ont siLe speci*ies the *ont siLe to use. 12 is the de*ault and you should only deviate *ro this i* you have a very good reason. AInclude scene continuedsA i* enabled inserts 3C,/TI/87D4 at the end o* each page that has a scene that continues to the ne%t page and C,/TI/87D 3n4 3n nuber o* C,/TI/87D pages *or current scene oitted i* n 14 *or each page that continues a scene *ro previous page3s4. A$cene continueds indentA is the nuber o* characters to indent the 3C,/TI/87D4 te%t with. AInclude scene nubersA causes scene nubers to be inserted to the le*t and right o* each scene eleent. This is usually only done *or scripts in production. A$how line nubersA pre*i%es each line with its line nuber 3starting *ro 1 at the top o* the page4. It can be considered a debug option as it has no use in noral operation but it can be use*ul i* youAre trying to *igure out printing related probles.
&.2.!. 0aper >ere you can con*igure your output paper siLe and argins. Eou can use "# +etter or a custo paper siLe. "t the botto o* the page is shown the nuber o* lines that will *it on a page with the given settings.
&.2.#. 0D+ >ere you can con*igure paraeters a**ecting the generation o* the D- *ile *or printing or e%porting. A"dd table o* contentsA i* on will cause the D- *ile to have a table o* contents listing all the scenes. /ote that this is not printed itAs Hust shown in D- viewer applications allowing one to uic6ly Hup to the selected scene. A$how table o* contents on D- openA i* on will cause the table o* contents to be shown by de*ault when opening the D- *ile. A,pen D- on current pageA i* on will insert a coand into the D- *ile telling the D- viewer application to show the current page when opening the *ile. /ot all D- viewer applications support this coand. /ote that this only a**ects D- *iles generated through the -ilerint coand -ile7%port coand isnAt a**ected by this. I* you really want to generate a peranent D- *ile opening on a non'standard page use -ilerint and save the D- *ile *ro the D- viewer application to a di**erent nae. A,it /ote eleentsA i* on will cause all /ote eleents to be oitted *ro the D- output. ADraw rectangles around /ote eleentsA i* on will cause rounded rectangles to be drawn around /ote eleents in the D- output to a6e the stand out ore. A$how arginsA draws a rectangle on each page showing the argin settings. It can be considered a debug option as it has no use in noral operation but it can be use*ul i* youAre trying to *igure out
printing related probles.
&.2.&. 0D+,+onts >ere you can con*igure the *onts used in generating the D- *iles. /orally they use the standard DCourier *onts that are guaranteed to wor6 everywhere and it is strongly recoended to leave things as they are unless you have speci*ic reasons to use other *onts. $o assuing you have a good enough reason you can use the TrueType *onts o* your choosing. There are *our di**erent *ont settings one *or each *ont style 3/oral Bold Italic Bold'Italic4. 7ach *ont setting has two parts a A/aeA *ield and a A-ileA *ield. The A/aeA *ield is the ostscript nae o* the *ont and is used by the D- viewer application to recogniLe the *ont to use. $oe e%aples o* the naes that would go here are A"ndaleMonoA ACourier/ew$MTA and ABitstrea)era$ansMono' oanA. These naes are in general ipossible *or huan beings to 6now *or arbitrary *onts. $ee the ne%t paragraphs *or ways around this. The A-ileA *ield is the *ilenae o* the TrueType *ont to use. I* you *ill in this *ield the *ont *ile is ebedded in the generated D- *iles. I* you leave this *ield epty but *ill in the A/aeA *ield the *ont *ile is not ebedded in the D- *ile Hust the A/aeA re*erence is used to indicate what *ont the Dviewer application should use. There are any *actors a**ecting whether you should ebed a *ont or not. 7bedding a *ont a6es it uch ore li6ely that the D- *ile will display properly on other peopleAs coputers andor print properly. >owever it will also increase the siLe o* the D- *iles drastically and not all *onts allow ebedding in their license ters. hen you use the ABrowseA button to locate a *ont *ile the *ollowing things happen
The *ile is chec6ed to be a valid TrueType *ont *ile.
The *ontAs ostscript nae is located *ro the *ont *ile and put in the A/aeA *ield.
The licensing ters o* the *ont are chec6ed and i* ebedding is not allowed a warning is printed.
/ote that the chosen *onts have to be able to be substituted in place o* the noral Courier *onts with no changes to the te%t layout i.e. they have to be *i%ed width *onts with the sae siLe as the Courier *onts are. I* this is not the case you will see characters overlapping each other and other errors in the output. "lso note that rando *onts downloaded *ro the Internet are very o*ten bro6en in every sense o* the word. They have naes that violate the ostscriptD- speci*ications they lac6 essential characters 3it is very rare *or the to contain anything outside o* the "$CII character set4 and their uality is bad. $o i* you *eel you ust use soething besides the noral Courier *onts at least use pro*essional *onts ade by people who 6now what theyAre doing. /ote *or indows users Microso*t in their in*inite wisdo have *ound yet another way to obstruct people *ro using their coputers. hen you use the ABrowseA button and navigate to e.g. the
ACRindowsR-ontsA directory to choose a TrueType *ont *ile the *iles are listed correctly but you canAt select theU ,ne wonders what goes on in those eetings at Microso*t where things li6e this are decided... hy would anyone ever want to select a *ont *ile *ro a noral *ile open dialogF
&.2.(. $trings >ere you can custoiLe the strings that are autoatically added to the script in certain situations 3C,/TI/87D4 "dded at the end o* a page when a scene spans ultiple pages. C,/TI/87D "dded at the start o* a page when a scene spans ultiple pages. 3M,74 "dded at the end o* a dialogue eleent that spans ultiple pages. 3contAd4 "dded a*ter the spea6erAs nae at the start o* a page when a dialogue eleent spans ultiple pages.
&.!. $cript'specific settings Decriptions *or these start at $ection #.20 J$cripts"uto'copletionK .
Chapter (. Iport and e%port Table of Contents
(.1. Iport (.1.1. "$CII Te%t *iles (.1.2. -inal Dra*t @M+ 3.*d%4 (.1.!. Celt% 3.celt%4 (.1.#. "dobe $tory 3.ast%4 (.1.&. -ountain 3.*ountain4 (.1.(. -ade In ro 3.*adein4
(.2. 7%port This chapter discusses the iporte%port support o* the progra.
(.1. Iport 7%isting screenplays can currently be iported *ro three *ile *orats as *oratted "$CII te%t -inal Dra*t @M+ 3.*d%4 Celt% 3.celt%4 "dobe $tory 3.ast%4 -ountain 3.*ountain4 and -ade In ro 3.*adein4. The *ollowing section docuents the *orat these *iles should have *or optial iport processing.
(.1.1. "$CII Te%t files "$CII te%t *iles should have the *ollowing characteristics
7ach eleent style should begin at a uniue colun. "n e%ception is that $cene and "ction can begin at the sae colun. There should only be one such starting colun per eleent style i.e. all dialogue should begin at the sae colun it shouldnAt soeties start at colun 2& soeties at 29 etc.
/o production ar6ings e.g. scene nubers page nubers cast lists or anything li6e that.
7leents should be separated by a single epty line.
Below is a short e%aple o* the 6ind o* *orat best recogniLed by Trelby. EXT. OCEAN - NIGHT The package hits the water and is submerged. A few secnds !ater" a rapid!# inf!ating !iferaft appears. The pep!e !and int the water in their parachutes. The# dispse f them and swim tward the !iferaft. INT. $I%E&A%T - NIGHT The#'re a!! abard" taking ff their c!thes. (hen the#'re a!! naked" )arah gathers the wet c!thes" thrws them ut" and c!ses the entrance t the tent-!ike !iferaft. The men pen!# admire )arah's bd#" as she pens a strage !cker and takes ut dr# c!thes fr e*er#ne which the# then put n.
+E,IN I knw a great wa# t warm up.
)A&AH )rr#" I gt *er the !der men thing a whi!e back.
+E,IN An#time #u ha*e a f!ashback" !et me knw.
)mething starts beeping.
(.1.2. +inal Draft ?M) .fd% -inal Dra*t *iles saved with version : o* the progra are supported with these contents iported
Te%t o* the the screenplay eleents 3"ction Dialog etc4 that Trelby understands. $cript notes in -inal Dra*t are iported as notes.
/ote that no *oratting settings are iported at all.
(.1.!. Celt% .celt% These *iles are created by the Celt% progra.
$creenplay eleents 3"ction Dialog etc4 that Trelby understands are iported. ,thers are converted to A"ctionA type.
/ote that no *oratting settings are iported at all.
(.1.#. "dobe $tory .ast% These *iles are created by the "dobe $tory editor.
$creenplay eleents 3"ction Dialog etc4 that Trelby understands are iported. ,thers are converted to A"ctionA type.
/ote that no *oratting settings are iported at all.
(.1.&. +ountain .fountain -ountain is an open plainte%t screenplay ar6up language. It is docuented at http*ountain.iosynta%. "lost all o* the spec is supported. The below are unsupported
7phasis ar6up 3bold italic etc4 is not supported. hen iporting you can choose to retain the synta% or reove it.
Dual dialogue is iported as a couple o* dialogues instead.
$ection$ynopsis are iported as notes.
Coents that are part o* another eleent are not recogniLed. 3$tandalone coents are iported as notes4.
Title pages are iported as action lines. Eou can also choose not to do this when iporting.
age brea6s are not supported 3iported as an action line4.
/ote that no *oratting settings are iported at all.
(.1.(. +ade In 0ro .fadein These *iles are created by the -ade In ro screenwriting progra.
$creenplay eleents 3"ction Dialog /otes etc4 that Trelby understands are iported. ,thers are converted to A"ctionA type.
/ote that no *oratting settings are iported at all.
(.2. 5%port Eou can e%port the script in D- T- *oratted "$CII >TM+ -inal Dra*t @M+ 3.*d%4 and -ountain 3.*ountain4 *orat. "ll are *ound in the -ile7%port dialog which allows you to choose which one to e%port as. I* you e%port as a te%t *ile Trelby will as6 whether you want the page ar6ers included or not. I* youAre planning on iporting the script to soe other progra you shouldnAt include the otherwise you probably should. The T- *ile produced uses stylesheets which not all T- reading progras support so i* you get une%pected output chec6 with soething li6e ,pen,**ice to see whether the proble is with the *ile or with the progra you tried to use.
Chapter 7. /eports Table of Contents
9.1. $cript report 9.2. +ocation report 9.!. $cene report 9.#. Character report 9.&. Dialogue chart This chapter discusses the various report types Trelby can generate. "ll the reports are in D- *orat so that you can easily view the on your coputer and i* necessary also get high'uality printed output.
7.1. $cript report The script report is a short one'page report on general script statistics. It has the *ollowing in*oration
Total line count o* the script and line counts *or each eleent type both in absolute ters and as a percentage o* the whole.
ercentage o* lines *ound in interior and e%terior scenes 3it deterines this based solely on
whether the scene eleent starts with I/T. or [email protected]
Ma%iu and average scene lengths in lines.
Ma%iu and average action eleent lengths in lines.
/uber o* di**erent spea6ing characters.
7.2. )ocation report The location report is siilar to the scene report but cobines scenes ta6ing place at the sae location into one entity. I* you always use the sae scene line to describe a single location you donAt need to do anything special to get a correct location report. I* however you have e.g. scenes naed I/T. M,T7+ ,,M ' D"E I/T. M,T7+ ,,M ' D"E ' +"T7 and I/T. M,T7+ ,,M ' /I<>T and youAd li6e the to be treated as the sae location see $ection #.22 J$cripts+ocationsK *or details on how to do that. The location report lists the *ollowing in*oration *or each location list o* scenes *or the location 3i* ore than one each is *ollowed by a percentage showing its part o* the total lines o* the location4 total lines in location percentage o* action lines in location percentage o* the locationAs total lines o* the scriptAs total lines how any scenes the location has count o* pages that the location appears in list o* pages that the location appears in and optionally a list o* all spea6ing characters in the location along with the nuber o* lines they spea6.
7.!. $cene report The scene report lists the *ollowing in*oration *or each scene scene nuber scene nae total lines in scene percentage o* action lines in scene count o* pages that the scene appears in list o* pages that the scene appears in and optionally a list o* all spea6ing characters in the scene along with the nuber o* lines they spea6.
7.#. Character report ACharacter reportA *irst opens a window allowing you to speci*y what to include in the generated report. Eou can select what characters are included and what 6ind o* in*oration to include *or each character Basic in*oration Total nuber o* speeches total nuber o* lines the percentage o* all the dialogue lines in the script that this character spea6s 3i.e. 2&V would ean this character has one'*ourth o* the total dialogue in the script4 average nuber o* lines per speech total words average nuber o* words per speech and average nuber o* characters per word. age list
/uber o* pages this character spea6s on *ollowed by a list o* all o* those pages. +ocation list " list o* all the locations this character spea6s in preceded by the nuber o* lines spo6en at each location.
7.&. Dialogue chart ADialogue chartA *irst opens a window allowing you to speci*y what to include in the generated chart. The A$orted byA options select what orderings to include while the ACharacters W 10 linesA option i* unselected leaves out all characters that have less than 10 dialogue lines which is use*ul *or triing out inor characters *ro long scripts. It then generates a chart with one page *or each selected ordering and shows that. The chart has two a%es The horiLontal one with page nubers increasing *ro le*t to right and the vertical one with characters ordered by the current pageAs sort criterion *ro top to botto. I* a character spea6s on a given page he will have a blac6 bar on that pageAs position on the chart. The barAs height is scaled according to how any dialogue lines the character has on that page allowing easy visual identi*ication o* long onologues etc. 7very other line has a light gray bac6ground to allow easier visual atching o* distant ar6ings to character naes. Eou can use this chart in any ways. -or e%aple you can at a glance see i* one o* your side characters disappears *or &0 pages in the iddle o* the script whether the villain is introduced too late and so on. "t the top is another graph showing the percentage o* action dialogue character and other lines on each page. This graph is ost use*ul *or seeing how the percentage o* action lines *luctuates allowing one to easily see where the aHor action scenes are etc.
Chapter 8. Coand line paraeters Trelby supports the *ollowing coand line paraeters ''con* -I+7/"M7 ead global settings *ro the given *ile instead o* de*ault.con*. -I+7/"M71 -I+7/"M72 ... ,pen the given script *iles.
Chapter 9. Troubleshooting This chapter discusses soe coon probles you ight encounter.
The progra usually wor6s per*ectly but soeties itAs so uch slower that itAs alost unusable.
This happens on certain achines with liited resources. Try stopping all other progras and restarting Trelby and see i* that helpsX i* so a6e it a habit o* starting Trelby *irst so it can allocate the resources 3video eory ainly4 that it needs *or *ast operation be*ore starting other progras.
"ppendi% ". +ile forat The *ile *orat used by Trelby *or scripts is open and docuented and third parties are encouraged to add support *or the *orat in their progras andor write utility progras that use the *ile *orat in soe way. -or ore in*oration see the *ile A*ile*orat.t%tA in the prograAs installation directory and read through the saple script *ile provided. I* you still have uestions about the *ile *orat *eel *ree to contact us by eail.
