Pickpocket

Requires Safari 5.1 or higher. Not a Safari user? Get Pickpocket for Chrome.

Pickpocket lets you access, search, and open links from your Pocket, Delicious, Kippt, or Google Bookmarks account without needing to visit the site.

The extension has two basic modes of operation; I’ll call them list mode and tabs mode.

In list mode—the default mode—clicking Pickpocket’s toolbar button will open a popover containing a list of Pocket links. Initially, the popover will list all of your unread (or, more accurately, unarchived) links.

screenshot
The list-mode popover showing unread links

If you type something in the search bar at the top of the popover, Pickpocket will list all the links—read and unread—that contain what you typed in their titles, tags, or URLs. The search feature works just like that of Moofmarks, so please read that page for more details about search.

In tabs mode, when you click the toolbar button, Pickpocket will simply open all of your unread links in new tabs. (If you have more than 10 unread links, the extension will ask you to confirm opening them.)

In either mode, when you open (or close, depending on the appropriate setting) an unread link’s tab, Pickpocket will ask you whether you want to archive the link. If you say yes, it’ll tell Pocket to mark the link as read, which moves the link from your queue to your archive. Optionally, you can set Pickpocket to always archive (or not archive) closed links without asking. (See Controlling link archival, below.)

screenshot
The link archive-on-close confirmation dialog

Finally, Pickpocket also provides various ways to add a link to your Pocket unread list. (See Adding links to Pocket, below.)

How to use

When you install Pickpocket, the extension will prompt you to authorize it to access your Pocket account. This is a one-time process unless you need to change the Pocket account Pickpocket uses.

Using list mode
  • To open a link in list mode, either click it, or use the up/down arrow keys to select it and then press Enter. The link will open in a new tab, unless the current tab is empty.
  • If you hold down the Shift key while clicking a link or pressing Enter, Pickpocket will open the link in a background tab and keep the popover open.
  • To search your links (including archived ones), type something in the search bar at the top of the popover.
  • To list all of your downloaded links (including archived ones), type Delete (Windows: backspace) in the search bar while the bar is empty. (Note, however, that depending on the download limit that has been set in the extension’s options, this may not include every link in your Pocket account.)
  • To open all your unread links at once, press Command-Enter (Windows: Ctrl+Enter).
  • To archive a link without opening it, either click the green checkmark button to the right of its URL, or press Command-Delete (Windows: Ctrl+Backspace) while the link is selected.
  • To delete a link, either click the red “x” button to the right of its URL, or press Command- Shift-Delete (Windows: Ctrl+Shift+Backspace) while the link is selected.
  • If you want a link to stay in the unread list after it has been archived, you can pin it. To do so, click the pin button to the right of its URL. Depending on the state of the setting “Keep in new item list”, this icon may be a star instead of a pin.
Using tabs mode

To switch to tabs mode, open Pickpocket’s settings (click the gear icon in the list mode popover) and set the option group labeled “When I click the toolbar button” to Open unread links in tabs.

Click the toolbar button to open your unread Pocket links in tabs. If you have more than 10 unread links, Pickpocket will prompt for confirmation before opening them. By default, Pickpocket will open the links in the current window, but there is an option in the settings to open them in a new window instead.

The action menu (available in the Mac version only) lets you choose the operation mode each time you click the toolbar button, instead of always opening the popover or always opening unread links in tabs. To enable the action menu, go into Pickpocket’s settings (click the gear icon in the list mode popover) and set the option group labeled “When I click the toolbar button” to Show a menu of possible actions.

Controlling link archival

By default, when you open an unread link (in either operating mode) and then close its tab or navigate to a different page in the same tab, Pickpocket will ask you whether to archive the link. You can change this behavior in the settings popover (click the gear icon in the list mode popover).

If you’d rather Pickpocket just archived the link without asking, disable the option “Prompt for confirmation”. Note: This setting has no effect when you archive links directly in the popover. Such links are always archived without prompting.

Instead of archiving each link when you close its tab, you can have Pickpocket archive it when you activate its tab. If you’re opening just one link, it will be archived immediately. If you’re opening several at the same time, each will be archived when you activate its tab. If you choose this option, links will be archived without prompting.

You can also disable automatic archiving altogether. Just set the “Archive each opened link” setting to “Never”.

Finally, you can manually archive a link after opening it with Pickpocket, without having to reopen the popover. Just press Shift-Option-P while viewing the page belonging to the link. (This will only work in the original tab opened by Pickpocket for that link.)

Adding links to Pocket

There are few ways to add a link to your Pocket account.

From the list mode popover, clicking the + button opens the Add Link form popover. The form will be pre- populated with the current web page’s title and URL. You can edit these details and also add tags. Then, click Submit to upload the link to Pocket.

There is a context menu item to quickly add the current web page to Pocket. Right-click anywhere on the page (but not on a link or an image) and select “Add Page to Pocket” in the context menu. A link for the page will be immediately added to your account, and a confirmation popover will appear. This popover will go away by itself in three seconds, but if you click the OK button or press Enter or space before then, you can edit the just-added link in the Add Link popover.

Lastly, Pickpocket has a second toolbar button for quickly adding links, but this button is hidden by default. To enable it, right-click your toolbar, click “Customize Toolbar…”, and then drag the button labelled “Pickpocket Put” into your toolbar. Clicking this button has the same effect as using the “Add Page to Pocket” context menu item, described above. You can also long- click this button to go directly to the Add Link popover.

Keyboard shortcuts (for use while viewing a web page)
ShortcutDescription
Command-Shift-PExecute toolbar button action
Command-Control-PAdd current page to Pocket
Shift-Option-PArchive current page (if opened by Pickpocket)

Settings

To open the settings popover, click the gear button at the top-right corner of the list popover, or click the checkbox provided in Safari’s extension manager.

When I click the toolbar button
Determines what to do when you click the toolbar button.
Archive each opened link
Determines when links are auto-archived, if at all.
Keep in new item list
Determines what happens when you “pin” a link to the unread list, and how the extension determines whick links are pinned. “Favorites” corresponds to links marked as Favorites in Pocket.
Check for new links every [n] minutes
Pickpocket can check your Pocket account at regular intervals for unread links. If there are any, the number of unread links will appear as a badge on the toolbar icon. (Note: If the link check interval is set to 0, the toolbar button will not show a badge even if there are unread links.)
Download up to [n] links
By default, Pickpocket will only download the 1,000 most recent links from your Pocket account. You can raise this limit to as high as 10,000 at the risk of unacceptably slow search performance in the popover.
Reauthorize Pickpocket
If you want to change the Pocket account that Pickpocket uses, click this to restart the authorization process. Note that before using this link, you should be either logged out of Pocket, or logged in to the account you want Pickpocket to use.

2014 Canisbos Computing
Creative Commons License

Notes