Quick Start

The first thing you need to do is to import your del.icio.us bookmarks. Start by setting environment variables for your del.icio.us username and password:

export delish_user=user

export delish_pass=pass

And then import your bookmarks.

import_delicious

You can access these bookmarks with the delish command. See more below.

Once you have set the environment variables, you can update your bookmarks with

update_delicious

I recommend that you update as often as you add between one and ten bookmarks. Updating any more than ten bookmarks will be slow and inefficient.

delish

Conveniently access del.icio.us bookmarks from a local database via commandline

Usage

delish basic_search(advanced_search) display_only

`basic_search`

A string that should be in the url, the description, or the extended description. It is case insensitive and unanchored.

`advanced_search`

Advanced search allows searching by tags and/or creation date or access date. Advanced searches must be separated by colons.

Dates

Dates begin with a character specifying which date to check against. The character can be either a for accessed or c for creation date. Following this is an optional date specification type. If the type is left off it will be of day type. The date specification types include h for hour and w for week. Support for M (month), m (minute) and s (second) is planned for another release. After the date specification is the optional date search specification, followed by the amount of time to search. The date search specification can be a +, which means more than so much time, or a -, which means less than so much time.

display_only: This can be any string at all. It will basically cause the program to output the links that it would have opened if you had not provided the string. The idea is that you can run delish with some random character at the end, make sure the link is right, and then press up and backspace to get it to open the link(s).

Examples

HaRoLd: bookmarks containing the word harold in the url, description, or extended description.
(truby,rails): bookmarks that contain both ruby and rails tags.
(sru,ra): bookmarks that contain tags that start with ru and ra.
(iun,si): bookmarks that contain tags that contain un and si.
(aw-6): bookmarks that have been accessed within the past 6 weeks.
(ch+2): bookmarks that were created more than two hours ago.
(cd2): bookmarks that were created the day before yesterday.
ruby(truby,rails:sz:iyes): This will return any bookmarks with a description, url, or extended description containing ruby, a ruby tag, a rails tag, a tag starting with z and a tag containing yes.

TODO

“search” tags
zsh configuration section
Month, minute, and second support
Profile the code to increase speed
“Build Script”