Exporting notes from DEVONthink to Tinderbox

I’ve written a script that exports all selected DEVONthink records as individual notes to Tinderbox:

I’ve already mentioned this script in the DEVONthink forums but I’d also like to announce it here.

The script was originally written to transfer individual PDF annotation notes (like the ones in the below screenshot) from DEVONthink to Tinderbox. These annotation notes were created by my DEVONthink Notes from PDF Annotations script. However, the script should work with any kind of DEVONthink record.

In DEVONthink, one can simply select all note records (or groups of records) to be exported and run the script, e.g. via the DEVONthink Scripts menu. This will create corresponding notes in your front Tinderbox document:

For each created note, the script transfers a rich set of metadata, like the record’s tags, flag, rating, color & label as well as annotation info. For research documents & their annotation notes, the bibliographic metadata & formatted citation (e.g. fetched by my other script mentioned above) will also be transferred to appropriate Tinderbox attributes:



In addition, the script will add deep links to point back to the corresponding record in DEVONthink (and, for annotation notes, to the accompanying PDF annotation & file). Also, DEVONthink Wiki links will get converted to Tinderbox links.

The many exported attributes are helpful, for example, when using columns in a Tinderbox outline:

The script can be run multiple times for the same DEVONthink record(s) without creating duplicate notes in Tinderbox. This can be useful if you want to update, say, the note text, flag, rating or label color for existing notes.

There have been several other approaches to transfer note records (esp. PDF annotation notes) from DEVONthink to Tinderbox (see e.g. here, here, here or here). The above script makes this a one-step process, and allows to transfer many attributes, including the annotation’s highlight type, color, label, PDF page location, deep link and comments.

11 Likes

I saw that nobody had commented yet – this looks fantastic and also a huge amount of work. I look forward to trying it out when I have some breathing space!

1 Like

Seconding @macgarvin’s points here, this looks magnificent @msteffens, and as soon as I have breathing space to look into it, I’m keen to see your approach - I like the metadata preservation (my dirty scripts only preserve metadata I needed, and was also worried about drift between disk files, Tinderbox, and DEVONthink’s different interpretations and syncronisation), Thanks for this!

1 Like

You are awesome Matthias!!

2 Likes

Many thanks to you all for the kind feedback!
Let me know if some aspects don’t work for you.

And I’m sure the script can be improved further. For example:

  • write the URL of the created Tinderbox note back to the corresponding DEVONthink record
  • allow to specify which metadata / custom metadata shall be transferred
  • offer to auto-fetch bibliographic metadata (as the other script does)
  • maybe even allow for an (optional) two-way sync

Some more concrete feedback. I was able to get this up and running no problem. As somebody who rarely uses scripts, and who likes a lot of handholding when doing something unfamiliar it would useful if it said that you can just drop it anywhere in the scripts folder, or even create a new folder like ‘Steffens Scripts’. (Once you start using in Tinderbox you instantly understand what’s going on, but not before). Strongly recommend that you advise peolle install your other script, if they have not already done so, otherwise the result of this script in Tinderbox could look a bit disappointing. It would be useful if you created a ‘toy’ DEVONthink database (ten records?) which displays all the necessary features that make you excited about this tool, and a toy Tinderbox file which shows the utility of the procedure.
What excites me about this is that what DEVONthink doesn’t do well - for me - is help visualise data, and that’s where Tinderbox scores. Doing the reverse ferret of TB>DT could also be an exciting extension of capabilities, but I can imagine would be a big commitment. Sometimes getting the implementation of an idea to work takes up a huge amount of time, but then you find that the idea isn’t so useful after all! On the other hand it can be amazing. To that end I will email you a TB file (it breaks down a complete copyrighted book, so can’t post here) that is structured by links automatically created (thanks to Michael Becker) and where viewing in hyperbolic mode keeps me absorbed for a while!

1 Like

Many thanks for the great feedback & your suggestions, @macgarvin!

It’s great to hear that you could get it running w/o problems.

For the “DEVONthink Notes from PDF Annotations” script, I’ve made a short screencast that shows the install process and how the script works. The install process is identical for this script, but I should probably go ahead and make a similar screencast for this script.

Thanks for your suggestions re. the install documentation, I’ll try to incorporate these into the Readme.

Also very good points on promoting the two scripts together and on offering sample files for DEVONthink and Tinderbox that can be used to demonstrate the features of these scripts!

2 Likes

The TB example showing how you can really make hyperbolic mode sing will be lurking somewhere in your email folders - ie didn’t bounce back - if you haven’t already seen it already - Mac

1 Like

Many thanks @macgarvin, I got your email and TB example, nice work!
The visualisation capabilities in Tinderbox are definitely one of the reasons why it makes sense for DEVONthink users to further work with their notes in Tinderbox.