Requires Safari 5.1 or higher. Not a Safari user? Get Pickpocket for Chrome.
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.
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.)
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.
Using the action menu
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)
|Command-Shift-P||Execute toolbar button action|
|Command-Control-P||Add current page to Pocket|
|Shift-Option-P||Archive current page (if opened by Pickpocket)|
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.