Scrivener beta 4 now available for download

User avatar
Site Admin
Posts: 19158
Joined: Tue Jun 13, 2006 11:23 pm
Platform: Mac
Location: Truro, Cornwall

Sun Nov 12, 2006 8:26 pm Post

Hello all,

Scrivener beta 4 is now ready for testing. You can download it here: ... erRCb4.dmg

And - dare I say it - this really is it... Beta 4 really does mark the beginning of the end of this beta testing phase. I am very happy with it and believe it is ready for 1.0 status. Thus, there will be no new features from now on - everything from here on in right up until release and beyond for some time should just be bug fixing only. The focus for beta 5 will be getting the help file ready (note that in beta 4 you can call up the help file, but it is just a placeholder, so please don't post complaining that there is nothing in it!), bug fixing, and finding a good way of implementing a demo.

A comprehensive list of changes is available in the readme file and at the bottom of this post, but the main changes are as follows:

- Incorporated eSellerate engine which checks serial numbers ready for commercial release.
- Incorporated the Sparkle framework, which allows auto-updates - from now on, Scrivener can tell you when there is a new version available!
- Reorganised the menus to better conform to Apple's Human Interface Guidelines and make things less cluttered. (Please take a moment to familarise yourself with these changes - and note that certain keyboard shortcuts have also changed, so look them up in the menus before posting any bug reports!)
- Revamped the Export Draft sheet and added a "Preserve Formatting" flag to documents. You could now format a basic manuscript within Scrivener and send it off to a publisher without ever having to touch a word processor. (You can also include headers in RTF exports now.) Of course, for more advanced formatting, you will still need to do final formatting in a word processor, but if all you require is standard manuscript format for a novel, Scrivener can now do that (see this thread for more details).
- You can now access the script elements menu using the keyboard - use cmd-Y to bring up the menu, and then just hit the number of the element.

Please get testing and post any bugs to the Bug Hunt forum! :)

All the best,

Full beta 4 change list
- Fixed bug in outliner columns where the menu to show and hide columns would show and hide the wrong columns.
- Removed three test files from MultiMarkdown bundle.
- Plain text MultiMarkdown files are now saved as Unicode rather than ASCII, so that special characters are not lost.
- Fixed bug where using "Convert Bold and Italics to MMD Syntax" would leave a certain characters in bold or italics after conversion if text was selected.
- Export of annotations and footnotes to RTF format is now handled differently internally, which should hopefully make exporting of other languages possible, and also (hopefully) fix previous RTF formatting bugs. Please report any issues to the Bug Hunt forum.
- MultiMarkdown packaged updated.
- Keywords can now be dragged from the keywords HUD or table into the document text.
- Fixed bug in Preferences panel whereby setting a colour will also change the colour of the selected text in the main window.
- Dragging documents into another project now copies the snapshots over as well.
- Removed extra (unnecessary) brace from end of XHTML header in MMD export.
- Fixed bug where RTFD files for notes were not being released upon closing a project.
- Corkboard pins are now on by default.
- Fixed some minor bugs in saving and restoring navigation history between sessions.
- Hopefully fixed crash caused by trying to drag search field from toolbar customisation palette to toolbar. If the crash is fixed, this was an odd one - there was nothing wrong with the code, but the menu itself had somehow become corrupt. Replacing the menu in the .nib file with a new menu that is exactly the same seems to have fixed the issue (I hope). Strange.
- New folders are now added as siblings of selected folders rather than as children of them.
- Convert Selected Documents to Format now works in full screen, too.
- MultiMarkdown export now catches any standard errors thrown caused by parsing errors and displays them in a text view in an error panel.
- Fixed bug in dragging URLs from the references table into the main text.
- Fixed minor bug where Project Replace progress indicator did not get cleared after closing the sheet, so that it would be full the next time you opened the Project Replace sheet.
- Text margins now grow or shrink depending on scale. Attempting to keep these constant regardless of scale caused white lines to appear across the text after scrolling for some scale factors.
- Fixed bug whereby the width of the notes text view could get thrown off when swapping between Supporting Materials and MetaData with Notes views.
- Added "Escape" as key equivalent to most Cancel buttons.
- Incorporated eSellerate engine ( to validate user names and serial numbers and handle the whole registration process, ready for selling Scrivener as shareware.
- Added Sparkle framework ( for software updates - Scrivener can now check for updates on start up and there is a "Check for Updates..." menu item under the application menu.
- Added a Help placeholder page, ready for implementing the documentation.
- Made minor improvements to view navigation, including adding support for up/down navigation to work in the inspector view.
- Added check mark next to current document in Go To menu.
- Before launching into full screen, you can now set the full screen navigation history by selection the documents you want in the navigation history in the binder and then entering full screen mode. You will be able to navigate backwards and forwards between the documents you selected. This way, you can choose several documents on which you would like to work in full screen. Note that doing this clears the full screen's previous navigation history, and that this does not apply when entering full screen in an Edit Scrivenings mode.
- Fixed potentially dangerous bug in Move To, which would previously allow you to move a document into itself, effectively causing pop to eat itself - ie., the document would completely disappear from the binder.
- There is now a Help ("?") button in the Export Draft sheet which will take you directly to the page in the documentation containing information about export formats (though note that the actual Help page is just a placeholder for now, until the document is written properly).
- Footer/contextual menu is now the same for both corkboard and outliner views. You can now use the contextual menu for these views to batch-assign status and labels to multiple documents. Note that assignation of status and labels in the corkboard view depends on the status stamps and label pins being visible, and in the outliner view it depends on the respective columns being visible. Also note that you cannot assign status or label via the binder, as the binder is not intended for editing meta-data, but just for getting an overview of the files in your project.
- Folder created by MMD imports to hold documents now takes its name from the file name.
- Fixes to MMD import: you can now import sections that have no text, and the import works properly even if there is no meta-data at the top (which was a problem before). If there is any meta-data at the top, it is now imported as a "Meta-Data" text file. The importer also now correctly parses files that do not use closing hashes after titles.
- When exporting to MultiMarkdown, you can now include images. If you want to include an image, just use the regular MMD syntax, but use a Scrivener link that points to the image file you want to use (which must be part of the Scrivener project) where you would normally type the name of the image file. When exporting to MMD, Scrivener examines the Scrivener links, and if it finds that any point to images, it exports the images too and ensures that the image file name matches what is in the text. (Note that if images are included in the export, all of the exported files will be placed inside a folder.) Note that this does not work when exporting to RTF via MultiMarkdown. If you want to export to RTF via MMD and include images, export to HTML and then use TextEdit to convert your file (though why you would choose to create RTF via MMD rather than using Scrivener's own rich text methods is beyond me anyway... :) ). Note that you are responsible for adding the appropriate MMD tags around the Scrivener link to ensure that it is treated as an image upon export yourself.
- Fixed bug in auto-capitalise whereby the word after a quotation mark would get auto-capitalised, eg. "Hello?" He said. This no longer happens - Scrivener no longer capitalises words that immediately follow closing quotation marks.
- Added keyboard shortcuts for script writing text mode elements menu. To change elements without your hands leaving the keyboard, hit Cmd-Y to bring up the menu, then hit the key bound to the element (number keys 1-9).
- "Meta-Data (with Notes)" is now the default mode of the inspector for new projects.
- Moved Empty Trash... menu item to File menu, which makes more sense.
- Added "Base Header Level: 1" to default MultiMarkdown settings.
- Changed the way that projects are automatically opened on launch. All projects that were open in the last session will now be opened on project launch, not just the last one that was opened.
- Added new items to the Edit > Insert menu as follows: "Insert > Auto-Number..." allows you to insert set variables into your text that will be replaced on export, as follows: <$n> will be replaced with normal numbers (1, 2, 3, 4, 5...); <$r> and <$R> will be replaced with roman numerals, lower- or uppercase respectively (i, ii, iii, iv, v... or I, II, III, IV, V...); <$w> and <$W> will be replaced with the words for numbers, lower- and uppercase respectively (one, two, three, four, five... or ONE, TWO, THREE, FOUR, FIVE). Upon export, Scrivener will go through each of these variables one by one and replace them with the appropriate text. These variables can be inserted anywhere that gets exported - in text, in titles, synopses, notes, wherever. In this way you can give chapters titles using variables which will be updated depending on how many chapters there are. For instance, if you have a third chapter with the title, "Chapter <$n>", where this is the third occurrence of "<$n>" in the whole draft, it will be exported as "Chapter 3". If you then insert another chapter before this one with the same title, the next time it is exported, this chapter will become "Chapter 4". Each different variable will be auto-numbered independently. So, for instance, you could have Part I, Part II, Part III and Chapter 1, Chapter 2, Chapter 3 and so on. Note, however, that there is no way of resetting the count, so you cannot have, for instance, Book I, Chapter 1 and Book II, Chapter 1... There are also variables for the draft word count and draft character count - <$wc> and <$cc>.
- By default, Group documents are now created with the "Page Break Before" flag set to ON.
- Minor improvements to auto-capitalise feature (note that this feature is only basic and not intended to rival that of Word or any other dedicated package).
- Page layout has been simplified so that the header is automatically generated (for normal printing, the header and footer just give the name of the document, the date, and the page numbers). Custom headers are now confined to the export panel (where printing and exporting has been much improved - see below).
- Auto-caps is now off by default. Turn it on via Preferences if you want it on, but please do remember that it is not intended to rival the auto-caps features of programs like Word. If you don't like it, don't use it. It is still useful for many.
- Improved the Convert Format of Selected Documents... to affect more attributes - previously it would not work properly with certain line spacing options.
- Fixed minor bug with smart quotes whereby if more than one character was exchanged for a quotation, text colour in full screen would not affect the second character.
- Removed publisher's word count, page count and paperback pages count from Document Statistics. These statistics were misleading and pointless. The publisher's word count is debatable; the pages count would depend on scaling and wouldn't really reflect current print settings anyway given that the text view works independent of print settings; and the publisher's page count was meaningless given that it depends on how your book would be printed!
- Internal changes to page layout and export.
- Rich text export in Export Draft now takes document attributes for margins and paper size from the settings in Page Setup.
- Images now remember their scale and rotation and PDF documents remember the page they were on when navigating between documents.
- Massive improvements to Export Draft - you can now use Export Draft to print off a fully-formatted novel or short story manuscript without having to export, or you can export it to RTF in such a way that it should need no or very little extra formatting. Features lots of new options such as centering titles and converting italics to underline, so that you can write in italics but produce a manuscript that uses underlining, the standard way of showing emphasis in a manuscript. You can also choose to straighten your smart quotes, convert em-dashes to "--" and ellipses to three periods, so that you don't have to worry about these things when composing if you later choose to export to MultiMarkdown or plain text for use in, for example, Final Draft. You can also specify a header that will get exported to RTF, specify scene breaks (such as "#") and generate automatic word counts, character counts and auto-numbering within the draft. You can also have a different font for documents that hold children if you so wish.
- Documents now have a "Preserve Formatting" checkbox option. If this option is checked, export text formatting will not be applied to that document when using Export Draft.
- Project Assistant now remembers the last directory to which you saved a project and displays that by default.
- Project Settings has been renamed "Label & Status" and moved to the Edit menu.
- (Hopefully) fixed bug whereby when creating a new document while a long document was displayed with the scroll bar not at the top, the new document may be shown with the scroll knob at the bottom and the text view may be unresponsive to clicks until you scroll to the top. (Note that this only affected scaled text.)
- Fixed bug whereby there could be an exception thrown when leaving a full screen Edit Scrivenings session. (This was caused by the editor trying to receive a selection range from the Edit Scrivenings session when in some cases the editor didn't inherit this E.S. session and therefore there was less text than needed to receive the selection.)
- Single images can now be dragged from the binder into the text (note that this only works with image files and only if you are dragging one image). Holding the alt key down negates this behaviour, so that you if you hold the alt key down and drag an image from the binder into the text, it will become a Scrivener link instead of an inline image.
- When exporting to LaTeX, RTF or HTML via MultiMarkdown, Scrivener now looks in ~/Library/Application Support/MultiMarkdown and then in /Library/Application Support/MultiMarkdown for the relevant MMD scripts (ie. bin/, bin/ and bin/ If the scripts are not found in these locations, then Scrivener uses the ones contained inside its own bundle. This way, users can update and modify MultiMarkdown scripts without having to rely on a Scrivener update or modifying the bundle directly.
- You can now call up the Edit Status and Edit Label sheet straight from the popup menus used for assigning status and labels.
- Fixed minor bugs related to scaling text that would cause lower area of text view to become inactive if there was no text there.
- All references to "Groups" have been changed to "Folders" for clarity (apart from "Group/Ungroup", which is standard).
- Added: You can now save your Export Draft settings! This means that you can set up how you want to export once and then use these settings with different projects. Or, you can use different export settings with the same project simply by loading up the one you want to use. Use the "Save" and "Load" buttons in the Export Draft sheet - everything should be self-explanatory. Export settings are saved as XML files in the ~/Library/Application Support/Scrivener/Export Settings folder, so you can share them with others if you want to, too.
- Hopefully fixed a bug that could cause a hang while taking snapshots (caused by the app trying to wait for the snapshot sound to finish playing but never getting the signal that the sound was finished - a QuickTime limitation).
- Added a project templates feature. You can now save a project as a template and create new projects with that project as a base. To do so, just set up a skeleton project with the labels, status, binder structure and any basic documents you want set up as you would like. Then use "Save As Template..." from the File menu. The project will be saved as a .scrtpl file in ~/Library/Application Support/Scrivener/Templates. You can therefore distribute any particularly useful templates via the forum should you so wish. When you go to create a new project, the Assistant will show you a list of available templates. If you have no available templates, the Assistant will look no different than in previous betas. Note that Scrivener comes with no templates by default, so you will only see this feature in the Assistant if you create or download some templates.
- Changed keyboard shortcuts for zoom and "zoom to fit window" in Window menu, because there was a bug whereby the keyboard shortcut for "Zoom" would actually zoom all windows. This is because holding down the "alt" key while zooming causes it to affect all windows, which therefore means keyboard shortcuts for zoom should not use the alt key (I believe). The new shortcuts are ctrl-cmd-minus and ctrl-cmd-= for zoom and zoom to fit screen respectively.
- Fixed footnote toolbar item tooltip to read "footnote" instead of "annotation".
- Fixed: when splitting documents, newly created documents now have the proper creation date rather than taking on the creation date of the original document.
- "Status" can now be renamed just as "Label" can, so that the status list doesn't have to be a status list - you can use it for whatever you want.
- Fixed bug in Project Statistics whereby Selection statistics could show nothing and "Include subdocuments" would have no effect.
- Added keyboard shortcuts for Document and Project Statistics (alt-ctrl-cmd-S and shift-alt-cmd-S respectively).
- You can now drag strings of text to the keywords table or the keywords HUD, so that you can just drag (e.g.) a character name into the keywords should you so wish.
- Added button to "Synopsis" header in inspector that auto-generates synopsis from first part of text in the editor.
- Added "Take Snapshots of Selection" option to Snapshots menu. This just takes snapshots of all the documents selected in the binder, search results table, outliner or corkboard.
- Text mode is now saved inside the project rather than in the defaults file that handles other state-saving. This way, text mode can be part of a template (so you could create a "Script" project template with one or both of the editors set to use screenplay text mode as soon as you create the project).
- Fixed bug when updating from Scrivener Gold projects whereby if you had an empty task list item, the update would hang and fail.
- Menus have been reshuffled to be more consistent with Apple's HIG (
UserExperience/Conceptual/OSXHIGuidelines/index.html? ... xperience/
Conceptual/OSXHIGuidelines/XHIGIntro/chapter_1_section_1.html). Note that the keyboard shortcuts for some commands have been changed, too - most notably the "Move" and split commands. Please take a moment to familiarise yourself with the new menus - if an old keyboard shortcut beeps at you, look up the new one in the menus before posting on the forum to ask what happened.
- Minor improvements made to typewriter scrolling.
- Added an "n documents changed" text field to the Replace All sheet to show that replace has finished and give extra feedback than just the progress bar.
Last edited by KB on Sun Dec 10, 2006 2:38 pm, edited 1 time in total.

User avatar
Posts: 20584
Joined: Sun Jun 18, 2006 4:30 am
Platform: Mac + Linux
Location: Santiago de Compostela, Galiza

Sun Nov 12, 2006 8:49 pm Post

Ha. Murphy would have it that I release a FAQ mere moments before a new beta release. Well, off to revise! :)
Ioa Petra'ka
“Whole sight, or all the rest is desolation.” —John Fowles

User avatar
Site Admin
Posts: 19158
Joined: Tue Jun 13, 2006 11:23 pm
Platform: Mac
Location: Truro, Cornwall

Sun Nov 12, 2006 9:21 pm Post

Oops, if you have already downloaded beta 4 (as of 9.20pm GMT) and use MultiMarkdown, please download it again. There was a minor bug with exporting images with MMD - you will probably never, ever come across it (it would only occur if you accidentally gave two images that were intended for export with MMD the same file name), but all the same, you might want to re-download anyway.

Posts: 45
Joined: Wed Sep 13, 2006 4:19 pm
Location: UK

Sun Nov 12, 2006 9:33 pm Post

Oooooh! I had a feeling in my bones that something might happen here tonight :)

Thanks Keith - another awesome list of updates there! I look forward to playing (errr...I mean, writing).


Posts: 151
Joined: Sun Sep 24, 2006 11:33 am
Location: Germany

Mon Nov 13, 2006 6:29 am Post

Fantastic, Keith.

User avatar
Posts: 166
Joined: Wed Oct 11, 2006 7:35 pm
Platform: Mac, Win + iOS

Mon Nov 13, 2006 7:24 am Post

Keith, I am very, very excited. Congratulations!

Posts: 99
Joined: Thu Oct 19, 2006 7:45 pm
Platform: Linux
Location: New York, NY

Mon Nov 13, 2006 11:37 am Post

Just spent the night writing last-minute documentation for the morning; at least I didn't have to do it with poor software.

Keith, this is really a pleasure to use. Even past 5am ;)

Posts: 63
Joined: Mon Jul 10, 2006 4:19 pm
Platform: Mac
Location: Montreal, Quebec, Canada

Mon Nov 13, 2006 4:52 pm Post

Congratulations, Keith.

The changes look exciting as usual, though I haven't had time to go through them all yet. Templates, cool!

(I can check it all out tonight instead of Nanowriming! :wink: )

User avatar
Posts: 506
Joined: Fri Sep 22, 2006 4:43 pm
Platform: Mac

Mon Nov 13, 2006 6:05 pm Post

I ask for saveable export options; you say 'no'; I say 'fairynuff'; you put 'em in.

I ask for auto chapter numbering; you say 'too hard'; I say 'okey-dokey'; here they are!

Some bloke complains that you haven't written a word processor; we say 'no need'; you say 'no chance'; whomph! there it is!

I'm speechless .... :shock:

Stick a fork in it folks! Scrivener is done!

Joakim Hertze
Posts: 59
Joined: Fri Sep 01, 2006 11:53 am
Location: Malmö, Sweden

Mon Nov 13, 2006 6:59 pm Post

I'll say, Keith -- you've really outdone yourself. I absolutely love the new export features. Suddenly all my needs are being taken care of.

Oh, and I obviously love the rest as well. :-)

User avatar
Posts: 37
Joined: Sun Jun 18, 2006 7:17 pm
Location: New York

Mon Nov 13, 2006 7:05 pm Post

Like Bartleby the Scrivener, Keith says, "I prefer not to," but unlike Bartleby he goes ahead and does it anyway.

Three cheers!

Posts: 58
Joined: Wed Jun 21, 2006 8:53 am
Location: Berlin

Mon Nov 13, 2006 9:14 pm Post

epstein wrote:Like Bartleby the Scrivener, Keith says, "I prefer not to," but unlike Bartleby he goes ahead and does it anyway.

:D Nice reference, epstein!

(And three more cheers from me, because Scrivener will replace the three programs I used for my last project: Hog Bay Notebook, Ulysses and Word.)

User avatar
Site Admin
Posts: 19158
Joined: Tue Jun 13, 2006 11:23 pm
Platform: Mac
Location: Truro, Cornwall

Mon Nov 13, 2006 11:49 pm Post

Please make sure you download beta 4.1 which (hopefully) fixes a major bug in the new export code, which could cause a hang when exporting. Please feel free to test out the new automatic updates feature by going to the Scrivener menu within Scrivener and selecting "Check for Updates...". :)
All the best,

User avatar
Posts: 1063
Joined: Wed Jul 12, 2006 4:30 pm
Platform: Mac
Location: Ashland, Oregon, USA

Tue Nov 14, 2006 12:54 am Post

Updater worked great! Thanks!!


Posts: 75
Joined: Wed Sep 27, 2006 4:15 am

Tue Nov 14, 2006 3:58 am Post

Thanks a lot for the export options! That was the one thing holding me back from definitely purchasing it. You did a great job with that..

My one question/request is that the cmd+y shortcut work in full-screen mode (perhaps it was meant to but just overlooked?). I think it is VERY useful but if it doesn't work in full screen mode (where I write most of the time) I'm just going to have to manually click the box as I did before. Is there a reason for it to not work in full-screen?

Also, why not instead of using 1, 2, 3, etc. as the shortcuts, do something like "c" for character, "d" for dialogue, "h" for scene heading, "s" for stage direction, etc.

Thanks again for the changes, they're quite welcome!