This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Email to Tinderbox

As from v5.10.2, this feature is temporarily disabled, pending new network interface code. In the interim, it is suggested to use Simplenote sync. Simplenote includes a reliable email interface whose input can then be synched from Simplenote to Tinderbox.

The user may email data directly to a Tinderbox document. (This feature has particular interest for iPhone users, who can easily email snippets to key Tinderbox files)

A Tinderbox file may be connected to its own POP3 mailbox, which it will check when opened (and again when the Fetch Now button of the Network Status pane is pressed). The mailbox should be dedicated to this Tinderbox document, as it deletes messages after Tinderbox reads them.

A new Mail Preferences Pane in Document Preferences allows you to turn the current TBX document's mail checking on or off (default is off), and to specify:

Tinderbox creates a new container /Mail (i.e. at root level in the TBX), and adds new notes for each message in the mailbox. The notes are then deleted from the server (this is a natural by-product of using a POP3 server to draw down mail). Do not move or rename the container as Tinderbox will simply create a new container in the original location.

The $Email attributes of email notes contain the 'From' address of the email.

You may drag notes from /Mail and place them anywhere in your Tinderbox document - they are now Tinderbox valid notes.


You may choose to include an action, in your inbound email, that will set the new (emailed) note's $Container attribute on arrival. Thus, when Tinderbox receives an email it scans the subject and the message body for instructions of the form:

Tinderbox: /path-to-(or)-inbox-container 


Tinderbox: /path-to-(or)-inbox container [action code] 

The first argument (a path) specifies a container in which the mail is to be stored If the container does not exist, it will be created. The argument is a TB path string so can be anywhere within the TBX, as long as correctly specified, and not just as sub-containers of the default 'mail' container. If a TBX's note names are not unique it will be necessary to cite as much of the path to the target container as is necessary to give a unique path.

Tinderbox: /longer/unique/path/to/inbox 

From experiment with the Path parameter:

The optional second argument (action code), specifies an action that will be applied to the newly-created note. If the second argument is used, the first argument is mandatory; for the default location use the path '/Mail'.

An example, using both arguments:

Tinderbox: /UrgentMail [$Color="red";] 

will save the note in "UrgentMail" instead of "Mail", and will also set its $Color to Tinderbox defined colour "red". Note that in this case the use of the [ ] brackets is explicit, and isn't simply an editorial device to indicate the argument is optional. Put another way, you must use square brackets around the second argument otherwise Tinderbox can't parse out the action code and apply it as intended.

Possible relevant notes (via "Similar Notes" feature):

A Tinderbox Reference File : Import/Export/Formatting : Email to Tinderbox