Shelf¶

Provides a shelf for permanent storage of objects.

Summary
Available on macOS version	10.11, 10.12, 10.13, 10.14, 10.15, 11.6, 12.4
for Quicksilver build	4024, 4026, 4039

Shelf Plugin¶

Note: the Shelf Plugin must be installed in order for the Clipboard plugin to work correctly.

The shelf plugin adds a 'Shelf' for permanent storage of any Quicksilver item, which is persistent across relaunches. You can add any item to the Shelf, and retrieve it at any time.

Some examples of items you put on the shelf might be:

• Text you commonly type (like an email signature or boilerplate HTML code)
• Your best friend's email address
• A folder you commonly use
• URLs, making the shelf an alternative to your browser's bookmarks folder (which is usable across browsers)

Showing the Shelf¶

There are several ways in which you can show/activate the shelf:

1. Activate Quicksilver, and use the shortcut ⌘⌥S. This will automatically show or hide the shelf, depending on its current state.
2. From Quicksilver, selecting 'Shelf' in the 1st pane, and 'Show' as the action. This is useful for creating a trigger
3. If the Shelf is docked at the side of your screen, hover your mouse over it. For more info, see the 'Docked or Floating' section below.

Docked or Floating¶

The Shelf (and Clipboard) windows are called 'Docking windows' in Quicksilver terminology. They can either be moved to float anywhere on your screen, or docked to the edge of the screen (similar to how the Dock itself behaves when you turn on Dock hiding).

Where you place your Shelf window is up to you. If your Shelf is floating, then after use it will fade into the background. You can use options 1 and 2 in the 'Showing the Shelf' list above to open it.

If you dock your window, you can also show the window by hovering the mouse over the portion of the screen where your shelf is docked. This can be useful for dragging items onto the shelf, or for manipulating the shelf solely with the mouse.

Actions¶

Put on Shelf¶

Catalog¶

The Shelf plugin adds 3 items to your catalog (in one group), under the 'Quicksilver' tab.

Shelf & Clipboard¶

Shelf Contents¶

Clipboard Contents¶

Adding items to the Shelf¶

There are two ways to add items to your shelf. One is to use the 'Put on Shelf' action from Quicksilver; select an item in Quicksilver's 1st pane, and use the 'Put on Shelf' action. The other is to drag and drop an item from Quicksilver's 1st (or 3rd) pane straight onto the shelf.

Using items on the Shelf¶

You can use items on the shelf in several different ways

• Executing Actions : Double-clicking a shelf item (or pressing return ↩ on a selected item) will cause Quicksilver to use the default action for that item. For example: if your default action for text is "Large Type", when you double click a text item from your shelf it will be shown in Large Type. Alter your default actions in the actions preferences to alter this behavior.

• Dragging items : You can drag an item from the Shelf to an application. This will use the item in whatever way the receiving action sees fit. For example;

  • Dragging a text item from your shelf to TextEdit will make TextEdit paste the item
  • Dragging a URL from your shelf to Finder will make Finder create a file for that URL
  • If you drag a file from your shelf to Finder, Finder will move that file
  • Removing Items : you can remove items from your shelf by highlighting them, and pressing the delete (⌫) key, or by right clicking an item and choosing the 'Remove' option.

• Opening an item in Quicksilver : You can open an item in Quicksilver by right clicking and choosing the 'Open in Quicksilver' action, or by using the keyboard shortcut ⌘↩. This is useful if you want to execute a different command on the item on your shelf, or if you want to edit the shelf item.

• Using Shelf Items Directly within Quicksilver : Enabling the 'Shelf Contents' Catalog entry (see 'Catalog' above) means you can use the the items on your shelf from anywhere in Quicksilver (search for them in the 1st pane, or use them in actions in the 3rd pane)