Skip to content

Latest commit

 

History

History
73 lines (42 loc) · 4.54 KB

Documentation.mdown

File metadata and controls

73 lines (42 loc) · 4.54 KB
Raw

#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

: This is a shortcut for adding items to your shelf. See 'Adding items to the shelf' below.

Catalog

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

Shelf & Clipboard

: This entry adds the two 'shelf' and 'clipboard' items to your catalog, allowing you to manipulate them from the Quicksilver interface (e.g. Show, Search Contents) etc.

Shelf Contents

: Enable this item if you want the entire contents of your shelf to be available in Quicksilver's 1st and 3rd panes. That is - allowing you to manipulate an item on the shelf from Quicksilver

Clipboard Contents

: Enable this item if you want the contents of your clipboard available in Quicksilver, much like the 'Shelf Contents' entry

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)