{{ Project | Perforce Quick Look |
curator = Matt Attaway |
path = //guest/matt_attaway/p4quicklook/ |
download = //guest/matt_attaway/p4quicklook/|
language = Shell |
license = BSD }}
=== 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.
{{ License | BSD | 2012 | Matthew Attaway }}
{{ RecentChanges | //guest/matt_attaway/p4quicklook/ }}
[[Category:Perforce]][[Category:OS X]]