Chapters · Chapter 3 of 8

Explore captured state

Drill from directories and files into individual settings, spotlight tagged items, and reveal nearby untracked files.

About 5 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 explore
View

What to expect#

You just captured a Checkpoint holding the current tracked application settings. Now let's use the Explore page to examine them. You'll drill down from folders to files, then into structured data files and their individual settings. You'll also broaden the view to reveal nearby files that the tutorial schema deliberately does not track.

Steps#

Exploring directories#

  1. Open Explore from the main navigation.

On the Explore page, you'll see these top-level nodes for tracked state:

  • Files
  • Registry
  • Windows Settings

Expanding a folder reveals its child files and subdirectories.

  1. Expand Files → Production Workstation → applications.
  2. Expand the application folders: media-encoder, presentation-app, and screen-recorder.

The following screenshot shows the tree with subdirectories expanded.

Expanded directories tree (full toolbar visible)

Exploring data: XML and INI#

In Pinman, you can keep drilling down beyond directories and into the structure and properties of supported data files.

  1. Locate encoding.xml and expand it to reveal its Video and Audio sections.
  2. Expand each section to reveal the leaf properties within.
  3. Explore presenter.ini and recorder.ini the same way.

The following screenshot shows encoding.xml expanded in the tree, with the current value beside each property.

Expanded XML data file in the tree

Structured data behaves like a directory tree: a file might contain sections, and a section contains settings. You should find values such as mode = rehearsal, frame_rate = 30, and Quality = preview.

Spotlighting tagged items#

Hovering over an item reveals additional actions and properties, including Zone and Program tags. For example, the Audio section within encoding.xml is tagged for the Audio program and the Production zone, as shown below:

Items can be tagged by Zone or Program

Select a Zone or Program tag to spotlight matching items; use filters for other properties.

Discovering untracked items#

So far you've explored items prescribed by the schema imported during project installation. When you created the Checkpoint, you set Scope to Tracked only, but you can still broaden the Head view without changing that Checkpoint.

A broadening rescan reveals one level at a time, so each newly revealed folder must be scanned in turn.

Hover over a directory row to reveal Scan for untracked here:

Scan for untracked here on the screen-recorder row

  1. On the screen-recorder row, use Scan for untracked here.
  2. Scan the newly revealed bin, cache, and logs folders.
  3. Repeat on media-encoder, then on its bin folder.
  4. Repeat on the codecs folder, then on the available folder it reveals.

As shown in the following screenshot, you can now see the inert helper executable, cache, recorder log, encoder DLL, and other untracked files. They were present on disk all along; the schema simply did not treat them as configuration.

Broadened directories now show untracked files

Scope and granularity answer different questions#

Scope asks which items belong in the view or Capture. Tracked only limits the view or Capture to items prescribed by the schema; discovery also includes nearby untracked items.

Granularity asks how deeply Pinman understands each included item. Files only treats each file as a whole; Files + settings also parses supported structured files into their individual settings.

What we did#

You used the schema as a map of important state, drilled into settings, and temporarily widened the live view to investigate untracked neighbors.

Now let's make some changes to the workstation's codec configuration.