ViewModels Reference¶

Every ViewModel class in PadForge: what it backs, what it exposes, and how state flows between the UI and the services layer.

v4 (2026-07-12): Refreshed for v4. Remote Link (DashboardViewModel + SettingsViewModel, and the RemoteLinkTrustedPeer / RemoteLinkNearbyPeer rows), the per-(slot, device) DeviceSlotConfig (renamed from PlayStationSlotConfig), KbmSlotConfig (SOCD / Snap Tap), multi-source mapping rows (MappingSourceItem), the mouse-gesture partial, and the Ember dashboard vocabulary all landed since the v3 rewrite. The HIDMaestro SDK surface, OpenXInput shim, thread-pool lifecycle, and bubble-up cascade live on HIDMaestro Deep Dive. If anything here drifts from the live source, the live source wins.

v4.1 (2026-07-30): The Nintendo output type (#215) joins the family. PadViewModel gains the Bass Shakers tab (#236), the slot SOCD card (#240), the flick rotation offset, gyro Acceleration, and the macro Layer dropdown. MacroItem carries the #238 / #253 fire-mode wave and per-macro layer scope (#254). Mapping rows and sources gain Flip Output, per-source Acceleration, and the #251 axis-latch macro actions. The Touchpad partial grows the libinput pointer Response, momentum, and pointer-region cards. DeviceSlotConfig adds synthetic touch pressure (#239) and the Switch home-LED lane (#226).

v4.2: The VR output type (#49) lands as VirtualControllerType.Vr (6), with a VrControllerIcon sidebar entry, a VrOutputSnapshot, and a SteamVR row in both driver-status surfaces (DashboardViewModel.IsSteamVrInstalled, plus the install / uninstall pair on SettingsViewModel). The pad page grows two slot-tier tabs: Bass Shakers at index 16 and Output at index 17 (SOCD plus Keep Controller Awake). DeviceSlotConfig gains headphone-jack volume, the DualSense audio-output path, and persona haptics, with MacroActionType.HeadphoneVolumeUp / HeadphoneVolumeDown (52 / 53) driving the volume. Sony headset head trackers get their own device class (HeadsetMotion, #188). RawHidState replaced the old ExtendedRawState, so the Extended snapshot is now RawHidOutputSnapshot.

v4.3: The mapping picker gains one shared per-slot choice list plus a search box and device-visibility filter (#322 / discussion #302), both on PadViewModel. Voice macros (#317) add the "Microphone" device class, the Voice Macros preview on DevicesViewModel, DeviceRowViewModel.ShowManageVoicePhrases, and MacroActionType.VoiceListenWhileHeld (54). MacroAction grows the pressure-scaled turbo block (#290). StickConfigItem grows stick trackball momentum (#291), the touchpad partial grows the shared momentum knobs, and PadViewModel grows the Gyro Tilt envelope (#292). The Dashboard's web-controller card gains a URL and QR (#296), its SteamVR row goes tiered (#287), and Settings gains the low-battery notification trio (#293).

v4.4: Head tracking moves from SettingsViewModel to DashboardViewModel, which also gains the Razer Chroma (#373), Logitech LIGHTSYNC (#382) and Razer Sensa (#374) enable-plus-status pairs. The Dashboard's driver-status strip is gone, leaving three bare installed flags and the full cards on Settings. DeviceRowViewModel gains ShowQuickCharge (#372), and IsInternalVirtual grows the handheld://, sensor:// and headtrack:// schemes. PadViewModel gains the ExtendedConfig reseed on a profile switch, the Grip option list and IsLoadingPadSetting (#392), the grouped MacroTypeCatalog picker, menu macro cells and .pficons icon packages (#390). The Profiles page gains external control (#366) and the per-profile polling override (#365).

All ViewModels live in PadForge.App/ViewModels/ (PadForge.ViewModels namespace). Built on CommunityToolkit.Mvvm (ObservableObject, RelayCommand).

ViewModelBase¶

File: ViewModelBase.cs

Abstract base class for all ViewModels. Extends ObservableObject (INotifyPropertyChanged, SetProperty).

public abstract class ViewModelBase : ObservableObject
{
    private string _title = string.Empty;

    public string Title
    {
        get => _title;
        set => SetProperty(ref _title, value);
    }
}

Property	Type	Description
`Title`	`string`	Display title for the view. Used by navigation and page headers.

Culture / Localization¶

The constructor subscribes to Strings.CultureChanged for live language switching. When the UI language changes, every ViewModel's OnCultureChanged() runs, letting derived classes refresh culture-dependent text.

Strings.CultureChanged uses a weak event pattern. Instance-method subscribers are stored as (WeakReference<Target>, MethodInfo) pairs, so short-lived ViewModels can be garbage-collected without unsubscribing. Dead entries are pruned on each raise. Static-method subscribers use strong references.

protected ViewModelBase()
{
    Strings.CultureChanged += OnCultureChanged;  // weak. No GC leak
}

protected virtual void OnCultureChanged() { }

NavControllerItemViewModel¶

File: MainViewModel.cs (defined alongside MainViewModel)

Sidebar entry for one virtual controller. Shows controller type icon, slot number, and per-type instance label.

Property	Type	Description
`PadIndex`	`int`	Zero-based pad slot index (0–15). Read-only.
`Tag`	`string`	Navigation tag (`"Pad1"`–`"Pad16"`). Computed as `$"Pad{PadIndex + 1}"`.
`SlotNumber`	`int`	1-based controller number among active slots.
`InstanceLabel`	`string`	Per-type instance label (e.g., `"1"`, `"2"`).
`IconKey`	`string`	Resource key for controller type icon (e.g., `"XboxControllerIcon"`, `"DS4ControllerIcon"`, `"NintendoControllerIcon"`, `"ExtendedControllerIcon"`, `"MidiControllerIcon"`, `"KeyboardMouseControllerIcon"`, `"VrControllerIcon"`).
`IsEnabled`	`bool`	Virtual controller enabled.
`ConnectedDeviceCount`	`int`	Mapped physical devices connected.
`MappedDeviceCount`	`int`	Physical devices assigned to this slot in config, connected or not. Lets the mini card split "assigned but awaiting" (idle) from "nothing assigned" (cold), the same split the Dashboard card makes. Added by commit `2006ac6b`.
`IsInitializing`	`bool`	Virtual controller initializing.
`IsVirtualControllerConnected`	`bool`	Live virtual controller is alive (created + reporting `IsConnected`). Drives the sidebar green-vs-yellow indicator so the slot stays green through the HM-inactivity grace window and only turns yellow once the timeout tears the VC down.
`IsCreateFailed`	`bool`	The slot's latest virtual-controller create attempt failed (engine createFailed latch). Distinct from awaiting devices, so the flame tooltip does not blame absent devices for a failed create.

Sidebar wiring: MainWindow code-behind rebuilds one wpf-ui NavigationViewItem per NavControllerItems entry on NavControllerItemsRefreshed (RebuildControllerSection / CreateControllerNavItem), and subscribes each item's PropertyChanged so SlotNumber, InstanceLabel, IconKey (matched as a plain string in UpdateControllerNavItemContent), IsEnabled, and the flame-state flags update the card in place.

MainViewModel¶

File: MainViewModel.cs DataContext for: MainWindow

Root ViewModel. Manages navigation state, 16 pad ViewModels, sidebar controller entries, and app-wide status.

Child ViewModels¶

Property	Type	Description
`Pads`	`ObservableCollection<PadViewModel>`	16 pad ViewModels (one per slot). Created in constructor.
`NavControllerItems`	`ObservableCollection<NavControllerItemViewModel>`	Sidebar items for created slots. Rebuilt by `RefreshNavControllerItems()`.
`Dashboard`	`DashboardViewModel`	Dashboard overview ViewModel.
`Devices`	`DevicesViewModel`	Devices list ViewModel.
`Settings`	`SettingsViewModel`	Application settings ViewModel.

Property	Type	Description
`SelectedNavTag`	`string`	Current nav tag: `"Dashboard"`, `"Pad1"`–`"Pad16"`, `"Profiles"`, `"Devices"`, `"Settings"`, `"About"`. Also notifies `IsPadPageSelected` and `SelectedPadIndex`.
`IsPadPageSelected`	`bool`	True if a Pad page (Pad1–Pad16) is selected. Computed.
`SelectedPadIndex`	`int`	Zero-based pad index for the selected Pad page, or -1. Computed.
`SelectedPad`	`PadViewModel`	PadViewModel for the selected Pad page, or null. Computed.

App-wide Status Properties¶

Property	Type	Default	Description
`StatusText`	`string`	`"Ready"`	Status bar text. Plain writes are info-class and decay after ~5 s (`StatusDecayMs`). Every write restamps the decay window.
`IsEngineRunning`	`bool`	`false`	Polling loop active. Calls `RefreshEngineStatus()`.
`HasActiveSlots`	`bool`	`false`	Any virtual controller slots exist. Calls `RefreshEngineStatus()`.
`EngineStatusText`	`string`	-	Computed localized text: `Engine_Forging` (`"Forging"`, engine running with active slots) / `Common_Idle` (`"Idle"`, running with no created slots) / `Common_Stopped` (`"Stopped"`). Note: this is the localized display text. `DashboardViewModel.EngineStateKey` carries the non-localized `"Running"` / `"Idle"` / `"Stopped"` key for XAML DataTriggers.
`EngineStatusBrush`	`Brush`	-	Computed: Red (#F44336) = Stopped, Amber (#FFB300) = Idle (engine running, no created slots), Green (#4CAF50) = running with active slots (the Forging state). Frozen (thread-safe).
`PollingFrequency`	`double`	`0`	Current polling frequency in Hz.
`ConnectedDeviceCount`	`int`	`0`	Connected input device count.

Commands¶

Command	CanExecute	Description
`StartEngineCommand`	`!IsEngineRunning`	Raises `StartEngineRequested`. Wired by MainWindow code-behind.
`StopEngineCommand`	`IsEngineRunning`	Raises `StopEngineRequested`.

Events¶

Event	Args	Description
`StartEngineRequested`	`EventArgs`	Start engine.
`StopEngineRequested`	`EventArgs`	Stop engine.
`NavControllerItemsRefreshed`	`EventArgs`	Raised after `RefreshNavControllerItems()` completes. MainWindow uses this instead of `CollectionChanged` to avoid rapid sidebar rebuilds.

Key Methods¶

Method	Description
`RefreshNavControllerItems()`	Rebuilds sidebar entries from `SettingsManager.SlotCreated[]`. Computes per-type instance numbers and updates each pad's `Title`, `SlotLabel`, `TypeInstanceLabel`. Raises `NavControllerItemsRefreshed` only when the active-slot set changed (add / remove / reorder). Property-only changes (icon, label, enabled) update in place without the event.
`RefreshEngineStatus()`	Notifies `EngineStatusText` and `EngineStatusBrush`.
`RefreshCommands()`	Notifies `CanExecuteChanged` on start/stop commands. Call after `IsEngineRunning` changes.
`SetStatus(string, bool persist = false)`	Writes the status bar with an explicit class. `persist: true` (failures, prompts a later write always terminates) exempts the message from the decay sweep until the next write.
`ClearDecayedStatus()`	Clears a decayed info message. Re-checks `IsStatusDecayDue` first, so a write that lands mid-sweep wins. Called from MainWindow's 5 s driver-status timer.

DashboardViewModel¶

File: DashboardViewModel.cs DataContext for: Dashboard page

Overview of all controller slots, engine status, connected devices, and driver status.

Slot Summaries¶

Property	Type	Description
`SlotSummaries`	`ObservableCollection<SlotSummary>`	Cards for created slots. Rebuilt by `RefreshActiveSlots()`.
`ShowAddController`	`bool`	"Add Controller" visible (any type has capacity).

Engine Status¶

Property	Type	Default	Description
`EngineStatus`	`string`	`"Stopped"`	Localized engine status.
`EngineStateKey`	`string`	`"Stopped"`	Non-localized state key (`"Running"`, `"Stopped"`, `"Idle"`) for XAML DataTriggers.
`PollingFrequency`	`double`	`0`	Polling frequency in Hz. Also notifies `PollingFrequencyText`.
`PollingFrequencyText`	`string`	-	Computed: formatted frequency (e.g., `"987.3 Hz"`) or dash when zero.

Device Counts¶

Property	Type	Description
`TotalDevices`	`int`	Total detected devices (online + offline).
`OnlineDevices`	`int`	Currently connected devices.
`MappedDevices`	`int`	Devices with an active slot mapping.

Driver Status¶

HIDMaestro ships inside the executable as a managed SDK, so it never had an install row here. The Dashboard's driver-status strip was removed on 2026-09-02. The full HidHide, Windows MIDI Services, and SteamVR cards live on Settings. What remains on DashboardViewModel are three bare flags with no status text of their own. MainWindow's periodic driver-status refresh writes all three.

Property	Type	Description
`IsHidHideInstalled`	`bool`	HidHide installed. Written by the status refresh. No Dashboard surface currently reads it.
`IsMidiServicesInstalled`	`bool`	Windows MIDI Services installed. A slot card's MIDI type button shows a "no" cursor and the `Main_MIDI_RequiresMidiServices` tooltip when false.
`IsSteamVrInstalled`	`bool`	SteamVR installed, which gates the VR slot type (#49). A slot card's VR type button shows a "no" cursor and the `Main_VR_RequiresSteamVR` tooltip when false. The tiered SteamVR status row (#287) lives on the Settings card, which reads the live statics itself.

DSU Motion Server¶

Property	Type	Default	Description
`EnableDsuMotionServer`	`bool`	`false`	DSU (cemuhook) motion server enabled.
`DsuMotionServerPort`	`int`	`26760`	UDP port. Clamped to 1024–65535.
`DsuServerStatus`	`string`	`"Stopped"`	DSU server status.
`IsDsuServerRunning`	`bool`	`false`	Serving truth for the DSU card flame (#175): the actual server lifecycle, not the enable checkbox. Set by InputService at the same points that write `DsuServerStatus`.

Command	Description
`ResetDsuPortCommand`	Resets `DsuMotionServerPort` to 26760.

Head Tracking (#355)¶

A UDP listener on OpenTrack's port plus a FreeTrack 2.0 shared-memory reader, surfaced as the Head Tracker device row. Each setter mirrors into the static PadForge.Common.Input.HeadTrackingRuntime that the poll thread's device sweep reads, so a write lands whatever its source (global load, profile apply, the user). The enable rides profiles as a nullable leg (ProfileData.EnableHeadTracking). Port, FreeTrack toggle, and the two ranges are global. These properties moved here from SettingsViewModel on 2026-09-02. MainWindow's Dashboard dirty-gate allowlist moved with them, so a head-tracking edit still marks the settings file dirty.

Property	Type	Default	Description
`HeadTrackingEnabled`	`bool`	`false`	Adds the Head Tracker row. Mirrors to `HeadTrackingRuntime.Enabled`.
`HeadTrackingUdpPort`	`int`	`4242`	Port OpenTrack's "UDP over network" output sends to. Clamped to 1–65535. Mirrors to `HeadTrackingRuntime.UdpPort`.
`HeadTrackingFreeTrack`	`bool`	`true`	Read the FreeTrack 2.0 shared memory as well. Mirrors to `HeadTrackingRuntime.FreeTrackEnabled`.
`HeadTrackingRotationRange`	`int`	`90`	Degrees of head rotation at full axis deflection. Clamped to 1–180.
`HeadTrackingTranslationRange`	`int`	`30`	Centimeters of head travel at full axis deflection. Clamped to 1–500.
`HeadTrackingStatus`	`string`	`"Stopped"`	The Head Tracker row's source line (which source is live, or why neither is). Pushed by `InputService` on the dashboard tick whenever the device's `StatusVersion` moves. Null coalesces back to `"Stopped"`.

Command	Description
`ResetHeadTrackingPortCommand`	Resets the port to 4242.
`ResetHeadTrackingRotationRangeCommand`	Resets the rotation range to 90.
`ResetHeadTrackingTranslationRangeCommand`	Resets the translation range to 30.

Vendor Lighting and Haptic Mirrors¶

Three optional vendor bridges, each an enable plus a status string that null-coalesces to "Stopped". All three landed on the Dashboard on 2026-09-02.

Property	Type	Default	Description
`EnableChromaLightbar`	`bool`	`false`	Razer Chroma lightbar mirror (#373).
`ChromaStatus`	`string`	`"Stopped"`	Chroma mirror status.
`EnableLightsyncLightbar`	`bool`	`false`	Logitech LIGHTSYNC lightbar mirror (#382).
`LightsyncStatus`	`string`	`"Stopped"`	LIGHTSYNC mirror status.
`EnableSensaHaptics`	`bool`	`false`	Razer Sensa HD rumble translation (#374).
`SensaStatus`	`string`	`"Stopped"`	Sensa translation status.

Web Controller Server¶

Property	Type	Default	Description
`EnableWebController`	`bool`	`false`	Web controller server enabled.
`WebControllerPort`	`int`	`8080`	HTTP/WebSocket port. Clamped to 1024–65535.
`WebControllerStatus`	`string`	`"Stopped"`	Web controller server status.
`IsWebControllerRunning`	`bool`	`false`	Serving truth for the Web Controller card flame (#175): actual server lifecycle, not the enable checkbox. Set by InputService alongside `WebControllerStatus`.
`WebControllerClientCount`	`int`	`0`	Connected web controller clients.
`WebControllerUrl`	`string`	`null`	The live server URL, `https://` when the secure lane bound (#296). Empty when stopped.
`WebControllerQr`	`ImageSource`	`null`	QR of `WebControllerUrl` so a phone opens the controller by scanning (#296). Null when stopped, which hides the image.
`HasWebControllerQr`	`bool`	`false`	Whether a QR is available. Drives its visibility.

Command	Description
`ResetWebPortCommand`	Resets `WebControllerPort` to 8080.
`CopyWebControllerUrlCommand`	Copies `WebControllerUrl` to the clipboard. No-op when empty.

Remote Link (#138)¶

Peer-to-peer controller relay over the LAN. The Dashboard hosts the server toggles and the outbound-connect box. The paired-peer manager and identity-protection state live on SettingsViewModel and are surfaced here through the RemoteLink reference below.

Property	Type	Default	Description
`RemoteLink`	`SettingsViewModel`	-	The Settings VM, set once at startup. Holds `TrustedPeers`, `NearbyUnpaired`, and the identity-protection block so the Dashboard's Remote Link section can show paired peers, identity mode, and nearby PCs in one place.
`EnableRemoteLink`	`bool`	`false`	Whether the Remote Link server is listening for paired peers.
`AutoReconnect`	`bool`	`true`	When a paired PC appears on the LAN, establish the link without a click.
`RemoteLinkPort`	`int`	`27500`	TCP control + UDP data port. Clamped to 1024–65535.
`RemoteLinkStatus`	`string`	`"Stopped"`	Remote Link server status text.
`IsRemoteLinkRunning`	`bool`	`false`	Serving truth for the Remote Link card flame (#175): true only while the link server object is live. The status text can carry identity-unlock errors while the server never started, so the flame keys on this, not the text or the enable checkbox.
`RemoteLinkConnectHost`	`string`	`""`	Host (or host:port) the user types to initiate an outbound pairing.
`RemoteLinkMyCode`	`string`	`""`	This PC's connection code (#294): a self-contained code embedding the public and private endpoints, minted while Remote Link runs. Empty until the STUN probe returns. Set by InputService. Notifies `HasRemoteLinkMyCode`.
`HasRemoteLinkMyCode`	`bool`	-	Computed: a shareable code is available to show or copy.
`RemoteLinkNatWarning`	`string`	`""`	Network warning (#294): set when the STUN probe found no public address (UDP blocked) or an endpoint-dependent NAT direct connections cannot traverse. Empty when the network looks punchable. Notifies `HasRemoteLinkNatWarning`.
`HasRemoteLinkNatWarning`	`bool`	-	Computed: `RemoteLinkNatWarning` is non-empty.

Command	Description
`ResetRemoteLinkPortCommand`	Resets `RemoteLinkPort` to 27500.
`ConnectToPeerCommand`	Raises `ConnectToPeerRequested` with the trimmed `RemoteLinkConnectHost` when non-empty.
`CopyRemoteLinkCodeCommand`	Copies `RemoteLinkMyCode` to the clipboard. No-op when empty.

Event	Args	Description
`ConnectToPeerRequested`	`string`	User asked to connect/pair with a typed host[:port].

Touchpad Overlay (3.2)¶

On-screen transparent touchpad window that drives the DS4 / DualSense touchpad on the assigned PlayStation slot.

Property	Type	Default	Description
`EnableTouchpadOverlay`	`bool`	`false`	Overlay visible.
`EnableMenuOverlay`	`bool`	`true`	Radial / touch menu overlay (#9): render the `MenuOverlayWindow` HUD while a menu is engaged. When off, menus still hover and commit blind (the runtime never depends on the window).
`EnableShiftLayerFlyout`	`bool`	`true`	Show the shift-layer flyout while a slot sits on a non-Base layer. Purely a display of engagement state the poll thread already computes, so turning it off changes nothing about which layer is active.
`EnableProfileOverlay`	`bool`	`true`	Show the profile-switch overlay when a profile changes. The switch still happens when off, this only suppresses the announcement.
`TouchpadOverlayOpacity`	`double`	`0.25`	Surface opacity 0.0–1.0. Notifies `TouchpadOverlayOpacityPercent`.
`TouchpadOverlayOpacityPercent`	`int`	`25`	0–100 integer view of opacity for NumberBox binding.
`TouchpadOverlayMonitor`	`int`	`0`	Monitor index the overlay is pinned to (0 = primary).
`TouchpadOverlayLeft` / `Top`	`double`	`-1`	Window position. `-1` = centered on the chosen monitor.
`TouchpadOverlayWidth` / `Height`	`double`	`500` / `250`	Window size. Clamped to `>= 150` and `>= 80` respectively.
`IsTouchpadOverlayRunning`	`bool`	`false`	Overlay window currently shown. Drives `TouchpadOverlayStatus`.
`TouchpadOverlayStatus`	`string`	-	Localized status string (`"Running"` / `"Stopped"`).

Command	Description
`ResetOpacityCommand`	Resets opacity to default 0.25.
`ResetTouchpadOverlayPositionCommand`	Raises `ResetTouchpadOverlayPositionRequested`. `InputService` recenters the live overlay (or seeds defaults if not open) and clears persisted `Left` / `Top`.

Event	Description
`ResetTouchpadOverlayPositionRequested`	Recenter request from the UI.

Key Methods¶

Method	Description
`RefreshActiveSlots(IList<int>, bool)`	Rebuilds `SlotSummaries` for active slots. Updates display labels, re-applies the remembered focus selection, sets `ShowAddController`. Called by InputService.
`SetSelectedPad(int)`	Marks the slot whose pad page is in focus so its card wears the selection glow. `-1` clears it. The index is remembered, so a later `RefreshActiveSlots` rebuild re-applies the flag to fresh summaries.

SlotSummary¶

File: DashboardViewModel.cs (nested class)

Summary card for one virtual controller slot on the Dashboard.

Property	Type	Default	Description
`PadIndex`	`int`	-	Zero-based slot index. Read-only.
`SlotLabel`	`string`	-	Display label (e.g., `"Virtual Controller 1"`).
`MappedDevices`	`ObservableCollection<PadViewModel.MappedDeviceInfo>`	`null`	Live reference to the pad's mapped-device list, so the crucible card renders a per-device roster with battery glyphs (#175). Set by InputService. Same-reference sets are no-ops.
`DeviceName`	`string`	`"No device"`	Primary mapped device name.
`BatteryText`	`string`	`""`	Battery of the first mapped device reporting one, e.g. `"78%"`. Empty otherwise (#175, issue #167 lane).
`IsActive`	`bool`	`false`	Has at least one online mapped device.
`IsSelected`	`bool`	`false`	Whether this slot's pad page is the one currently in focus. Drives the persistent selection glow on the card. Set by `DashboardViewModel.SetSelectedPad`, not the same as `IsActive`.
`IsVirtualControllerConnected`	`bool`	`false`	Virtual controller connected. Notifies `StatusText`.
`IsInitializing`	`bool`	`false`	Virtual controller initializing. Notifies `StatusText`.
`IsCreateFailed`	`bool`	`false`	The slot's latest create attempt failed (engine createFailed latch). Its own status: a failed slot with online devices is neither forging nor awaiting devices. Notifies `StatusText`.
`MappedDeviceCount`	`int`	`0`	Devices mapped to this slot. Notifies `HasMappedDevices` and `StatusText`.
`HasMappedDevices`	`bool`	-	Computed: `MappedDeviceCount > 0`. Ember heat gating (#175): cards with zero mappings stay cold (no ember rim, no glow, steel seg tile) even when enabled.
`ConnectedDeviceCount`	`int`	`0`	Mapped devices connected.
`StatusText`	`string`	`"Idle"`	Ember status vocabulary (#175). For an enabled, non-initializing slot the getter checks three branches in order. A failed create returns `Main_VcFailed` first. Then zero mappings returns `Dashboard_StatusCold` (`"Cold"`). It returns `Main_AwaitingDevices` (`"Awaiting devices"`) for a mapped slot with nothing connected once the live VC is gone. While the VC survives the inactivity grace (60 s default), a device dropout must not flap the card to awaiting. Every other case passes through the engine-assigned setter value: `Main_Active` (`"Forging"`) when a device is online, `Common_Idle` (`"Idle"`), `Common_Disabled` (`"Disabled"`), or `Main_Initializing` (`"Initializing"`). The old `"No mapping"` string is intercepted by the Cold branch.
`IsEnabled`	`bool`	`true`	Slot enabled for output.
`SlotNumber`	`int`	`1`	1-based controller number among active slots.
`TypeInstanceLabel`	`string`	`"1"`	Per-type instance label.
`OutputType`	`VirtualControllerType`	`Xbox`	Virtual controller output type. (XML on-disk name is `"Microsoft"` via `[XmlEnum]` for v2/early-v3 back-compat. In-code identifier is `Xbox`.)
`StageLedger`	`ObservableCollection<SlotStageInfo>`	empty	Pipeline stage ledger (#175 item 10): one entry per configuration stage the slot's assigned devices actually have (sticks / triggers / gyro / lighting / touchpad / audio), in that order. Rebuilt per slot by `InputService.RefreshSlotStageLedger` on its 1 s slow lane. Entries mutate in place when membership is unchanged so the card doesn't re-template.

SlotStageInfo¶

File: DashboardViewModel.cs

One stage entry in a slot card's pipeline heat ledger (#175 item 10).

Property	Type	Description
`Kind`	`string`	Stable stage identity (`"Sticks"`..`"Audio"`). Membership comparisons key on this so in-place updates are possible. Read-only.
`Glyph`	`string`	Segoe font glyph for the font stages (same characters as the matching tab page headers). Empty for shape stages. Read-only.
`IsStickShape`	`bool`	True for the Sticks entry. Rendered with the Zacksly stick ring + disc geometries instead of a font glyph. Read-only.
`IsTriggerShape`	`bool`	True for the Triggers entry. Rendered with the Zacksly trigger body geometry. Read-only.
`IsHot`	`bool`	True when the stage carries a non-default configuration on any assigned device. Ember when hot, ashen steel when inert.
`Summary`	`string`	Composite change key for the tooltip readout (all lines joined). Empty when inert, which disables the tooltip. Notifies `HasSummary`.
`HasSummary`	`bool`	Computed: tooltip gate, no tooltip on inert stages.
`SummaryLines`	`ObservableCollection<StageSummaryLine>`	Per-device readout lines for the hover tooltip, in binding order. Devices still at defaults read STOCK.

StageSummaryLine¶

File: DashboardViewModel.cs

One tooltip line of a stage's readout: device-class glyph, device name, then mono value tokens.

Property	Type	Description
`DeviceGlyph`	`string`	Device-class glyph. Empty for slot-level lines.
`DeviceName`	`string`	Body-face device name, carrying its trailing `" · "` separator. Empty for slot-level lines like the audio master volume.
`Tokens`	`string`	Mono value tokens.

SettingsViewModel¶

File: SettingsViewModel.cs DataContext for: Settings page

Application-level settings: theme, language, drivers, profiles, and engine configuration.

Theme¶

Property	Type	Default	Description
`SelectedThemeIndex`	`int`	`0`	0 = System, 1 = Light, 2 = Dark. Raises `ThemeChanged`.

Event	Args	Description
`ThemeChanged`	`int`	Raised when theme selection changes. Arg = theme index.

Language¶

Property	Type	Description
`AvailableLanguages`	`ObservableCollection<CultureInfo>`	UI languages: en, de, fr, ja, ko, zh-Hans, pt-BR, es, it, nl.
`SelectedLanguage`	`CultureInfo`	Current UI language. Applies immediately via `Strings.ChangeCulture()`. Defaults to current culture or English.

Member	Type	Description
`LanguageCode`	`string`	Persisted language code for serialization.
`SetLanguageFromCode(string)`	method	Sets language from persisted code on startup without raising `CultureChanged`.
`ResetLanguageToSystemDefault()`	method	Sets `SelectedLanguage` back to the OS UI culture (or English when unsupported).

Driver Status: HIDMaestro¶

HIDMaestro is shipped as an embedded managed SDK (HIDMaestro.Core, bundled at Resources/HIDMaestro/HIDMaestro.Core.dll). The user-mode driver still needs to be registered with Windows once. That happens inside the engine via HMContext.InstallDriver() (called from InputManager.Step5.VirtualDevices.cs:EnsureHMaestroContext), not through DriverInstaller. The SettingsViewModel exposes a read-only version string read from the bundled assembly at startup.

Property	Type	Description
`HIDMaestroVersion`	`string`	HIDMaestro SDK version. Initialized from the embedded `HIDMaestro.Core` assembly via `GetEmbeddedHidMaestroVersion()`.

Driver Status: HidHide¶

Property	Type	Description
`IsHidHideInstalled`	`bool`	HidHide installed.
`HidHideStatusText`	`string`	Computed: `"Installed"` / `"Not Installed"`.
`HidHideVersion`	`string`	HidHide version.
`HidHideWhitelistPaths`	`ObservableCollection<string>`	Whitelisted application paths.
`SelectedWhitelistPath`	`string`	Selected whitelist path. Refreshes `RemoveWhitelistPathCommand`.

Command	CanExecute	Description
`InstallHidHideCommand`	`!IsHidHideInstalled`	Raises `InstallHidHideRequested`.
`UninstallHidHideCommand`	`IsHidHideInstalled && !HasAnyHidHideDevices()`	Raises `UninstallHidHideRequested`.
`AddWhitelistPathCommand`	`IsHidHideInstalled`	Raises `AddWhitelistPathRequested`.
`RemoveWhitelistPathCommand`	`SelectedWhitelistPath != null`	Removes selected path, raises `WhitelistChanged`.

Event	Description
`InstallHidHideRequested`	Install HidHide.
`UninstallHidHideRequested`	Uninstall HidHide.
`AddWhitelistPathRequested`	Add whitelist path (opens file dialog).
`WhitelistChanged`	Whitelist was modified (add or remove).

Driver Status: Windows MIDI Services¶

Property	Type	Description
`IsMidiServicesInstalled`	`bool`	Windows MIDI Services available.
`MidiServicesStatusText`	`string`	Computed: `"Installed"` / `"Not Installed"`.
`MidiServicesVersion`	`string`	MIDI Services version.
`IsMidiOsSupported`	`bool`	Static: `true` if OS build >= 26100 (Win11 24H2).
`MidiOsSupported`	`bool`	Instance forwarder over the static above. A XAML `Binding` path resolves against the DataContext instance and cannot reach a static member, so SettingsPage binds this one. Never raises `PropertyChanged` because the OS build cannot change while the app runs.

Command	CanExecute	Description
`InstallMidiServicesCommand`	`!IsMidiServicesInstalled && IsMidiOsSupported`	Raises `InstallMidiServicesRequested`.
`UninstallMidiServicesCommand`	`IsMidiServicesInstalled && !HasAnyMidiSlots()`	Raises `UninstallMidiServicesRequested`.

Driver Status: SteamVR (#49)¶

The VR slot type needs SteamVR present. PadForge can install it Steam-free through steamcmd, and it only offers to remove the copy it created itself.

Property	Type	Description
`IsSteamVrInstalled`	`bool`	A SteamVR install of either shape is present (Steam client, or the Steam-free steamcmd one). Notifies `SteamVrStatusText` and `ShowSteamVrUninstall`.
`SteamVrStatusText`	`string`	Computed, tiered (#287), deepest true state wins: `"Not Installed"`, then controllers-live / driver-connected / running read off `HMaestroVRController.GlobalDriverStatus()` and `OpenVrConsumerService.ServerConnected`, falling back to `"Installed"`. This is where the SteamVR status reads now that the Dashboard's driver strip is gone.
`SteamVrInstallDir`	`string`	Where the Steam-free install will land (seeded from `DriverInstaller.SteamVrInstallDir`). Not persisted by PadForge: after a successful install the HIDMaestro path hint is the durable record.
`IsSteamVrOwned`	`bool`	The present install is the Steam-free one PadForge created. A Steam-client install is never PadForge's to remove.
`ShowSteamVrUninstall`	`bool`	Computed: `IsSteamVrInstalled && IsSteamVrOwned`.

Command	CanExecute	Description
`InstallSteamVrCommand`	`!IsSteamVrInstalled`	Raises `InstallSteamVrRequested`.
`UninstallSteamVrCommand`	`IsSteamVrInstalled && IsSteamVrOwned && !HasAnyVrSlots()`	Raises `UninstallSteamVrRequested`.

Event	Description
`InstallSteamVrRequested`	Install SteamVR Steam-free.
`UninstallSteamVrRequested`	Remove the PadForge-owned install.

Method	Description
`RefreshSteamVrStatus()`	Raises the SteamVR row's change notification. Called by MainWindow's periodic status refresh, since `SteamVrStatusText` reads live statics rather than stored fields.

Driver Uninstall Guards¶

Member	Type	Description
`HasAnyMidiSlots`	`Func<bool>`	Set by MainWindow. True if any slot uses MIDI. Blocks `UninstallMidiServicesCommand`.
`HasAnyVrSlots`	`Func<bool>`	Set by MainWindow. True if any created slot is a VR slot. Blocks `UninstallSteamVrCommand`.
`HasAnyHidHideDevices`	`Func<bool>`	Set by MainWindow. True if any device has HidHide enabled. Blocks `UninstallHidHideCommand`.
`RefreshDriverGuards()`	method	Re-evaluates uninstall `CanExecute` for HidHide, MIDI Services, and SteamVR. Call after slot creation/deletion/type changes.

Engine Settings¶

Property	Type	Default	Description
`AutoStartEngine`	`bool`	`true`	Auto-start engine on launch.
`MinimizeToTray`	`bool`	`false`	Minimize to system tray instead of taskbar.
`BatteryNotifyEnabled`	`bool`	`true`	Low-battery notification master toggle (#293).
`BatteryNotifyThreshold`	`int`	`15`	Percent at or below which the edge-triggered notification fires. Clamped 5–50.
`BatteryNotifyVibrate`	`bool`	`false`	Also buzz the device on the low-battery edge, using the identify pulse train.
`AssignOfferNewDevice`	`bool`	`true`	Assignment Prompts: offer a device PadForge has never seen before to the virtual controller whose page is open when it connects.
`AssignOfferEmptySlot`	`bool`	`true`	Assignment Prompts: offer any connecting device, new or already known, to the open virtual controller when that slot has no devices assigned.
`HandheldButtonsEnabled`	`bool`	`false`	Handheld PC Buttons (#343): adds the per-machine Hidden Buttons row and the System Motion row. The setter mirrors into `HandheldButtonRegistry.FeatureEnabled`, which the engine sweep reads.
`StartMinimized`	`bool`	`false`	Start minimized.
`DiagnosticsLoggingEnabled`	`bool`	`false`	Diagnostics logging (#303): mirrors the engine's in-memory event ring to `diagnostics.log` continuously. Persisted, so it survives restarts and covers auto-started sessions where a launch flag cannot.
`DiagnosticsFolderPath`	`string`	-	Read-only forwarder over `DiagnosticsLogControl.Folder`: where the log and snapshots land. Shown on the Diagnostics card.
`StartAtLogin`	`bool`	`false`	Auto-start at login.
`EnablePollingOnFocusLoss`	`bool`	`true`	Continue polling on focus loss.
`PollingOverrideNote`	`string`	`null`	Why the global polling knob is not in charge (#365 follow-up). While the active profile carries a polling override, this names the profile and the rate it imposes, and the Settings page shows it under the knob. Null or empty collapses the note. Written by `InputService.ApplyEffectivePollingRate`, the same owner that writes the live rate, so note and loop cannot disagree.
`PollingRateMs`	`int`	`1`	Polling interval in ms. Clamped to 1–16.
`HmInactivityDestroyTimeoutSeconds`	`int`	`60`	Seconds the engine waits for any mapped device to return online before tearing down the live HM virtual controller and freeing its kernel slot. Clamped to 0–3600. `0` disables the timeout. The slot's configuration (mappings, profile, position, enabled state) is preserved end-to-end. Only the live VC is destroyed. Once mapped devices come back online, the VC recreates automatically at the same visual position. Surviving Xbox HM VCs at higher visual positions bubble down to keep xinputhid indices contiguous after the teardown.
`EnableInputHiding`	`bool`	`true`	Master switch for device hiding (HidHide + input hooks).
`KeepHidHideCloaksBetweenLaunches`	`bool`	`false`	When true, HidHide cloaks stay asserted after PadForge exits so other apps still see the physical devices hidden. When false (default), cloaks clear on shutdown.

Settings File¶

Property	Type	Description
`SettingsFilePath`	`string`	Path to the loaded settings file.
`HasUnsavedChanges`	`bool`	Unsaved changes exist.

Command	Description
`SaveCommand`	Raises `SaveRequested`.
`ReloadCommand`	Raises `ReloadRequested`.
`ResetCommand`	Raises `ResetRequested`.
`OpenSettingsFolderCommand`	Raises `OpenSettingsFolderRequested`.

Event	Description
`SaveRequested`	Save settings.
`ReloadRequested`	Reload from disk.
`ResetRequested`	Reset settings.
`OpenSettingsFolderRequested`	Open settings folder.

Diagnostic Info¶

Property	Type	Description
`SdlVersion`	`string`	SDL3 version.
`ApplicationVersion`	`string`	Application version.
`RuntimeVersion`	`string`	.NET runtime version.

Display Preferences¶

Property	Type	Default	Description
`Use2DControllerView`	`bool`	`false`	Show 2D controller view instead of 3D.

Community Configs (v4.1, #9)¶

Member	Type	Default	Description
`EnableCommunityConfigLookup`	`bool`	`false`	Master opt-in for the Steam Workshop clients. Persisted, dirty-gate allowlisted.
`ShowLegacyWorkshopConfigs`	`bool`	`false`	Legacy sub-toggle. Persisted, dirty-gate allowlisted.
`ClearWorkshopCacheCommand`	`RelayCommand`		Raises `ClearWorkshopCacheRequested`, handled by MainWindow (empties `SteamWorkshopCache`).
`CheckWorkshopUpdatesCommand`	`RelayCommand`		Raises `CheckWorkshopUpdatesRequested`, handled by MainWindow (batched provenance check).
`BrowseCommunityConfigsCommand`	`RelayCommand`		The Profiles-page entry. No CanExecute gate: with the opt-in off the dialog opens on its cold state and offers the enable step.
`BrowseStarterProfilesCommand`	`RelayCommand`		Opens the starter-profile gallery (#256) through `BrowseStarterProfilesRequested`. Always enabled: the catalog ships in the box, so there is no opt-in and no network.

Remote Link Peer Manager (#138)¶

The trusted-peer list and identity-protection mode live here. The Dashboard's Remote Link section binds them through DashboardViewModel.RemoteLink.

Property	Type	Description
`TrustedPeers`	`ObservableCollection<RemoteLinkTrustedPeer>`	Trusted paired PCs, shown in the Settings peer manager.
`NearbyUnpaired`	`ObservableCollection<RemoteLinkNearbyPeer>`	PadForge PCs discovered on the LAN that aren't paired yet.
`HasNearbyUnpaired`	`bool`	Computed: `NearbyUnpaired.Count > 0`.
`IdentityProtectionModes`	`IReadOnlyList<string>`	Dropdown options in index order: 0 Secure, 1 password-portable, 2 open-portable.
`IdentityProtectionModeIndex`	`int`	Selected protection mode (0/1/2). User changes raise `IdentityProtectionModeChangeRequested`. Programmatic reverts use `SetIdentityProtectionModeSilently` so no event re-fires. Notifies `IdentityProtectionHint`.
`IdentityProtectionHint`	`string`	Computed: one-line guidance under the dropdown for the selected mode.

Command	Description
`RevokeAllPeersCommand`	Raises `PeerRevokeAllRequested`.

Event	Args	Description
`PeerRevokeRequested`	`string`	Revoke one peer by fingerprint.
`PeerRevokeAllRequested`	-	Revoke every peer.
`PeerRenameRequested`	`string, string`	Rename a peer (fingerprint, new name), persisted.
`PeerConnectRequested`	`string`	Connect to a paired-but-offline peer (host:port).
`IdentityProtectionModeChangeRequested`	`int`	User picked a different protection mode (new index).

Method	Description
`RefreshTrustedPeers(IEnumerable<PeerTrust>, IReadOnlyCollection<string>)`	Rebuilds `TrustedPeers` from the trust store. Called on pair / revoke / rename, not for online refresh.
`UpdatePeerOnlineStatus(IReadOnlyCollection<string>)`	Updates each peer's online dot in place from the live connection set.
`UpdatePeerReachability(IReadOnlyDictionary<string,string>)`	Updates each paired peer's reachable host:port in place from LAN discovery.
`SetNearbyUnpaired(IEnumerable<RemoteLinkNearbyPeer>)`	Replaces the nearby-unpaired list.
`SetIdentityProtectionModeSilently(int)`	Sets the mode without raising the change request (init from settings, or revert a canceled switch).

First-Run, Window, and Foreground State¶

Property	Type	Default	Description
`ForegroundExeName`	`string`	`"-"`	Foreground exe filename the auto-switch monitor last saw (#175 item 8). Runtime-only, fed at 1 Hz by InputService's UI timer, never persisted.
`IsForegroundMatched`	`bool`	`false`	True while the foreground exe matches a profile. Runtime-only.
`NoProfileHasExecutables`	`bool`	-	Computed: no profile carries an executable match rule (#175 item 8).
`LegacyDriverCleanupOffered`	`bool`	`false`	True after the v3 first-run cleanup wizard has been shown. Persists so the dialog appears once.
`FirstRunTourCompleted`	`bool`	`false`	True once the first-run welcome tour is completed or skipped. Replaces the pre-v4 beside-exe marker file.
`MainWindowLeft` / `Top`	`double`	`-1`	Main window position (profile-independent).
`MainWindowWidth` / `Height`	`double`	`1100` / `720`	Main window size.
`MainWindowState`	`int`	`0`	Persisted window state (normal / maximized).
`MainWindowFullScreen`	`bool`	`false`	Full-screen flag.

Profiles¶

Property	Type	Default	Description
`EnableAutoProfileSwitching`	`bool`	`false`	Auto-profile switching enabled.
`EnableExternalControl`	`bool`	`false`	Serve the external-control named pipe (#366) so a launcher or script can activate and deactivate profiles from outside PadForge. `InputService` watches this property and starts or stops the pipe live. The Profiles page carries the checkbox beside the shortcut combo and the foreground match, because this is a third way a profile activates rather than a global engine service.
`ProfileItems`	`ObservableCollection<ProfileListItem>`	empty	Profile entries for UI list.
`ProfileShortcuts`	`ObservableCollection<ProfileShortcutViewModel>`	empty	Profile-switch shortcut rows for the ProfilesPage shortcuts card.
`SelectedProfile`	`ProfileListItem`	`null`	Selected profile. Refreshes delete/edit/load/export commands.
`ActiveProfileInfo`	`string`	`"Default"`	Active profile display text.

Command	CanExecute	Description
`NewProfileCommand`	always	Raises `NewProfileRequested`.
`SaveAsProfileCommand`	always	Raises `SaveAsProfileRequested`.
`DeleteProfileCommand`	`SelectedProfile != null && !IsDefault`	Raises `DeleteProfileRequested`.
`EditProfileCommand`	`SelectedProfile != null && !IsDefault`	Raises `EditProfileRequested`.
`LoadProfileCommand`	`SelectedProfile != null`	Raises `LoadProfileRequested` or `RevertToDefaultRequested` if default.
`ExportProfileCommand`	`SelectedProfile != null`	Raises `ExportProfileRequested`. Exports the selected profile as a `.pfprofile`. The Default entry exports a snapshot of the current settings.
`ImportProfileCommand`	always	Raises `ImportProfileRequested`. Imports a `.pfprofile`.

Event	Description
`RevertToDefaultRequested`	Revert to default profile.
`NewProfileRequested`	Create new empty profile.
`SaveAsProfileRequested`	Save current settings as profile.
`DeleteProfileRequested`	Delete selected profile.
`EditProfileRequested`	Edit selected profile metadata.
`LoadProfileRequested`	Load selected profile.
`ExportProfileRequested`	Export selected profile to a `.pfprofile`.
`ImportProfileRequested`	Import a `.pfprofile`.

The delete / edit / load / export commands refresh their own CanExecute inline in the SelectedProfile setter. There is no separate refresh method.

ProfileListItem¶

File: SettingsViewModel.cs (nested class)

Display item for a profile in the Settings list.

Property	Type	Description
`Id`	`string`	Profile identifier.
`IsActive`	`bool`	Whether this profile is the currently active one. Drives the lit flame in the Profiles list (#175).
`Name`	`string`	Display name.
`Executables`	`string`	Comma-separated exe names for auto-switch (display form). Notifies `HasExecutables`, `AutoSwitchRuleSummary`.
`ExecutablePaths`	`string`	Pipe-separated full executable paths (the ForegroundMonitorService match source). Feeds the card's exe icon and mono exe line (#175).
`FirstExecutablePath`	`string`	Computed: full path of the first executable, or null. The card's icon converter `File.Exists`-gates this.
`FirstExecutableName`	`string`	Computed: file name of the first executable, or null.
`SecondExecutableName`	`string`	Computed: file name of the second executable, or null. The card face shows up to two names before the `+N` marker.
`ExtraExecutablesSuffix`	`string`	Computed: locale-neutral `"+N"` marker for rules beyond the two shown names, or null.
`HasExecutables`	`bool`	Computed: the profile carries any executable match rule. Half of the auto-switch chip gate (#175).
`AutoSwitchRuleSummary`	`string`	Computed: exe-match rule summary for the cold auto-switch chip, the display exe list under a localized prefix.
`TopologyLabel`	`string`	Slot topology summary.
`HasNoSlots`	`bool`	Computed: all type counts are zero.
`XboxCount`	`int`	Number of Xbox slots in this profile.
`PlayStationCount`	`int`	Number of PlayStation slots.
`NintendoCount`	`int`	Number of Nintendo slots (#215).
`ExtendedCount`	`int`	Number of Extended slots.
`MidiCount`	`int`	Number of MIDI slots.
`KbmCount`	`int`	Number of Keyboard+Mouse slots.
`VrCount`	`int`	Number of VR slots (#49).
`IsDefault`	`bool`	Computed: true if `Id == "__default__"`.

Constant	Value	Description
`DefaultProfileId`	`"__default__"`	Sentinel ID for the Default profile.

DevicesViewModel¶

File: DevicesViewModel.cs DataContext for: Devices page

All detected input devices (online and offline) with raw input state for the selected device.

Device List¶

Property	Type	Description
`Devices`	`ObservableCollection<DeviceRowViewModel>`	All known devices. Updated by InputService on change.
`SelectedDevice`	`DeviceRowViewModel`	Selected device. Notifies `HasSelectedDevice`, refreshes slot buttons and command state.
`HasSelectedDevice`	`bool`	Computed: `SelectedDevice != null`.

Device Counts¶

Property	Type	Description
`TotalCount`	`int`	Total detected devices.
`OnlineCount`	`int`	Connected devices.

Chip row above the device list that filters by device class. The chips bind their labels to the count properties. Clicking one sets SelectedFacet.

Property	Type	Default	Description
`SelectedFacet`	`string`	`"ALL"`	Active facet token: `ALL` / `GAMEPAD` / `JOYSTICK` / `WHEEL` / `KEYBOARD` / `MOUSE` / `OTHER`. Locale-neutral literals the chip DataTriggers key off. The setter routes through `SetFacet`.
`FacetCountGamepad`	`int`	`0`	Rows behind the GAMEPAD chip (the stick classes: Gamepad / FirstPerson / Supplemental).
`FacetCountJoystick`	`int`	`0`	Rows behind the JOYSTICK chip (joysticks + flight sticks).
`FacetCountWheel`	`int`	`0`	Rows behind the WHEEL chip.
`FacetCountKeyboard`	`int`	`0`	Rows behind the KEYBOARD chip.
`FacetCountMouse`	`int`	`0`	Rows behind the MOUSE chip.
`FacetCountOther`	`int`	`0`	Rows behind the OTHER chip (touchpads, MIDI, NFC, microphones, consumer collections, unclassified).

Method	Description
`SetFacet(string)`	Applies the facet filter to the default collection view the ListBox binds through, so the XAML keeps a plain `ItemsSource="{Binding Devices}"`. `ALL` clears the filter. No-op when the token is unchanged or empty.

The ALL chip binds TotalCount. RefreshCounts() recomputes every facet count and re-runs the active filter so rows whose type key changed in place re-bucket.

Raw Input State Display (for selected device)¶

Property	Type	Description
`RawAxes`	`ObservableCollection<AxisDisplayItem>`	Axis values (progress bars).
`RawButtons`	`ObservableCollection<ButtonDisplayItem>`	Button states (circles).
`RawPovs`	`ObservableCollection<PovDisplayItem>`	POV hat values (compass).
`KeyboardKeys`	`ObservableCollection<KeyboardKeyItem>`	Keyboard layout items.
`IsKeyboardDevice`	`bool`	Selected device is a keyboard.
`IsMouseDevice`	`bool`	Selected device is a mouse.
`IsTouchpadDevice`	`bool`	Selected device exposes a touchpad surface (DS4 / DualSense / Steam Controller / Steam Deck / overlay touchpad).
`IsMidiDevice`	`bool`	Selected device is a MIDI input (#128). Drives the live piano / CC preview off `LiveMidi`.
`IsNfcDevice`	`bool`	Selected device is an NFC reader (#150). Populates `NfcTags`.
`IsMicrophoneDevice`	`bool`	Selected device is a standalone microphone (#317). Hides the numbered button grid, since every button it has is a named phrase.
`ShowVoicePhrases`	`bool`	Selected device carries voice phrases (a microphone row, or a Bluetooth DualSense whose embedded mic is not a system device). Drives the Voice Macros section, the voice twin of the NFC Tags section.
`VoicePhrases`	`ObservableCollection<NfcTagDisplayItem>`	Named phrase rows for the live preview (#317): "Any Phrase" plus each registered phrase. Reuses the NFC row item. Rebuilt by `RebuildVoicePhrases(int)`.
`VoiceButtonBase`	`int`	Raw-button base the current device's phrase buttons sit at (0 on a microphone row, the reserved pad range on a DualSense). `-1` when none. Private setter.
`IsConsumerDevice`	`bool`	Selected device is a Consumer Control collection (#168). Populates `ConsumerButtons`.
`IsHeadsetMotionDevice`	`bool`	Selected device is a Sony headset head tracker (#188). Collapses the raw Axes / Buttons sections, since a motion-only source has neither and the gyro readout is its whole preview.
`IsHandheldDevice`	`bool`	Selected device is the handheld hidden-buttons row (#343). Drives the named button list in place of the numbered grid, the same treatment NFC gets.
`IsSystemMotionDevice`	`bool`	Selected device is the machine's own motion sensor row (#343). Motion only, so the raw Axes / Buttons sections collapse like the headset tracker's.
`IsHeadTrackerDevice`	`bool`	Selected device is the head tracker row (#355): six named axes, no buttons, plus a source line.
`HeadTrackerStatus`	`string`	Which head-tracking source is live, for the details pane (#355). Written by the preview loop. Null coalesces to empty.
`HeadTrackerStatusVersion`	`int`	Internal. The device `StatusVersion` the current `HeadTrackerStatus` was built from, `-1` for none.
`HeadTrackerStatusDevice`	`object`	Internal. The device instance that version belongs to. A reopen (port change, FreeTrack toggle) builds a new device whose `StatusVersion` restarts at 0 and collides with the cached 0, so the cache compares instance as well as version.
`HandheldButtons`	`ObservableCollection<NfcTagDisplayItem>`	Named learned-button rows for the handheld preview (#343), each lighting while its button is down. Reuses the NFC row item, with `Uid` carrying the delivery description. Rebuilt by `RebuildHandheldButtons()`.
`NfcTags`	`ObservableCollection<NfcTagDisplayItem>`	Registered-tag rows for the NFC preview. Rebuilt by `RebuildNfcTags()`.
`ConsumerButtons`	`ObservableCollection<ConsumerButtonDisplayItem>`	Named media-key chips for the Consumer Control preview.
`LiveMidi`	`MidiInputState`	Latest MIDI input snapshot the piano / CC preview polls. Plain property, no change notification.
`HasTouchpadData`	`bool`	At least one finger is currently in contact.
`TouchpadX0`–`TouchpadX4` / `TouchpadY0`–`TouchpadY4`	`double`	Per-finger normalized position (0.0–1.0) on the first pad. Five contacts, not two.
`TouchpadDown0`–`TouchpadDown4`	`bool`	Per-finger contact state.
`HasSecondTouchpadData`	`bool`	The device exposes a second pad (Steam Controller / Steam Deck). Switches the labels to `TouchpadLabel` / `Touchpad2Label`.
`TouchpadLabel` / `Touchpad2Label`	`string`	Computed pad captions. `Touchpad2Label` is always the localized touchpad word plus `" 2"`. `TouchpadLabel` picks up its own `" 1"` only when a second pad exists.
`Pad2X0`–`Pad2X4` / `Pad2Y0`–`Pad2Y4` / `Pad2Down0`–`Pad2Down4`	`double` / `bool`	Second-pad contacts, same five-finger shape.
`MouseMotionX`	`double`	Mouse X motion.
`MouseMotionY`	`double`	Mouse Y motion.
`MouseScrollIntensity`	`double`	Normalized scroll intensity (−1 to 1).
`SelectedButtonTotal`	`int`	Button count on selected device.
`HasRawData`	`bool`	Raw state data available.

Gyroscope / Accelerometer¶

Property	Type	Description
`HasGyroData`	`bool`	Gyroscope data available.
`HasAccelData`	`bool`	Accelerometer data available.
`GyroX`	`double`	Gyroscope X value.
`GyroY`	`double`	Gyroscope Y value.
`GyroZ`	`double`	Gyroscope Z value.
`AccelX`	`double`	Accelerometer X value.
`AccelY`	`double`	Accelerometer Y value.
`AccelZ`	`double`	Accelerometer Z value.
`HasAccelAuxData`	`bool`	Aux (left-side) accelerometer data available (#199). True for a Nunchuk behind a MotionPlus or a left Joy-Con, where the device carries a second accelerometer alongside the primary one.
`AccelAuxX`	`double`	Aux accelerometer X value.
`AccelAuxY`	`double`	Aux accelerometer Y value.
`AccelAuxZ`	`double`	Aux accelerometer Z value.
`HasGyroAuxData`	`bool`	Aux (left-side) gyro data available (#252): the left Joy-Con of a combined pair. Paired with the aux accel readout so the user can see which half a reading comes from before binding it. Cleared by `ClearRawState()`.
`GyroAuxX`	`double`	Aux gyro X value.
`GyroAuxY`	`double`	Aux gyro Y value.
`GyroAuxZ`	`double`	Aux gyro Z value.

Dynamic Slot Assignment Buttons¶

Property	Type	Description
`ActiveSlotItems`	`ObservableCollection<SlotButtonItem>`	Slot toggle buttons. Only includes created/active slots.

Commands¶

Command	CanExecute	Description
`RefreshCommand`	always	Raises `RefreshRequested`. Force-refreshes device list.
`PairCommand`	always	Raises `PairRequested`. Opens the Bluetooth pairing flow for controllers that need an in-app pairing ceremony (Wii controllers, #116).
`AssignToSlotCommand`	`HasSelectedDevice`	`RelayCommand<int>`. Raises `AssignToSlotRequested` with slot index (0–15).
`ToggleSlotCommand`	`HasSelectedDevice`	`RelayCommand<int>`. Toggles slot assignment. Raises `ToggleSlotRequested`.
`HideDeviceCommand`	`HasSelectedDevice`	Raises `HideDeviceRequested` with the selected device's InstanceGuid. The row itself stays in the collection until the service refreshes the list.
`RemoveDeviceCommand`	`HasSelectedDevice`	Removes the row from `Devices`, clears `SelectedDevice`, raises `RemoveDeviceRequested`, then `RefreshCounts()`.

Events¶

Event	Args	Description
`RefreshRequested`	`EventArgs`	Refresh requested.
`PairRequested`	`EventArgs`	User opened the Bluetooth pairing flow (#116).
`AssignToSlotRequested`	`int`	Slot index.
`ToggleSlotRequested`	`int`	Slot index.
`HideDeviceRequested`	`Guid`	Instance GUID.
`RemoveDeviceRequested`	`Guid`	Instance GUID.
`DeviceHidingChanged`	`Guid`	HidHide or ConsumeInput toggle changed.

Key Methods¶

Method	Description
`RebuildRawStateCollections(IReadOnlyList<int> axisIndices, IReadOnlyList<int> buttonIndices, int povCount, bool isKeyboard, bool isMouse, bool isTouchpad, bool isMidi, bool isNfc, IReadOnlyList<ConsumerButtonDisplayItem> consumerButtons, bool isHeadsetMotion, int voiceButtonBase, bool isMicrophone, bool isHandheld, bool isSystemMotion, bool isHeadTracker)`	Internal. Rebuilds axis/button/POV collections for a new device. `axisIndices` is the sparse list of axis slots the device actually exposes (from `SupportedAxisIndices` / `CapAxisIndices` through `InputService.ResolveAxisIndices`), so each `AxisDisplayItem.Index` is the real `state.Axis[]` slot and its label reads `Axis {slot}`, gaps included. `buttonIndices` is the sparse list of button positions the device actually exposes (each item's value is stored verbatim as both `Index` and `DisplayNumber`). The class-flag booleans default to `false`, `consumerButtons` to `null`, and `voiceButtonBase` to `-1`. Handles keyboard, mouse, touchpad, MIDI, NFC, Consumer Control, headset-motion, handheld, system-motion, head-tracker, and voice-phrase cases.
`ClearRawState()`	Internal. Clears all raw state display data, including every class flag, the head-tracker status cache, and the NFC / voice / handheld / Consumer collections.
`RebuildNfcTags()`	Repopulates `NfcTags` from `NfcTagRegistry`: "Any NFC Tag" first at button 0, then each registered tag at its stable button index.
`RebuildHandheldButtons()`	Repopulates `HandheldButtons` from `HandheldButtonRegistry.Entries` (#343). Called on selection and whenever the registry changes.
`RebuildVoicePhrases(int)`	Repopulates `VoicePhrases` from `VoicePhraseRegistry` at the passed button base. A negative base clears the list.
`RefreshSlotButtons()`	Rebuilds `ActiveSlotItems` from created slots and selected device assignments.
`RefreshAllSlotBadges()`	Re-derives every row's `SlotBadges` after a slot set changes.
`FindByGuid(Guid)`	Finds a `DeviceRowViewModel` by instance GUID.
`RefreshCounts()`	Updates `TotalCount` and `OnlineCount`, recomputes every facet count, and re-runs the active filter.
`NotifyDeviceHidingChanged(Guid)`	Raises `DeviceHidingChanged`.