Chapters · Chapter 3 of 8
Explore captured state
Drill from directories and files into individual settings, spotlight tagged items, and reveal nearby untracked files.
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 exploreWhat 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#
- 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.
- Expand Files → Production Workstation → applications.
- Expand the application folders:
media-encoder,presentation-app, andscreen-recorder.
The following screenshot shows the tree with subdirectories expanded.
Exploring data: XML and INI#
In Pinman, you can keep drilling down beyond directories and into the structure and properties of supported data files.
- Locate
encoding.xmland expand it to reveal itsVideoandAudiosections. - Expand each section to reveal the leaf properties within.
- Explore
presenter.iniandrecorder.inithe same way.
The following screenshot shows encoding.xml expanded in the tree, with the
current value beside each property.
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:
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:
- On the
screen-recorderrow, use Scan for untracked here. - Scan the newly revealed
bin,cache, andlogsfolders. - Repeat on
media-encoder, then on itsbinfolder. - Repeat on the
codecsfolder, then on theavailablefolder 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.
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.
Instructions#
-
Open Explore from the main navigation.
-
Expand Files → Production Workstation → applications.
-
Expand the application folders:
media-encoder,presentation-app, andscreen-recorder. -
Locate
encoding.xmland expand it to reveal itsVideoandAudiosections. -
Expand each section to reveal the leaf properties within.
-
Explore
presenter.iniandrecorder.inithe same way. -
On the
screen-recorderrow, use Scan for untracked here. -
Scan the newly revealed
bin,cache, andlogsfolders. -
Repeat on
media-encoder, then on itsbinfolder. -
Repeat on the
codecsfolder, then on theavailablefolder it reveals.






