Pinboard-to-OpenMeta | Saves Pinboard bookmarks as local webloc files | Continuous Backup library

First, put the script somewhere you can leave it, preferably somewhere in your system path. That's not a huge deal, though, because you'll be supplying an absolute path in most automation cases anyway. Once you have it situated, open Terminal and run chmod a+x /path/to/your/script.rb. Now you can run the script from the command line to configure and test. When you run the script the first time (do it from the command line with /path/to/script/getpinboard.rb), it puts a configuration file at ~/getpinboard.yaml. It will let you know exactly where it is, and will automatically open it in your text editor. You must edit the configuration settings before you're ready to run it again. The configuration has options for all of the main features of the script, so these instructions are also going to be the tour. You can edit any of these options at any time. Note that the next time you run the script it will pull in up to 500 of your bookmarks, starting with the oldest. If you decide you didn't like a setting, you may want to trash those files and the database and start over. Try not to let that happen. user and password (string) : Set these to your Pinboard credentials. dateformat (string) : Leave this as 'US' if your local date format is mm-dd-yyyy. Set it to 'UK' if your date format is dd-mm-yyyy. target (absolute path) : This is where the webloc files will be collected. It works great with a Dropbox folder, but put it anywhere you like. On my system, I have my ~/Library/Caches/Metadata/Tags/Bookmark folder (where Tags.app stores its tagged bookmarks) symlinked to ~/Dropbox/Sync/Bookmark. That Dropbox folder is my target for the script, so I'm saving my Pinboard bookmarks to my Tags folder and still syncing them (and their OpenMeta tags) to my other computers. Further Tags integration will be covered at the end of the options. : If a folder specified in the config is missing, the script will attempt to create it. db_location (absolute path) : This is the location of the bookmarks database. The filename will be bookmarks.stash, and it's perfectly fine for it to exist in the same folder as you set for your TARGET. pdf_location (absolute path) : If the PDF_TAG below isn't set to false, this is where PDFs of bookmarks with that tag will be created. This requires the latest version of Paparazzi! (which does run fine on Snow Leopard). tag_method (integer 0-2) : This determines how the OpenMeta tags will be applied. Use 0 to disable, 1 for Tags.app or 2 for the OpenMeta CLI utility. always_tag (string) : I like to mark my tags which come from bookmark services for top-level grouping. This setting defaults to "pinboard", but you can change it to anything (or leave it blank). update_tags_db (boolean) : If you're using Tags.app, you know you can tag a web page with it and it will remember the tags next time you visit that address. That doesn't work with external tools, though, because Tags keeps a separate database for those links. Setting this to true will let the script update the Tags database and keep everything in sync. create_thumbs (boolean) : If set to true, this feature will add custom icons to your webloc files using a screengrab of the website and the website's favicon. It looks great in icon and CoverFlow views. : This is another external requirement. To get thumbnails, you must have setWeblocThumb, a free utility for doing just that. The utility must be located at /usr/local/bin/setWeblocThumb. : Note that creating thumbs takes a typical 4-8k webloc file and makes it around 160k average. My bookmarks folder has nearly 200MB of bookmarks in it, tagged and thumbnailed. That's ok with me, but if you want to keep it small and agile, skip the thumbs. pdf_tag (string) : The string defined here will determine which bookmarks, if any, are also saved as searchable PDF files. Just use it as a tag and Paparazzi! will download the url in the background to the location you set above. debug (boolean) : Leave this off (false), unless you need a little more info about what's going on. It will use Growl and STDOUT to display progress if enabled. gzip_db (boolean) : I can't imagine the database file that this generates being large enough to worry about size, but this option will cut the disk space it requires significantly. I leave it off, but it's your choice.