oreilly.comSafari Books Online.Conferences.


AddThis Social Bookmark Button

Flexible OmniOutliner

by Giles Turnbull

omni- (in comb.) all.
-- The Little Oxford Dictionary.

When is an outliner not an outliner? When it does more than just outlines. The latest version of OmniOutliner supports a wide range of additional useful functions, and I'm going to breeze through many of them here today.


Let's start with something easy, like the ability to export your outlined data into iCal or even into your iPod. Many people think of an outline as a kind of supercharged to-do list, but there are other practical applications for an outliner, too. Ever considered maintaining web pages, writing a book, or even backing up your brain with an outliner?

The nice folks at the Omni Group maintain a list of useful scripts you can use in conjunction with OmniOutliner. One of the most recent additions is the Export to iCal script, which is trivially simple to put to use.

All you need to is grab the .dmg, unpack it, and drag the script file contained within to your Library/Application Support/OmniOutliner/Scripts folder. Yes, this could mean any of several different folders on your computer, but it depends on whether you intend to use the scripts only under your user account, share them with other users of the same computer, or share them across a network. If you're unsure, stick with the first option for now, and put the file in /Users/[Your User Name]/Library/Application Support/OmniOutliner/Scripts.

Then, fire up OmniOutliner, and you'll see the script has appeared under the Scripts menu. To successfully export your outlined to-do list to iCal, you need to get your outline set up in a certain way first. To get dated to-do items to appear as iCal to-dos, they need to be listed in a column with the word "Due" in the title, and the Column Type set as "date" in OmniOutliner's info inspector (see Figure 1).

OmniOutliner's info inspector, showing Column Type set as date
Figure 1. The Column Type setting in the Info Inspector.

Similarly, to get priority settings to show up nicely in iCal, you need a column titled "Priority" and set as "Number" type. Priorities need to entered as integers from zero to three, with zero being lowest priority.

Columns arranged and data entered, you're ready to export your outline to iCal (see Figure 2).

An outline ready to be exported
Figure 2. An outline ready to be exported.

Once the export is done, iCal starts automatically (if it was already running, the script can quit the program and relaunch it for you). Listed in your To Do Items pane are all of your outliner items, with the appropriate priorities and due dates visible there or, with more detail, in the Info pane (see Figure 3).

iCal showing exported data from OmniOutliner
Figure 3. iCal showing exported data from OmniOutliner.

You may be asking the obvious question: why not just create the to-dos in iCal in the first place? Or, if OmniOutliner is your preferred tool, why not just keep them there? Well, if you use OmniOutliner for special lists (not necessarily to-do lists), you may find it useful to be able to see those lists alongside all of your other usual to-dos. Alternatively, if you like having to-dos and calendar events in one place, but don't like iCal's system for adding new events (I'll fess up: I don't get along with iCal at all), this is one possible way of getting around it.

As a final extra little nugget of goodness, OmniOutliner allows you to put scripts on the toolbar alongside all of the other controls. Just use the Customize Toolbar menu as normal, and drag your chosen script to where you want it. As long as you have installed the script in the correct folder (as spelled out above), this will work. (See Figure 4.)

Script on the OmniOutliner toolbar
Figure 4. OmniOutliner's toolbar customized with the Export to iCal script.


How about taking your OmniOutlines around with you in your pocket? You can do this too, if you have an iPod. There are two AppleScripts available from the same extras page mentioned above, rolled together in a disk image with some helpful extra information.

The disk image includes another script you can run to open the right installation folder; you don't even have to go digging around in the Finder. Then you copy over the script of your choice, Export as Contact for older iPods, or Export as Note for owners of newer machines (third generation) that support text notes.

There are limitations to what you can view comfortably on the small iPod screen, so multi-column outlines are best avoided. Also, the status of individual items (checked or unchecked) won't show; nor will indentations showing child-parent relationships within the outline.

Installing the iPod Scripts

All of that being said, it's just plain cool, and even possibly useful, to move outlines from your Mac to the iPod. Once you grab the script and the package opens, you get this screen:

Install screen
Figure 5. Installation screen for the iPod export script.

Follow the instructions on this screen, and soon you'll be exporting directly from Omni Outliner via the scripts menu.

Figure 6. iPod export (for 3G models) added to the Scripts menu.

For additional OmniOutliner-to-iPod export caveats, here are the notes directly from the README file:

  • Though these scripts can be used with multi-column outlines, doing so is of limited usefulness, as the iPod can't display this type of text very well on its narrow screen.
  • Extremely large OmniOutliner documents may cause AppleScript to fail with a "Stack Overflow" error.
  • Exported outlines don't show their checked/unchecked status, indent level, or note text.
  • To delete an outline from the iPod, open its Contacts folder in the Finder and delete the file whose name matches that of the outline you want to delete.
  • The "as Contact" script requires Mac OS X 10.2 with the optional BSD package installed in order to properly encode non-ASCII text. (It can still be run without, but special characters and international text will appear as gibberish.)


Some say that OmniOutliner could even be put to use as a tool for professional writers (a journalist and an author provide two of the three testimonials for the software at the top of its home page), but using the program this way might require a certain adjustment of the writer's way of thinking.

Writers tend to work with text files in editors and word processors designed for the task. However they design their working routine, they will usually have a draft of their work saved as a text file, and will use that as the basis for future drafts. The text is treated as a single unit, to be sculpted into shape. That's how I tend to work, anyway.

Before writing this review, though, I tried starting a new work of text in OmniOutliner, and it was an interesting new way of working. Each time you hit the Return key in OmniOutliner, you create a new outline item. You have to press Command-Return to make a carriage return within the item itself. This lends itself to a means of writing that I, for one, have not tried before: paragraph-by-paragraph control.

I just write as before (OmniOutliner uses the built-in, system-wide spell checker), hitting Return as I normally would, and the program turns my ramblings into a outlined document. I can study my masterpiece in different views, collapsing chapters or subheadings that I don't want to see so that I can concentrate on the ones I do. This works surprisingly well, helping to chop the text up into meaningful chunks without getting in the way of reading it as a whole.

That said, OmniOutliner is no word processor. Sure, it can process words, but that's not really what it was designed for. It's better for processing thoughts and ideas, but you could argue that any work of text, be it a high school essay or the next bestseller, is comprised of a series of thoughts and ideas turned into a coherent whole. There's certainly the potential for a writer to use this program to achieve that, but it takes a bit of getting used to.

One other writing-related note: if you use Microsoft Word as your word processor, then OmniOutliner enables you to export your outlines as Word docs, and the outline styling is preserved. You'll need OmniOutliner 2.2 or later; download the Export from OmniOutliner to Microsoft Word script from the Extras page. I have more detail on this in OmniExportExpert section later in this article.

Pages: 1, 2

Next Pagearrow