Tinderbox 6

Tinderbox screencast tutorial four

It took almost a month to get this to the point that it was even somewhat publishable. In this episode we expand on our Day Planner, which we started in episode 3. We see how to set up an agent to hunt for completed tasks and place a check mark badge on the note. We look briefly at “display expressions” so we can see due dates in our notes on the map, and how to format the dates so we don’t see times. And we create a dashboard agent with a summary table to get an overview of our appointments.

Tinderbox 6 Tutorial 4 from Stephen Zeoli on Vimeo.

A lovely and inspiring video featuring Tinderbox

Dominique Renauld creates wonderful Tinderbox videos. They aren’t tutorials so much as they are inspirations. They show you what Tinderbox can help you do, not the nuts and bolts of how to handle Tinderbox. But they are well worth seeing, both for the spark they may provide in tackling Tinderbox and for their shear beauty.

In the most recent video, he shows some of the great features of the outline view. Watch it here:

Tinderbox screencast number 2 — stamps and agents

I’ve uploaded the second of my Tinderbox 6 tutorial videos. This one might be a little — just a little — bit more polished than the first. In this episode I provide a quick introduction to Stamps and Agents. Stamps allow you to set an action to be applied to a number of selected notes simultaneously. Agents are notes that look for other notes that match a specific criteria and then apply some action to them automatically. Agents work continually, search for any new notes or changes to work upon, while Stamps are used manually by the user. Hopefully you will see what I mean if you watch the video. Here it is:

Introduction to Tinderbox 6 – Part 2 from Stephen Zeoli on Vimeo.

Version 6.6 of Tinderbox now available

I just got an e-mail notification that the latest update to Tinderbox is now officially released. The update includes a number of tweaks and improvements, though nothing that will convince you to buy the app if you haven’t already been wowed by its power and possibilities.

You can read more about the updates here, and find out about how to save $10 on upgrades for the next week.

Workflowy and Tinderbox

If you’re reading this blog post, you undoubtedly know that Tinderbox is one of my favorite pieces of software. The mind-bogglingly versatile and powerful “tool for notes” is unsurpassed for helping me make sense of complex data (complex to me, child’s play to others perhaps). But I do not use Tinderbox as much as I would like for the simple reason that I can only run it on my MacBooks. I spend eight hours a day on my office Windows PC, and am frequently on the go with just my iPad with which to collect and write notes. Consequently, I end up dumping stuff into Evernote, which is terrific for keeping data sync’d across devices, but which does almost nothing for me in terms of analysis and visualization.

A note on nomenclature: It can become confusing writing about two different applications that may use different nomenclature. In this article, I will refer to any single item, whether in Workflowy or Tinderbox, as a note. The content of those notes I am calling note text. So, for instance, a note titled “Note A,” might have note text that says, “This is an example of note text in Note A,” 

Recently, I’ve started collecting research and notes for a book I want to write. Tinderbox would be a perfect helper for this project, so I am back to needing a way to bring in work that I do on other devices. And I believe I’ve found my solution in Workflowy. Being cloud-based and with an iOS app (not sure if there is an Android app, but probably), Workflowy is available to me most times when Tinderbox is not. [Update: The iOS app is a pretty weak implementation of the browser version. In fact, it is barely useable.] I can build an outline, add notes to the individual entries, and then import them right into a Tinderbox document. Here’s how to do it:

Workflowy is an adept, universally accessible outliner.

Workflowy is an adept, universally accessible outliner. Create an outline for importing to Tinderbox.

Of course you start by creating your notes in Workflowy. I’ve set up a section of my outline that I call Tinderbox Drawer, where I can work on anything I want to import into Tinderbox. (I could just as easily create a tag called #Tinderbox that would achieve the same thing.)


Select “Export” from the little drop down menu that appears when you click on the bullet icon at the start of the top level of the notes you want to export. Click on the OPML option.

Once your outline is ready to go, click on the bullet icon of the parent note. A drop down menu will appear. Select the choice “Export.” When the export dialog appears, select OPML, then just copy that text.

When you paste the OPML text into Tinderbox, a top level note is created with the OPML text in the note.

When you paste the OPML text into Tinderbox, a top level note is created with the OPML text in the note.

Open Tinderbox and paste the OPML text wherever you need it. Tinderbox creates a new container note with the OPML text as the note content (let’s call this the OPML container note).  Within the OPML container note is another container note (let’s call this the parent container note), which correlates to the parent note from Workflowy; within this parent container note are the child notes. See below:

The original Workflowy parent note becomes a container note in Tinderbox, holding the original Workflowy child notes. Note text from Workflowy are also imported as the note text of these Tinderbox notes.

The original Workflowy parent note becomes the parent container note in Tinderbox, holding the original Workflowy child notes. Note text from Workflowy is also imported as the note text of the corresponding Tinderbox notes.

If you gave the items in your Workflowy outline some notes, those notes are imported into the Tinderbox notes as the note text. Here’s how this looks in Outline View of Tinderbox:

Outline view of the notes Workflowy notes imported into Tinderbox.

Outline view of the notes Workflowy notes imported into Tinderbox.

The one somewhat cumbersome aspect of this procedure is the redundant OPML container note, which you probably don’t need. You can eliminate this by copying the parent container note, pasting this where you want it in your Tinderbox document, and then deleting the original OPML container note.

Tinderbox now supports tags with a Tag attribute, but unfortunately Workflowy tags do not translate to Tinderbox tags. They just come in as part of the text. You can easily set up agents that will search for these Workflowy tags (just hashtags followed by the tag name as in #WorkflowyTag) and apply them to the Tag attribute of the notes in Tinderbox.

It is important for me to point out that this is a one-way process. There is not a way to keep notes in Workflowy and Tinderbox in sync. At least not one I know of.

By the way, Tinderbox does support Simplenote synchronization, but I’m not a fan of Simplenote and — at least in the past — I’ve found there to be some restrictions on how you can use the sync’d Simplenote notes in Tinderbox.

So that’s it. A simple and easy procedure. Now to put it into practice.

Outlining with Tinderbox 6 (6.2 to be precise)

The Outline View in Tinderbox may be the software's most under-appreciated feature.

The Outline View in Tinderbox may be the software’s most under-appreciated feature.

Tinderbox is such a remarkably versatile tool for managing information in great part because it provides you with several distinct views of your notes:

  • Map
  • Outline
  • Chart
  • Timeline

Map view is probably Tinderbox’s claim to fame. I know of no other application that gives you such a flexible digital canvas for displaying/organizing/managing your notes. In fact, Map view is so extraordinary that it can easily overshadow the other views offered by Tinderbox. Today I want to look more closely at Outline view, not in context of how it complements Map view, but in and of itself. In other words, just how good an outliner is Tinderbox?

Note: This overview is using Tinderbox 6.2.

Outline View

When Mark Bernstein, Tinderbox’s mad genius, took the application to version 6, he changed the entire user experience. Where in previous versions you would need to open a note to see its content, now Tinderbox looks, at least superficially, like most other two-pane outliners. It has the outline tree (Outline view) in the left pane, and the note contents in the right.

Note: In this review I use the terms note, headline (or heading), topic and item almost interchangeably. All refer to the text that makes up each node of the outline. When I’m talking about the information in the note, I will use the term content or note text.

In this overview, I will be pretending that the other views in Tinderbox don’t exist. That’s silly, I know. But I’m interested in conveying just how good Tinderbox is as an outliner.

Outlining 101

I’ve listed on this site in the past a set of criteria for judging outliners. The first of these is just how easy it is to bang out an outline. I want the application to “disappear” when I’m outlining. I don’t want to think about anything but the project at hand. That means I should be able to create headings and move them into their proper place in the hierarchy without removing my hands from the keyboard, and the strokes needed should be intuitive and easy enough to use that I don’t have to think about them. That’s the first test Outline view must pass. So let’s start by creating a new document.

When you create a new document, Tinderbox presents you with open tabs for Map View and Outline View. I've closed Map View for this example.

When you create a new document, Tinderbox presents you with open tabs for Map View and Outline View, and it gives you some helpful hints about just what to do next. I’ve closed Map View for this example.

Create outlines with ease

Tinderbox 6 uses a tabbed interface. When you create a new document, two tabs are created and open: Map view and Outline view. Map view is selected by default, so the first thing you need to do if you want to make an outline is switch focus to the the Outline view. Tinderbox indicates the view type with an icon and the word “Map” or “Outline,” which is a good thing because before you add anything to either view, they look identical — though version 6 does include some helpful hints in these otherwise empty spaces. For this article, I’m closing the Map view tab. Now, I can create my first heading just be beginning to type it. When I’ve finished, I press ENTER and Tinderbox suspends editing mode. When I press ENTER again, I get a new topic and am in editing mode, so that I can type the title. I continue this process as needed. If a topic should be a child of a previous topic, I just demote it with the TAB key. Change my mind, use SHIFT-TAB to promote the topic. Nothing extraordinary, but this is exactly how I want an outliner to behave. You can create sub-topics to as deep a level as you need.

Reorganize quickly and easily

Outlines rarely are created with exactly the structure I want, so I will need to re-organize the topics. Moving a topic up and down within its current level simply requires the UP or DOWN ARROW key in combination with the COMMAND key. I need to promote it before I can move it to a new parent topic. And, of course, I can use drag and drop to move headings around freely in my outline.

Familiar disclosure triangles

Tinderbox also features the familiar triangular disclosure buttons, so you can collapse and re-expand the various levels in your outline. While there is nothing unique about Tinderbox’s tools for building an outline, it is also surprising how often developers of outliners make it so much more difficult than this. Tinderbox passes this first test with flying colors. If it didn’t, I wouldn’t be writing about any of the rest of the app’s outlining features.

Outlining 201

Sophisticated outliners have advanced features. Tinderbox 6 has many of these, but not all of them (specifically, it is missing inline notes — that is, you can’t view the content of the note in the outline tree itself).


Before delving into Tinderbox’s slightly more sophisticated outlining features, I need to add some background about the software. Bernstein calls Tinderbox the “Tool for Notes.” Keep that in mind, because it explains how everything in the program centers around collecting, gathering, writing, managing and accessing notes. Most of the items you create in your outline will be notes (although you can also create agents and separators — more on these shortly). An understanding of just what makes up a “note” in Tinderbox is necessary for understanding how to get the most from Outline view. To get “notes” you have to get “attributes.”


Pretty much everything in Tinderbox is made up of attributes — think of this as the DNA of your information. Just like every living creature has unique DNA that makes them look and behave in specific ways, so to the attributes that compose Tinderbox notes dictate how they look and act. You don’t have to concern yourself with most of these attributes. Some of them you will manipulate without even knowing you’re doing so, such as the position in the outline, the content of the text of the note. Tinderbox automatically records these attributes, as well as information such as the date of the creation of the note. All the attributes that are by default a part of a note are called system attributes. You can also create your own “user” attributes, so that you can customize Tinderbox documents to your specific needs. Attributes matter for this discussion when you choose to make them “key” attributes. A key attribute is one that you select to display within the note pane along with the text of the note. In effect, these become database fields. So, for example, you can add a DueDate (system attribute) to your notes, or create a user attribute for holding a reference URL and make these a part of the ecosystem of your outline. If you’re sketching out a novel, you can make key user attributes for location or character features.

Click the plus sign in the notes pane to add key attributes to the note.

Click the plus sign in the notes pane to add key attributes to the note.

Adding and creating key attributes for your notes is easy. Just click the “+” button in the upper right of the notes window. Type in the name of the attribute you want to add as a key attribute. If it exists, it will automatically show up. If it doesn’t exist, you’ll get a dialog box asking if you want to create the attribute — you can then tell Tinderbox what kind of data it will hold: string, number, date, boolean, URL, etc…

If you try to create a key attribute that is not already an attribute, Tinderbox gives you the option to create it and select the type of data it will hold.

If you try to create a key attribute that is not already an attribute, Tinderbox gives you the option to create it and select the type of data it will hold.


Attributes will stick with your notes no matter which view you are in. You can add columns to your outline to display attribute values for each note, sort of spreadsheet-style. Select “Use Columns” from the VIEW menu and you’ll get a column management bar just above your outline.

Adding columns to your outline is easy.

Adding columns to your outline is easy.

Just press the plus sign in this column management bar to add a column. Press again to add a second… as many as you need. By clicking on the column title (which by default just says “attribute”), you can type in the name of the attribute you want to display. This makes it a lot easier to compare values across your notes.


One of the limitations with using an outline for organizing data is that a note often belongs under more than one heading. Tinderbox allows you to create aliases of your notes, so the same note can appear in multiple places. Changes made in one of the aliased copies, will be reflected in all of them. Tinderbox distinguishes between the original note and the alias by making the alias title italic. In many outliners, this feature is known as cloning.


Checkboxes in an outliner are not a high advancement, but not every outliner has them, so I want to make sure to mention that Tinderbox does. Just select “Use Checkboxes” from the VIEW menu. The implementation isn’t too sophisticated, however, as you can’t apply checkboxes to individual notes… it’s the whole outline or not at all. This is a small, but legitimate issue, I think. A checkbox in a list is a handy way of indicating what is a “task” and what is not. If every item has a checkbox, this doesn’t work so well. There are other ways around this, though; for instance creating a prototype (more on prototypes below) note called “task” which would have a different color value or badge (more on badges below) than the other notes. As with so many aspects of Tinderbox, the application has an interesting wrinkle relating to checkboxes. Every note has a “checked” attribute. If you create a column for “checked”, you can run your checkboxes in a straight column, instead of along the left side, among all the other little icons. This can be cleaner and easier to view.

This screen detail demonstrates the two ways you can include checkboxes in your outline. Of course, you would never need to use both.

This screen detail demonstrates the two ways you can include checkboxes in your outline. Of course, you would never need to use both.


Another nice feature of the Tinderbox Outline view is that you can choose from several different badges — specialty icons — that appear just to the left of the note title. For example, select a red flag badge for urgent items. You can see the red and yellow flag badges in the screenshot above.

Special Tinderbox Features

Tinderbox is jammed with features. I’m going to mention a few here that can turbo-charge the outlining experience.


A very useful feature of Tinderbox’s outlining function is the ability to add Separators. A Separator is a special note you create to act as a fence separating different sections of your outline. If you’re planning a novel, say, you may use separators to create sharp visual divides between your plot outline, your character list, your location list, and your research notes. Any note can become a separator, but you’ll probably want to create notes just for this purpose. After you create a new note in your outline, open the Inspector Window (command-1). Select the properties inspector tab (the number 4 in a box), then check the option for “Separator.”

The Properties tab in the Inspector allows you to set a note as a prototype, template or separator.

The Properties tab in the Inspector allows you to set a note as a prototype, template or separator (or leave it as none of the above). You can also assign a prototype to the note with the drop down box.

When you mark a heading as a Separator, it takes on a special look in your outline (and disappears from any other view in your document — so you won’t see it if you switch to Map view — and you won’t see any of sub notes of the separator). The screenshot at the top of this article shows separators in use: Characters, Research and Prototypes & Agents.

Open in new tab

Hoisting in an outline means you can select a heading and its sub-heads and make the rest of the outline disappear. This is an especially useful feature with large and complex outlines, and ones that have deep hierarchy. It gives you the ability to focus on the section you happen to be working on, without the distraction of the rest of the document. Tinderbox does not have a hoist function in its Outline View (though the Map View works specifically by hoisting to different levels). But it has something even better. It lets you select a heading and choose to open it in its own tab. (Select the option from the pop up menu when you right click over the heading.) Now you can select that tab and work on that section of the outline, but you can also click back over to the tab showing the bigger picture for reference.

Correction: Alerted by Mark in the comments section, I see that I missed that Tinderbox does have a dedicated hoist view. Per Mark:

In the view menu, Focus view hoists the currently selected container (you can’t hoist a note with no children) in the current view; Expand view ‘un-hoists’ one outline level, reversing the process.

If you prefer a UI approach, double click the icon to the left of a container to hoist/focus it. To un-hoist/expand use the breadcrumb bar that shows at the top of hoisted views in the View pane (the left pane of the document window). Clicking on any breadcrumb un-hoists the current view to that level.

Thank you, Mark.

Icons convey information

You’ve probably noticed the little rectangular icons that live between the disclosure triangles and the text of the heading. These icons approximate the amount of text contained within each note. An empty square is a note without text. A rectangle with lines, means there is text in the note; the more lines, the more text. These icons will also tell you if the heading is an agent, by putting the heavier line at the bottom of the square, instead of at the top, as it does with notes.


I mentioned prototypes earlier. These are very handy for mass applying to many notes attributes you set up for one note. As an example, say you’re creating character reference notes, you might want to have key attributes for age, sex, and hair color. Create a “character” note and give it those key attributes. Then open the inspector window, on the in the properties inspector tab check the “prototype” option (see the previous properties inspector screenshot). Now, whenever you create or edit a note that is about a specific character in your story you can apply the “character” prototype (selecting it from the options in the pull-down menu in the properties inspector tab). Voila, it too will have those key attribute fields.

Selecting a prototype for the note, applies the properties of the prototype to the note. In this case adding key attributes for Age, Hair and Sex.

Selecting a prototype for the note, applies the properties of the prototype to the note. In this case adding key attributes for DueDate, Responsible, and Checked — this is a hypothetical outline for managing a project.


I hesitate to mention agents, because now we’re dipping our toes into a little more sophisticated Tinderbox functionality. Yet, an agent can be really handy for helping you get a grip on your outline, and you don’t need complicated routines. Agents in Tinderbox can perform all kinds of cool things, but I’m only going to suggest the most basic use in this outline-centric article. Let’s get back to our novel project. In the outline, I’ve got scenes organized by chapter, but I want to see the list of scenes in a flat view and I want to see the dates these scenes take place to make sure my timeline makes sense. I’ve already created a prototype for scenes and applied it to all my scene headings. So I can create an agent that finds all the scenes for me.

This agent has a simple query that looks for all the notes in my outline that have the scene prototype applied to them.

This agent has a simple query that looks for all the notes in my outline that have the scene prototype applied to them. (Note, I usually add the prefix “Proto:” to my prototypes, just to make it easier to identify them. This is note required.)

Now I can choose to open just this agent and its newly gathered scene aliases in a new tab, where I can display a column with the dates the scenes are to take place.

I can use an agent to help me see in one place all the notes of one type (in this case, scenes), where I can also customize the view to see meta data relating specifically to those types of notes.

I can use an agent to help me see in one place all the notes of one type (in this case, scenes), where I can also customize the view to see meta data relating specifically to those types of notes. In this case, the date the scene takes place and the location.

Agents can do more than just collect other notes. They can perform actions on them. So, for example, if your outline relates to a project, you could create an agent that looks for any note that has a prototype of “task” AND a checked attribute value of false, and assign it with a red flag badge to make it clear which jobs are yet to be completed.

New export options

One of the things that used to hold me back from using Tinderbox for outlining was the baffling process for exporting notes. It involves creating a template for the way you want the notes to look after export. Tinderbox wizards don’t seem to have trouble with this, but I never could really get my head around the process. Fortunately, the latest version of Tinderbox, edition 6.2, includes more pre-made options for exporting your whole document or just parts of it. Here are the options:

  • HTML – which still baffles me. It creates a bunch of files like a website, but when I try to open them it says it can’t find the template. This lack of understanding is definitely a failing on my part to work very hard to get it. I’m sure the solution isn’t very complicated.
  • Outline – which exports just the headings in a hierarchically formatted text file.
  • Text – which allows you to export the whole file or parts of it in one of several different formats, including RTF, OPML or Scrivener.

The Text export option is the one that I find useful. In fact, I’m writing this article in Tinderbox and exporting it as a plain text file to import into WordPress.

The Bottom Line

On my 11” MacBook Air, the tiny screen real estate available to me makes the Outline view far more useful than Map view. That’s what has prompted me to write this exploration of Tinderbox as an outliner. I’d hardly recommend you spend the money just to use Tinderbox for outlining (although, back in the day, a great outliner like GrandView cost more than Tinderbox does today, so it is all relative).

I was going to end this overview by saying that Tinderbox is not the world’s best Mac outliner. But I’ve changed my mind. I think it is the best, when you consider all it has to offer — and I don’t mean Map view (that’s a whole additional benefit, like cosmologists discovering multiple universes). Most two-pane outliners have nice editing windows for writing your notes, but usually have rudimentary outline functions in the tree-pane. Dedicated outliners have strong outlining capabilities, but crude note-taking features at best. Tinderbox combines a powerful dedicated outliner with a good note-taking editor AND throws in database features. This makes Tinderbox unique.

Does this mean it is the best choice for everyone? No. If you’re looking for a lightweight, efficient tool for creating simple outlines, then you may be happier with the nifty OutlineEdit app (which has some terrific features, and more on the way). If you love the column feature in Tinderbox, OmniOutliner does it better. But no other outliner I’m aware of does what I can do with Tinderbox. Oh, yeah, and then there’s Map view.

Tinderbox update available

From Mark Bernstein, developer of Tinderbox:

Tinderbox 6.1.3 includes a brand-new Help menu item, Getting Started With Tinderbox, which provides a detailed walkthrough for new Tinderbox users. The walkthrough explore outlines, maps, the new Attribute Browser, agents, and lots more, all in the context of an actual Tinderbox task.  There’s also a new Badge Picker, hundreds of new badges, and lots of additional polish.