Perforce Quick Look

About This Project
Perforce Quick Look makes it fast and easy to look up Perforce data in P4Web from any application on OS X. Just highlight a job or change number and press a hotkey to instantly bring up the full details of it.

Supported Platforms

 * OS X Lion and OS X Snow Leopard

To Install

 * Verify that you have the Perforce command line installed in /usr/local/bin


 * Download "Perforce Quick Look.zip". OS X will automatically expand it for you.


 * With OS X Lion/Mountain Lion:
 * Double click the "Perforce Quick Look" workflow in this folder & select "Install" from the resulting dialog


 * With OS X Snow Leopard:
 * From Finder press Shift+Command+G and enter ~/Library in the resulting dialog. Press "Go".
 * In Library create a folder named Services if it doesn't already exist
 * Drag "Perforce Quick Look" into the Services folder

Modify Settings
To change the P4Web and Perforce server that are used, open "Perforce Quick Look" in the Automator tool. By default it will be installed in ~/Library/Services. Double clicking "Perforce Quick Look" will launch Automator. The following variables must be set in this order:

1) URL to P4Web

2) Perforce server address

3) Path to p4 executable

4) The Perforce user to use

5) The browser to use

Configure a Key Binding

 * Go to Apple | System Preferences | Keyboard
 * Select Services on the left hand side
 * Find "Perforce Quick Look" on the right hand side
 * Click to far to the right of "Perforce Quick Look" to set a keyboard shortcut.

You will need to restart open applications for them to discover the "Perforce Quick Look" service.

To Use
In any application select text containing any of the following:
 * Change number
 * Job
 * Label name
 * Branch name
 * Client name
 * Depot path to a file or depot path ending in '...'

Press the keyboard shortcut you configured. The selected object will be shown in P4Web in Safari.

Example: A co-worker IMs you a job number to review. Select the text and then use your keyboard shortcut to view the job in P4Web.