PinmanPinman
Menu

Chapters · Chapter 6 of 8

Switch configurations with Profiles

Check Profile status, preview changes, and apply complete configurations across multiple applications.

About 8 minutesBasics Tutorial 1.0.0
Joining here?

Stop Pinman, run this command, then start Pinman again. It rebuilds the sample project up to this point, discarding any work you have already done in it.

pinman tutorial goto profiles
View

What to expect#

So far you've used Pinman to watch what happened as you worked on the workstation. You now have two good configurations—the Video Editing settings and the Final Recording settings. You can collect those settings into separate Profiles that make it easy to switch between them.

Rather than walk through Profile creation here, they've already been prepared and included in this tutorial, so you can go straight to using them.

Steps#

Profile status#

  1. From the main navigation, select Profiles to open the Profiles page.

The Profiles page contains the saved Profiles for this project. Some report In sync and others report Drift, as shown below.

Profiles showing In sync and Drift statuses

A Profile is a fixed set of target values; it does not change on its own. In sync means every target matches the live settings, while Drift means at least one differs. For example, Final Recording reports In sync because the live settings match the Profile's target values.

These Profiles correspond to states from the tutorial:

  • Video Editing: starting settings
  • Video Recording: prepare drift settings
  • Final Recording: optimize drift settings

You can open a Profile to see for yourself.

  1. Select the Final Recording Profile to open its Preview.
  2. The Preview shows the target properties and values in that Profile. It reports In sync, so there's nothing to change. Select Cancel to close it.

Now take a look at the Video Editing Profile.

  1. Select the Video Editing Profile to open its Preview.
  2. The Preview shows that some target settings differ from the Head, and would be changed if you applied the Profile. Leave the Preview open for the next step.

The following screenshot shows the Video Editing Preview with its current and target values:

A preview of the Video Editing Profile shows current and target values

Applying a Profile#

Let's apply the Video Editing Profile to switch back to that configuration.

  1. With the Video Editing Preview still open, check Disable read-only for this action.
  2. Select Apply, then close the Preview.

Video Editing now reports In sync, while Final Recording reports Drift. Open Explore to inspect the result.

  1. Select Refresh to bring the Head up to date.
  2. The properties we've been tracking now match their earlier values.

Comparing with an old Capture#

Compare the Head against your first Capture (#1), the Video Editing baseline. The tracked settings agree.

  1. In the Explore toolbar, leave the Source as Head but change the Reference Capture to the first one.
  2. The only differences are the codec changes, which the Profile doesn't manage. The other application properties now match the baseline.

The following screenshot shows the Head compared with the first Capture:

Exploring Head versus an older Capture (#1)

  1. Before leaving Explore, select RETURN TO HEAD in the alert above the tree. This restores the default comparison of Head against the latest Capture.

    If any filters are active, such as Changes only, open Filters in the toolbar and select CLEAR ALL FILTERS.

Now switch the configuration back to Final Recording.

  1. Go back to the Profiles page and select the Final Recording Profile.
  2. Check Disable read-only for this action, select Apply, then close the Preview.

Editing Profiles—advanced#

On the Profiles page, the Edit icon on each Profile lets you see and edit its target property paths and values in a grid view, or view and edit the Python script directly.

  1. Go to the Profiles page and select the Edit icon on the Video Editing Profile.
  2. This opens the grid view of target paths and values.
  3. Select the Script tab to see the Profile's source code.

The following screenshot shows the Profile's target values in grid view:

Editing a Profile in grid view

What we did#

Profiles collect related target values across applications into reusable configurations.

You checked the saved Profiles for drift, applied one to switch the machine's configuration, confirmed the switch in Explore, and switched back. With a couple of clicks you moved multiple related settings across several applications. A Pinman Profile coordinates a complete working configuration, not one application's preset.

Pinman tracks more than files and the data inside them. Next, let's look at the Windows Registry and Windows runtime settings.