Bean -- Frequently Asked Questions

Tips & Tricks



Tips & Tricks:

I saved my file in Bean. Where is it?

Files saved in Bean are stored in the OS X file system (which is like a bunch of nested folders), not in any special database like with iPhoto or on the iPad. So, in short, the file is located in the folder where you saved it. 

If you do not remember where the file was saved, try these things:

1) Click the Spotlight icon and enter pertinent words from the document’s title or text in the search field. Spotlight will search your file system for matches. The Spotlight icon is the magnifying glass icon at the extreme right of the menu bar.

2) With Bean running, look under File > Open Recent or check Recent Items in the Apple menu. However, you will only find recently opened files in these menus. The Apple menu is accessed by clicking the Apple icon at the extreme left of the menu bar.

3) Click the File > Save As… menu item to see what the last folder saved to was (Bean offers to save to that folder again), and then examine that folder using the Finder.

Tip: If you have a document open in Bean and you want to examine the Folder hierarchy containing it, command-click the title in the title bar.

How do I create an envelope template?

Create a new document and change the paper size to match the envelope size you wish to print on, like so: File > Page Setup… > Paper Size: Envelope #10 (common in U.S.) or Envelope DL (common in Europe).

If you wish, you can create your own envelope size by selecting Paper Size: Manage Custom Sizes….

In the Page Setup sheet, select Orientation: Sideways (the second icon). You may have to experiment to find the best way to insert the envelope into the printer.


Example envelope settings in the Page Setup sheet.

To make an envelope template document, make the address text into template text (select a line, then Insert > Template Text > Template Text Markers), then make the envelope document into a template document (File > Make Template). 

How do I change the page orientation?

In the Page Setup sheet (File > Page Setup…), select Orientation: Top to Bottom or Sideways.

How do I change the 'new document' template?

Select Bean Preferences > New > New document template: Custom. Then click the Choose Template button and select the desired file.

Note: this will ‘lock’ the file so that Bean will treat it as a template. You can unlock a locked file by selecting the file in the Finder, then de-select Finder > Get Info… > Locked. A file does not need to be in the /Users/<You>/Library/Application Support/Bean/Templates folder to be a custom new document template.

How do I create a reusable 'template' document?

To create a document template from the current document, select File > Make Template. Supply a name for the template file when prompted. It will be saved to the Templates folder (which is located at /Users/<You>/Library/Application Support/Bean/Templates). The document will then reopen in Bean as an untitled copy of the original.

Documents in the Templates folder, when opened using the File > Open Template… command, will open as untitled documents. Note that document files that are locked (with File > Get Info… > Locked in the FInder) will also open in Bean as untitled documents.

How do I associate a file type (.rtf, etc.) with Bean so that it always opens in Bean when I double-click on a document's icon in the Finder?

In the Finder, select a file of the type you're interested in. Next, in the Finder's menu bar, select Find > Get Info, then Open with: Bean. Then, click the 'Change All...' button and OK the change.

To associate a single document with Bean, right click or ctrl-click the document in the Finder to show the context menu, then press the option key to reveal the Always Open With… menu item.

I use Make Plain Text then Make Rich Text in Text Edit to 'clean' web text of formatting. Anything like that in Bean?

Style > Remove All Styles does something very similar. Also see Edit > Remove > Text Tables / Text Lists / Text Styles / Images & Attachments / Tab Stops.

Selections copied from web pages sometimes display weirdly in View > Show Layout mode. Why?

Tables can sometimes trigger inappropriate pagination and text display. The tables are not always apparent. Sometimes they do not display a grid and are only used for positioning text. Select View > Show Invisibles to see hidden tables. Select Edit > Remove > Text Tables to remove the offending tables from a selection.

How do I 'auto-indent' the first line of each paragraph (instead of pressing Tab each time)?

Format > Inspector… to show the Inspector. Then, modify the Indent: First Line setting to affect the selected text. To set the first line indent amount for new documents, see Bean Preferences > New > Document settings… > First line indent.

I'm tired of removing extraneous line breaks from text files. How can I do this easily?

Google for the free download WordService 2.7 from DEVONtechnologies, which adds a 'Format > Reformat' command to the OS X Services menu (the Services menu is found under the 'Bean' menu item).

Why doesn't italics work with (for example) Lucida Grande?

OS X uses different fonts for Bold, Italic, etc. for higher quality text output (older computers 'faked' these by adding slant or weight). But not every option is represented for every font. On the other hand, sometimes you get more options. Check out Helvetica Neue as an example. Note that you can change the font style of selected text easily through the drop-down menu in Bean's Inspector.

1__#$!@%!#__Pasted Graphic.jpg

Font style options available for the font Helvetica Neue

Anything I should know about working with images in a document?

You can drag and drop image files and other attachments into a document in Bean. Note that non-image attachments (e.g., .mov files) must be saved using the .rtfd or .bean formats. Saving a document with images using .rtf or .doc format will convert the images into a .jpg, so if fidelity and speed are required, use .rtfd format instead. On the other hand, if compatibility with a non-Apple computer is required, use the .rtf or .doc formats, as they are easily read by both Word and OpenOffice.

To resize an image, double-click on the image to reveal a resizing control.

Edit > Change > Picture Appearance shows a panel with tools for adjusting the image appearance.

How do I make a box around text like the following one?

Follow these steps:

1. Select the text you want in a box

2. In the menu: Format > Table

3. Make the 'table' 1 row by 1 column

4. Adjust the Cell Border and Cell Background colors

How do I select 'linked' text? It keeps opening a browser window!

Position the cursor just beside the 'linked' text and use [Shift] + arrow keys to select.

How does autosave work?

To activate autosave for all documents, select Bean Preferences > Save > Autosave documents every ... minutes. This causes documents to autosave at the interval you specify. If Bean quits unexpectedly, Bean will open the last autosaved version of the document so you do not lose your changes. This only applies to documents opened after autosave is activated.

Autosave will *not* save your files if you quit the app or close the document window without saving the document; you must explicitly save the file if you wish to keep it.

Why can’t I add italics and bold to parts of the text? Is this a bug, or a design decision?

You are probably editing a plain text file, which contains no formatting above characters, spaces, tabs, and returns. Copy and paste the document contents into a new rich text document if you want to add formatting.

The plain text format is used for various purposes, including the following:

How do I uninstall Bean?

1. Drag the Bean application icon from the folder where it is located (probably Applications) onto the Dock's trash icon. You may need to authenticate this action. (If you can't locate, search for it using Spotlight. If you still can't find it, it might be inside the CopyPaste bundle if you use CopyPaste Pro.)
2. You can also trash the following file (which tracks user settings for Bean):


When I make a change in Preferences, my open documents are not affected.

Preferences are generally for new documents. To change open documents, use menu bar items.

Bean crashes at startup.

Try dragging the following file to the trash (the file contains Bean’s preference settings) and then restart Bean:


Repeated crashes on startup may be caused by Bean trying to open an autosaved document that contains a problem. Try removing any autosaved documents from the folder:

Users/<You>/Library/Autosave Information/

Try downloading a fresh copy of Bean from

Examine the log in to see if, for example, some input manager is causing Bean to crash on start up.

List Bullets appear out of nowhere.

Erasing the initial bullet isn’t enough to get rid of a list; you have to remove the underlying list attribute. You can do this by applying Format > List > Marker... > None to a text selection, or by applying Edit > Remove > Text Lists to a selection.

Parts of the document disappear in Layout mode.

Probably pagination is being thrown off by invisible text tables copied and pasted from a webpage. Try selecting Edit > Remove > All Text Tables. To reveal hidden text tables, select View > Show Invisibles.

A document file won’t open in Bean.

Bean usually determines a document file's format by looking at the filename's extension (.doc, .rtf and so on). If the filename extension is missing from the filename, try adding it.

How do you make Footnotes, Section Breaks, and automatic Table of Contents?

For these features, try OpenOffice (available at no charge).

Can I write my graduate thesis with Bean?

For some things you just need a full-featured word processor or else TeX.


Bean version 3.2.5 (March 8 2013)


Fixed a problem with the way native rtf headers and footers were written out that could cause the document body text to appear in four columns in other apps (20130102-1).


File > New from Template... now allows viewing the contents of folders in the Templates folder, allowing for hierarchical organization (20130211-1).

Added a section in the Help file (under Tips and Tricks) on how to change the default paper/page size for new documents.

Fixed a few object over/under release problems revealed by static analysis. 


Bean version 3.2.4 (January 12 2013)


Fixed a bug that prevented attachments with non-ASCII characters in their filenames to save correctly in .rtfd and .bean format files (20130104-1).

Altered rtf image decoding code to accommodate image hex data preceded by a newline (20130103-1).

Fixed a bug where, when opening .rtf files, a paragraph starting with an image could lose its paragraph attributes. For example, if a cell in a text table contained only an image, the image would be removed from the table since text tables are really paragraph attributes. (20130105-1).


Bean version 3.2.3 (November 30 2012)


Reverted bugfix 120909-1 which was supposed to allow images having names containing non-ascii characters to save in .rtfd and .bean format (121129-1). The bugfix was incorrect and also caused a larger problem, preventing headers and footers to save in .rtfd and .bean documents.


Bean version 3.2.2 (November 12 2012)


Improved and sped-up image decoding routines for .rtf format files (120930-1). 

Bean now has improved support for embedded images in .rtf documents created by LibreOffice, Nisus Writer, Abiword, and Mariner Write. Since Bean does not support ‘floating’ images, these are loaded in Bean as in-line images in the nearest paragraph.

A previous version, Bean 2.x, could create pre-formatted document headers and footers on the fly, and this setting could be saved per-document. This setting was previously ignored in Bean 3, which allows free-form headers and footers. However, for increased compatibility, documents originally saved in Bean 2 will now open in Bean 3.2.2 with an approximation of the header/footer info that was created on the fly in Bean 2. But for any document that has already been subsequently re-saved in Bean 3, this old header/footer info is ignored and removed. (20121007-1).

Edit view can become editable more quickly after selecting View > Show / Hide Layout (20120728-1).

Changed the width of text in exported HTML to 600px if the browser width is greater than 600px. While this is a bit wider than the typical printed page (which is what the previous setting tried to approximate), the new setting looks better on most screens.


Fixed a bug where, in a text table cell, any paragraph following and having a different paragraph style from the first paragraph would disappear when selecting the Add Row Above|Below, Add Column Before|After, and Delete Row|Column menu commands (20121015-1).

Fixed a bug where text tables nested within a text table cell would disappear when selecting the Add Row Above|Below, Add Column Before|After, Delete Row|Column menu commands (20121015-2).

Fixed a problem where .rtfd and .bean format documents with images having names containing non-ascii characters could omit the image files upon save (120909-1).

Fixed a bug where Edit > Change > Sort could cause the final item to go missing (20120922-2).

Selecting a document in the Finder and pressing cmd-p will now successfully print the file (20120922-1).

On OS X 10.7+, when System Preferences > Show Scroll Bars > Always is selected, the scroller would not hide in full screen mode. Fixed (20121016-2).

Fixed a problem where the vertical ruler was not activating consistently.

Programming Notes

Bean is now built on the OS X 10.8 SDK.

Added -weak_library /usr/lib/libSystem.B.dylib to Other Linker Flags to prevent crash on 10.5 due to ‘Symbol not found: __NSConcreteGlobalBlock’ (20121108-1)

Renamed zh_CN.lproj to zh_Hans.lproj.


Bean version 3.2.1 (July 23 2012)


Fixed a bug where View > Zoom > Default did not center the edit view (20120712-1).

On Lion, when transitioning to full screen, the single document window is now closed more quickly to prevent problems (20120712-2).

On Lion, the grouped document window would momentarily bulge (via annoying animation) when another newly opened document was added. Fixed (20120711-1).

Initial View > Split Window ratio was not 1:1. Fixed (20120708-1).

Fixed a problem where the Show Info panel might not update its counts when shown after being hidden (20120712-3).

Fixed a problem where switching documents in the grouped document window could cause a visual jitter due to the toolbar separator toggling (20120707-1).

Fixed a problem where the Bean Help document could be exported to a location inside the app bundle. Bean now prompts the user for a location (20120707-2).

Fixed a problem where the grouped document window could shift position (attempting to cascade) when several grouped documents were opened at the same time on Lion (20120707-3).

Fixed a crash caused when the Open panel preview pane tries to show a document with an invisible table cell border (20120707-4).

Fixed a bug where hyperlink urls could be mangled (20120713-1).

Launching Bean with ‘Preferences > Advanced > Show Info Panel at launch’ could cause the Info Panel to relocate to the Inspector’s location on Lion. Fixed (20120712-3).

Fixed intermittent crash when opening rtf files with custom rtf data in them due to a RegExKitLite assertion failure; [NSString clearStringCache] solved the problem (20120721-1).

Undo registration is now disabled while loading documents (20120720-1).

I had thought Bean 3.2.0 was code-signed and therefore enabled to pass Gatekeeper. I was wrong. Hopefully, 3.2.1 will download and start on Mountain Lion without Gatekeeper causing problems.


Bean version 3.2.0 (June 30 2012)


Fixed some memory leaks revealed by XCode 4 analyzer (120627-1).


Added localization for Brazilian Portuguese (courtesy Paulo Neto), Dutch (courtesy Frans de Graaf) and improved German localization (thanks to M. Bunge for the improvements).

Added Developer ID, so Bean will download and run on OS X 10.8 Mountain Lion without the OS complaining.

Starting with this version, Bean is no longer compatible with PowerPC (PPC) macs. In other words, it is no longer a universal binary. A PowerPC compatible version of Bean numbered 3.1.x will be available for download at the Bean website ( for those who need it. 


Bean version 3.1.1 (June 22 2012)


A new single document window could open to a small, unusable size. Fixed (20120614-1).

The ‘full format’ date item added in 3.1.0 inadvertently included time. Fixed (20120615-1).


The jewel buttons and add document button in tab bar are now resolution independent.

This is the last PowerPC-compatible version of Bean. As such, Bean version 3.1.1 will remain available for download at the Bean website for those with PowerPC macs. 


Bean version 3.1.0 (June 10 2012)


Bean Preferences > View > Zoom Control will display a zoom slider in the status bar, like Bean 2.x (20120520-1). Bean may hide this control due to lack of space.

Added a note to the Tips & Tricks section of the Help file about how file management (deleting files, moving files, copying files) is done using the Finder, not Bean.

Added a ‘Full Format’ menu item (which includes the weekday) to the Date/Time toolbar item popup menu (20120601-1).


NSAutomaticWindowAnimationsEnabled is now set to YES for Bean (so you will see window animation in Bean even if you have the global version of this preference set to NO). This avoids a very nasty bug that crashes any non-Lion-only app that uses the popup dictionary on Lion when Lion’s window animation is disabled.

Fixed inconsistant drawing of document tabs (20120605-1).


Bean version 3.0.9 (April 5 2012)


Bean Preferences > New > Custom > Choose Template now defaults to the user’s Templates folder (since Lion 10.7 make is almost impossible to navigate there) (20120401-1).

Added live updating of text ruler offset for layout views when a window is resized (20120311-1).

File > Revert to Saved no longer forgets the font used with plain text files (20120317-1).

File > Revert to Saved is now only active when the document has changed from the saved version (20120317-2).

File > Revert to Saved now restores the saved typing attributes of empty documents (20120317-4).

File > New Plain Text Document (cmd+option+n) could fail to show the Settings menu in the main menu. Fixed (20120317-3).

The side bar document list (Documents > Side bar) now resolves aliases dropped from Finder (20120317-5).

The side bar document list now has a minimum size slightly more than zero to prevent it from disappearing completely (20120320-2).


There is now a hidden preference to remove the gray hatched tiled pattern from the layout view background. Quit Bean, then use this terminal command (change YES to NO to reverse the setting):

defaults write com.bean-osx.Bean prefLayoutViewNoTexture -bool YES

Added Catalan localization, courtesy Toni Cama.

Added Italian localization, courtesy Stefano Carlini.


Bean version 3.0.8 (March 8 2012)


The draft view now shows the resizer bars only when the view width is greater than the setting at Preferences > Size > Limit Draft View Width to ... % of Screen, or when the window width is almost equal to the screen width (20120306-1).  To re-enable the previous behavior where the resizers are always visible in draft mode, use this terminal command (change YES to NO to reverse the setting):

defaults write com.bean-osx.Bean prefDoNotHideDraftWidthResizers -bool YES

The tab bar of the grouped document window now has a ‘+’ button to easily create new documents (20120229-1).

Bean now opens an untitled document (if no documents are open) after being activated by a click in the dock, as this is standard Cocoa behavior (20120226-1). To re-enable the previous behavior where no document is created, use this terminal command (change NO to YES to reverse the setting):

defaults write com.bean-osx.Bean prefOpenUntitledAtActivate -bool NO

Refined the appearance of document tabs in the tab bar (20120222-1).


File > Export > PDF could fail on PPC Macs due to uninitialized variable. Fixed (20120304-1).

The unused section of the document tab bar can now be used (like the title bar and tool bar) to drag/move the window (20120226-2).

Some graphic resources in Bean are now smaller thanks to Mike Detwiler (20120301-1).

Added/corrected/improved many VoiceOver labels (20120219-1).

The offset of the layout view text ruler now immediately updates when the window is resized (20120219-3).

Localized: Edit > Show Spelling and Grammar and Edit > Check Spelling While Typing

Insert > Line Break now uses the responder method insertLineBreak: and now also maintains the typing attributes (20120223-1).

In Bean 3.x, double-clicking the top or bottom margin of a page in layout view causes the header/footer sheet to show. In 3.0.8, the header text or footer text in the sheet is initially active based on which area of the layout view was clicked (20120219-5).

In Bean 3.x, a click in the top half of the right resizable draft margin results in a page up, while a click in the bottom half of the right resizable draft margin results in a page down. The code has been improved in 3.0.8 to reduce unintended actions (20120219-4).


Bean version 3.0.7 (February 16 2012)


Fixed a bug where cycling windows (command-~) would not hide full screen window when it was cycled out (20120203-2).

Saving a new document with the same name and path as an already open document in Bean is now rejected with an alert (20120204-1).

Style > Paste… items now more faithfully restore the text selections after acting (20120204-3).

Fixed a bug that could cause the text cursor to disappear due to a negative window number when moving a document from one window to another (20120209-1).

The scroller could incorrectly remain hidden when selecting ‘Move to Grouped Window’ or ‘Merge Document Windows’ from full screen. Fixed (20120210-2).

The Inspector, when snapped to a document window, no longer moves vertically when the Preference window is closed (20120212-1).

Fixed a bug where the Show Info window could appear when not wanted (20120212-2).


Added buttons for bold, italic, underline, and strikethrough to the Inspector (20120203-1).

Added alternate [press ‘option’ key to reveal it] menu item: Insert > Date (Long Format) and Time (20120204-2).

Bean ordinarily reveals newly exported documents in the Finder, but now you can disable this behavior with the following terminal command (change YES to NO to reverse the setting):

defaults write com.bean-osx.Bean prefDoNotRevealExportedFilesInFinder -bool YES

For the vision impaired, Edit > Speech > Document Counts reads aloud the word and character counts, while Edit > Speech > Document Attributes describes font and paragraph attributes at the text cursor as well as indicating whether a list or text table is present (20120204-4).

The image resizing control now shows image size in points (20120205-1).

When you add a tab stop to the ruler (for example, with a mouse click), you can now change the tab stop type by double-clicking (or alternatively by option-clicking in 10.5 and 10.6) on the tab symbol in the ruler. The tab stop will change from right tab, to left tab, to center tab, to decimal tab and cycle back. OS X 10.7 Lion will provide a tab-stop popup menu when you control-click (or right-click) on the text ruler.

Added a context (right-click) menu to the text ruler to show and hide the ruler controls (10.5 and 10.6 only).

Added a menu item to the context menu of the side bar document list: Move to Separate Window / Move to Grouped Window / Exit Full Screen.

Bean now supplies default tab stops at 1/2 inch (U.S.) or 1 cm (metric) intervals. If you wish for your new untitled documents to have no tab stops, use the following terminal command [change YES to NO to reverse the setting] (20120215-1):

defaults write com.bean-osx.Bean prefNoDefaultTabStops -bool YES

Added French Localization, courtesy Ange Lefrère.

Other localizations also updated.


Bean version 3.0.6 (February 2 2012)


The Inspector now updates more consistently (20120129-1).

Fixed a text field input validation bug that in rare cases could cause a crash (20120130-1).

Switching a document from full screen to a non-grouped window would not restore the document presentation settings. Fixed (20120130-3).

Fixed a regression in 3.0.5 where File > Prevent Editing setting was not maintained when switching documents between windows (20120130-2).

A status bar shown only to support Documents > Buttons now re-hides for other document navigation views (20120131-1).

Reimplemented cycle windows (command-~) since it wasn’t working correctly for some unknown reason (20120130-4).

Fixed the bug where a newly created text table had black borders, then added cells had gray borders (20120201-1).


You can now select a plain text document under Preferences > New > New Document Template > Custom > Choose Template (20120131-3).

Updated Slovak translation, courtesy Rudolf Gavlas.

Added Chinese (Simplified) translation, courtesy 贺 昀轩 (He Yunxuan).


Bean version 3.0.5 (January 26 2012)


Added a work-around to avoid crashes on Leopard involving fontSetChanged message (20120112-1).

Lion’s dictionary popover can become stuck when a full screen window is closed or switched away from, causing a crash. Fixed (20120124-1).

Attached sheets (Save panel, etc.) can become ‘lost’ when a full screen window is closed or switched away from. Fixed (20120108-1, 20120122-1).

Replaced _blinkCaret override with yet another fix when moving text views between windows (20120112-2). This might also fix the mysterious ‘missing text cursor’ problem.

Paste Font Family & Ruler menu item now enables itself correctly (20120108-2).

Fixed a regression in Bean 3.0.4 where ‘Review Changes before Quitting > Discard Changes’ could momentarily show a ‘Do You Want to Save the Changes You Made in the Document?’ alert on one document (20120123-1).

Fixed a bug where the Show Info panel could reappear unexpectedly when switching document windows after its being closed with the close button (20120126-1).


‘Undo’ now restores paragraph attributes changed after a deleted paragraph break (20120119-1).

The Inspector’s font popup menu now reloads when the available fonts change (20120122-2).

The Inspector now shows the typing attributes at the text cursor (i.e., the text attributes to be applied if text is typed there) rather than the attributes of the character following the text cursor (20120125-1).

Added Polish localization by Arek Wancerz.

Note on Services menu items available from Bean

On OS X 10.6+ (Snow Leopard, Lion) you must first activate these items under System Preferences > Keyboard > Keyboard Shortcuts > Services > Text. If upgrading from Bean 2.4 to Bean 3.x, you will have to re-activate them. The following Services menu items are provided by Bean:

HTML Snippit from Selection

Generates HTML code, minus header, from the selected rich text.

HTML+CSS Snippit from Selection

Generates HTML code with inline CSS text styling from the selected rich text.

New Bean Document Containing Selection

Makes a new document in Bean and pastes the selected text from the current app.

Paste Selection into Current Bean Document

Pastes text selected in the current app into the frontmost Bean document.

Note on the Dictionary Popup Crash under Lion

An OS X bug causes the dictionary popover in Lion to become stuck when the user preference controlling the ‘zoom-open’ window animation is turned off, followed by an immediate crash (but only on apps not compiled for Lion only). The following terminal command fixes the problem, but also re-enables the animation (change YES to NO to disable it again): 

defaults write NSGlobalDomain NSAutomaticWindowAnimationsEnabled -bool YES


Bean version 3.0.4 (January 5 2012)


Fixed a problem where help files would not display for some users (20120102-1).

Fixed a problem where Styles > Paste Font & Ruler into a zero-length selection just ahead of paragraph break would lose typing attributes (20120103-1).

Localized the “Do you want to save the changes you made to the document?” alert panel and fixed a few other localization issues (20120102-4).


Opening Bean’s help files no longer causes the initial unchanged Untitled document to close (20120102-2).

Increased area that triggers visibility of scroller in full screen mode (OS X 10.5-10.6) (20120102-3).


Added ‘Styles > Paste Font Family & Ruler’ menu item (this retains italic, bold, etc. if possible) (20120103-2).


Bean version 3.0.3 (January 1 2012)


Replaced the toolbar icons with a more colorful set.

Added Slovak localization. Special thanks to Rudolf Gavlas for helping to debug the localization process for Bean 3.


Bean version 3.0.2 (December 27 2011)


Fixed a problem where text fields did not accept digits after ',' used as a decimal.


Bean version 3.0.1 (December 24 2011)


Fixed a problem that prevented drag-resize of view width in draft (non-page layout) view.


Bean version 3.0.0 (December 24 2011)


The document background color (not View > Alternate Colors) now prints (20111029-2). You can set the background color using the button in the font panel that looks like this: Pasted Graphic.jpg

The ‘About Bean’ and ‘Help’ documents now always open in separate windows. These can be made to ‘float’ above other window with Documents > Window > Float Window.

Rewrote toolbar code so that 1) the grouped document window now better maintains its toolbar visible state 2) Bean Preferences no longer incorrectly responds to View > Hide Toolbar 3) removing toolbar items from the grouped window toolbar no longer causes a crash on Leopard 4) resizing the grouped document window no longer causes icon position problems when subsequently switching between grouped documents on Leopard.

Fixed a problem where File > New from Template could show an Open panel that was not set to the Templates folder. Also fixed a problem where if you navigated to the Templates folder in an Open panel, the Open panel would show the Templates folder the next time File > Open was chosen, which is undesirable. We work around this by changing the value of NSNavLastRootDirectory before running the panel, then reinserting the previous value after running the panel (20111103-1).

Fixed a problem where, under Lion, Correct Spelling Automatically could leave orphaned spelling suggestions that were unable to be dismissed. Note: Correct Spelling Automatically may be entirely disabled in a future release, as it tries to second-guess the user far too often and far too late for the user to take notice (20111128-1).

Fixed a problem on Lion where Lion’s ‘Resume’ feature was trying to encode the Find panel, resulting in the error [TextFinder encodeWithCoder:]: unrecognized selector.

Fixed a problem where the layout view background could incorrectly draw the document background color instead of its own color (20111029-1).

Improved setting and maintaining document background colors vs. alternate colors (20111029-3).

Fixed a problem where empty template documents would open without their saved typing attributes (20111121-1).

Fixed a bug where the inspector’s position could change when other utility panels were moved around (20111125-2).

Removed override of private method _blinkCaret.

Added a small delay when unhiding the scroller in full screen to avoid it flickering to life then just as suddenly disappearing as the mouse cursor passed over it (Leopard and Snow Leopard). Under Lion, the scroller’s native auto-hiding behavior is used.

The menu item View > Alternate Colors now validates correctly.

The Save panel now drops from below document tabs in the grouped document window (20111115-1).

Improved the appearance of Documents > Buttons navigation buttons.


Formerly, grabber buttons were provided above and below the vertical scroller for widening/narrowing the draft view edit area. Lion OS X 10.7 wants to hide the scroller when not in use, which it can’t do with grabber buttons added, so vertical grabber areas are now provided just to the left and right of the draft view edit area.

Reorganized the File menu. A reminder: the ‘option’ key can be used to reveal alternate menu functions.

The draft view (shown when layout view is hidden) now has some padding around text to allow for easier reading and text selection (20111119-1).

The default colors used for View > Alternate Colors are now the same as for version 2.4.5. (People liked them better.)

The Format > Margins and Columns… sheet has a new button in the middle that shrinks all margins to their smallest value (which is either the smallest printable margins, or zero if the option key is pressed when the button is clicked). This maximizes the space for text and is useful for example when making signs (20111120-1).

Added some textures to the user interface.

Plain Text Editing

By popular demand, plain text editing has been added to Bean. When editing a plain text document, the Font, Format, and Style menu bar items will be replaced by a Settings menu bar item. Menu items under Settings allow the user to change:

• the display font (which is then remembered as the user’s preferred plain text font)

• the line spacing (also remembered as a user preference)

• the writing direction to accommodate right-to-left languages

• the file encoding

To change the text size when editing a plain text document, use the View > Zoom controls. You can use View > Alternate Colors when editing a plain text document, but you cannot apply colors directly to the text using the color picker.

The text encoding being used is shown in the status bar label whenever a plain text document is front-most and the status bar is up.


Bean version 2.9.8 (28 October 2011)


Improved the code that prevents blank areas and ghost text when scrolling on OS X 10.6 Snow Leopard (testing reveals this is not a problem on OS X 10.5 or OS X 10.7), and removed the code added to fix this in beta 2.9.7 since it would cause OS X 10.7 Lion to crash.

Fixed a problem where Bean would crash upon save if the header or footer contained non-ASCII characters.

Bean version 2.9.7 (16 October 2011)


Fixed a problem where blank areas and ghost text could appear when scrolling

Fixed a bug where Bean Preferences > New > Generic > Document Settings… > Margins could not be set to zero. Note: Bean Preferences > Advanced > Limit Margins to Printable Area also affects how these fields behave.

Fixed a bug where the full screen alternate colors state was being saved and restored on re-opening the document

When Bean’s grouped document window had a sheet down and a document icon from the Finder was dropped on Bean’s app icon, the file would open with an unnamed tab, causing problems. Fixed.

Fixed a bad bug where the sizes of images in .rtf and .doc files were saved incorrectly in points instead of twips. Newly saved documents will now open in OpenOffice with correctly sized images (instead of way too small). Such files saved in previous versions of Bean will open in Bean 2.9.7 with correctly sized images, but will use twips when re-saved.

Fixed a problem where switching from 1-Up view to 2-Up would not restore the area of visible text

Fixed a bug where closing all documents would not clear the Info Panel’s counts

Fixed a problem where a blinking text cursor would appear to follow a text table, but typing text would immediately move the text back into the last cell of the table because the typing attributes included the table attribute

Fixed an annoyance where the toolbar in a grouped document window might momentarily change sizes when switching documents

Fixed a bug where the non-active view in a split view window might respond to typewriter scrolling

When exiting full screen draft mode to windowed draft mode, the text view would not resize correctly. Fixed.


Undo will now allow you to undo past a save

The keyboard shortcut for inserting a line break is now shift+command+return instead of shift+return. This is to avoid a bug where shift+return would insert a paragraph break instead of a line break on any page but the first one in some cases.

Edit > Find > Jump to Selection (⌘j) and Edit > Find > Jump to Last Edit (⌃⌘L) now trigger the saffron ‘found text’ indicator

Bean version 2.9.6 (12 April 2011)


Rewrote the header/footer token (or ‘automatic item’) code so that rich text attributes can be applied to the tokens (and therefore to the text that will replace the tokens); tokens now resemble template text

Improved text selection behavior with text that includes header/footer tokens and template text

Changed the Info Panel to only show word counts when the current document is not full screen, and to respect options selected under Bean Preferences > Full Screen > Show Info Panel etc. when in full screen

IMPORTANT NOTE: the old header/footer token code will go away in a future beta, so if you have template documents that use the old style tokens, remember to update them.

The old-style tokens look like this:

2__#$!@%!#__Pasted Graphic.jpg.

The new-style tokens look like this:

Pasted Graphic 1.jpg

Bean version 2.9.5 (28 March 2011)


Switching tabbed documents no longer removes focus from text.

Fixed some problems affecting localization.

Bean version 2.9.4 (20 March 2011)


Fixed a problem where the Bug Report was mistakenly opened as ‘read only’.

Renamed the HUD to Info Panel (many people were confused by the term HUD).

The Info Panel (HUD) position is saved correctly now (new code).

Added: Preferences > Advanced > Show Info Panel at launch.

Bean version 2.9.3 (13 March 2011)


Fixed a problem where invisibles would print if Bean > Preferences > Invisible Characters was active.

Fixed a problem where Bean > About Bean... and Help > Bean Help documents could fail to load due to bad path.

Bean version 2.9.2 (12 March 2011)


Fixed a bug involving Show Invisibles that could cause a crash.

Bean version 2.9.1 (11 March 2011)


Fixed a possible crash when closing non-grouped window documents.

Bean version 2.9.0 (10 March 2011)

Release notes

The source code has been completely rewritten with the goal of improving Bean and adding features requested by users, while still keeping things simple. This is, however, a beta release created from entirely new code, so it will be buggy.

New Features


No localizations available yet.

Please do not start a localization without contacting me first at jnrh2001 [at] yahoo [dot] com for instructions, as Bean now uses a new localization system.