Configuring P4V Preferences

To configure settings for P4V, go to Edit>Preferences... (Windows) or P4V>Preferences... (Mac). The Preferences dialog includes the following configuration pages:

Click Apply to save your changes. Click OK to save your changes and exit the dialog.

Note on local versus centralized P4V preferences. Many P4V preferences can be defined or disabled centrally using the Perforce service. For example, an administrator can disable the Labels tab centrally, and you cannot override this setting in your local P4V preferences to make the Labels tab available. These centralized settings are specific to a Perforce service, so if you switch your connection to a different Perforce service during a P4V session, you may see different behaviors after you open the new connection. For example, if Perforce service A has enabled the Labels tab and Perforce service B has disabled it, the Labels tab will become unavailable when you switch your connection from service A to service B. Note also that there are performance-related preferences (such as those on the Server Data page) that can be set centrally using the Perforce service. If these centrally-set performance preferences differ from your local preferences, your local settings will continue to appear in the Preferences dialog, even though the central preferences are overriding them.

Connections

You can configure the following settings for connecting to Perforce services:

When the application launches:

Opening and closing connections:

Streams

To configure the way P4V handles workspaces when you perform stream operations, select one of the following:

Server Data

You can configure how much data P4V processes during a session to minimize server load for frequently-run commands and large data transfers:

Behavior

You can configure the following general P4V user interface behaviors.

Prompts:

Drag and drop:

Merge-Integrate

You can configure default behaviors for the Merge-Integrate dialog.

Click Restore Defaults to change the settings back to Perforce's defaults.

For more information about these options, see Merging Files Between Codelines.

Integrate Flags

Integrate flags can be applied when the Merge/Integrate and Branch dialogs run the p4 integrate command. You can configure these integrate flags to be applied by default.

These integrate flags are applied with different Perforce commands, depending on the dialog, integration method, and Perforce Server (P4D) version:

Dialog Condition Command Available Flags
Merge/Integrate Stream-to stream method p4 merge None
Merge/Integrate Branch mapping and Files and Folders methods p4 integrate All
Copy Command available only with Perforce Server 2011.1 and up p4 copy -v
Branch Perforce Server 2010.2 and earlier p4 integrate -v
Branch Perforce Server 2011.1 and up p4 populate None

For more information about these Perforce commands, see the Perforce Command Reference.

Copy

You can configure default behaviors for the Copy dialog.

Click Restore Defaults to change the settings back to Perforce's defaults.

For more information about these options, see Merging Files Between Codelines.

Branch

You can configure default behaviors for the Branch dialog.

Click Restore Defaults to change the settings back to Perforce's defaults.

For more information about these options, see Creating Branches.

Double-click

You can select what you want to happen when you double-click various object types in P4V. Select a double-click behavior for an object by clicking in the Double Click Behavior column to open a drop-down list. The behaviors available for selection in the drop-down list depend on the object.

Click Restore Defaults to return all objects to their default setting, which is always the first selection in each drop-down list.

Shortcuts

You can enter keyboard shortcuts for commands used in the main P4V window, Revision Graph viewer, Folder Diff utility, and Time Lapse View.

To enter or edit a shortcut:

  1. In the Shortcuts for drop-down, select the shortcut type:

    Only shortcuts for the selected window, viewer, or utility show in the shortcut list.

  2. Click the Shortcut column for the command.

    You may need to scroll the list window to the right to view the Shortcut column.

  3. Enter the keyboard shortcut in the edit field.

    Shortcuts must include either the command key, control key, or a function key

  4. Click OK.

Some commands come with default keyboard shortcuts. You can restore all defaults by clicking Restore Defaults, or set an individual command to use a default by selecting the command row and clicking Use Default.

Logging

You can configure the following logging options:

Log pane options:

Logging to a file:

Display

You can configure the following P4V display and localization options:

Application:

Localization:

Files and History

You can configure the way P4V displays files and file icons:

Features

You can enable or disable the following features. When you disable a feature, the tabs and dialogs associated with the feature no longer display in P4V.

Features:

Menu options:

All of the above are enabled by default. You must restart P4V for changes to take effect. For information about these features, see the appropriate section of the P4V help.

Tools

You can configure the following Revision Graph and Time-Lapse View options:

Revision Graph:

Time-Lapse View:

Image Timelapse

Default revisions to retrieve for Image Time-lapse View: Specifies whether you want P4V to prompt you for the number of revisions to view when you use Time-lapse View, whether to limit the retrieved revisions to a certain number, or whether to view all revisions. You can improve performance by limiting the number of large image files retrieved at a time.

Image Time-lapse View Filetype Associations: Specifies whether you want to open files as images in Time-lapse view, and which image types to view as images. You can improve performance by limiting image rendering in Time-lapse view.

File Editors

To associate file types with the applications you use to edit them:

  1. Click Add.
  2. Select a file extension from the drop-down list.
  3. Enter or browse for the associated application.
  4. (Optional) Select Always use the selected application to open files of this type to set the application as the default.
  5. Click Save.

You can enter as many applications as you like for each extension. All of the applications will appear as options when you context-click a file in P4V and select Open With.

Note. Any application that you've used to open a file from the context menu in P4V appears by default as an associated application on the File Editors page in the Preferences dialog, unless you remove it.

Diff

To set the default diff application, select one of the following:

  1. P4Merge: Perforce's companion diff tool.
  2. Other application: Browse to your preferred diff tool.

    To specify arguments for third-party diff applications, enter %1 for the name of the first file and %2 for the name of the second file in the Arguments field. Perforce replaces these placeholders with the actual filenames when calling the diff application.

To assign diff applications by file type:

  1. Click Add.
  2. Select a file extension from the drop-down list.
  3. Enter or browse for the associated application.
  4. Specify arguments for third-party diff applications in the Arguments field:

    Enter %1 for the name of the first file and %2 for the name of the second file. P4V replaces these placeholders with the actual filenames when calling the diff application.

  5. Click Save.

    The extension and associated application are displayed in the list of file type-application associations.

Merge

To set the default merge application, select one of the following:
  1. P4Merge: Perforce's companion merge tool.
  2. Other application: Browse to your preferred merge tool.

    To specify arguments for third-party merge applications, enter the following replaceable parameters in the Arguments field:

    Perforce replaces these placeholders with the actual filenames when calling the merge application.

To assign merge applications by file type:

  1. Click Add.
  2. Select a file extension from the drop-down list.
  3. Enter or browse for the associated application.
  4. Specify arguments for third-party merge applications in the Arguments field:

    Enter the following replaceable parameters in the Arguments field:

    Perforce replaces these placeholders with the actual filenames when calling the merge application.

  5. Click Save.

    The extension and associated application are displayed in the list of file type-application associations.

Applets

Your administrator can enable Perforce services to serve applets that can run in P4V. In order for these applets to run in P4V, you must enable applets in your P4V preferences. For more information about Perforce applets, see the Perforce JavaScript API for Visual Tools Users Guide, or consult your Perforce administrator.

To enable Perforce applets to run in P4V:

  1. Select Allow Perforce applets to run in P4V.
  2. Specify the Perforce services from which you are willing to accept Perforce applets:
  3. Click Advanced...to specify the following settings: