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).

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"`).
`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.

XAML binding: Sidebar ListBox binds to MainViewModel.NavControllerItems. Each template binds SlotNumber, InstanceLabel, IconKey (via DynamicResource), and IsEnabled.

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"`, `"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.
`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.

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 is bundled with PadForge as a managed SDK and ships with the executable, so the dashboard does not surface an install/uninstall row for it. HidHide and Windows MIDI Services are optional system drivers and have their own rows.

Property	Type	Description
`IsHidHideInstalled`	`bool`	HidHide installed. Notifies `HidHideStatusText`.
`HidHideStatusText`	`string`	Computed: `"Installed"` / `"Not installed"`.
`IsMidiServicesInstalled`	`bool`	Windows MIDI Services installed. Notifies `MidiServicesStatusText`.
`MidiServicesStatusText`	`string`	Computed: `"Installed"` / `"Not installed"`.

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.

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.

Command	Description
`ResetWebPortCommand`	Resets `WebControllerPort` to 8080.

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.

Command	Description
`ResetRemoteLinkPortCommand`	Resets `RemoteLinkPort` to 27500.
`ConnectToPeerCommand`	Raises `ConnectToPeerRequested` with the trimmed `RemoteLinkConnectHost` when non-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).
`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, sets `ShowAddController`. Called by InputService.

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.
`IsInitializing`	`bool`	`false`	Virtual controller initializing.
`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). The getter returns `Dashboard_StatusCold` (`"Cold"`) for an enabled, non-initializing slot with zero mappings. 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 by `InputService.RefreshSlotStageLedgers` 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).

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

Driver Uninstall Guards¶

Member	Type	Description
`HasAnyMidiSlots`	`Func<bool>`	Set by MainWindow. True if any slot uses MIDI. Blocks `UninstallMidiServicesCommand`.
`HasAnyHidHideDevices`	`Func<bool>`	Set by MainWindow. True if any device has HidHide enabled. Blocks `UninstallHidHideCommand`.
`RefreshDriverGuards()`	method	Re-evaluates uninstall `CanExecute` for HidHide and MIDI Services. 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.
`StartMinimized`	`bool`	`false`	Start minimized.
`StartAtLogin`	`bool`	`false`	Auto-start at login.
`EnablePollingOnFocusLoss`	`bool`	`true`	Continue polling on focus loss.
`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`	`ICommand`		Raised to MainWindow's `OnClearWorkshopCache` (empties `SteamWorkshopCache`).
`CheckWorkshopUpdatesCommand`	`ICommand`		Raised to MainWindow's `OnCheckWorkshopUpdates` (batched provenance check).
`BrowseCommunityConfigsCommand`	`ICommand`		The Profiles-page entry. No CanExecute gate: with the opt-in off the dialog opens on its cold state and offers the enable step.

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 cancelled 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.
`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.
`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, 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).
`HasTouchpadData`	`bool`	At least one finger is currently in contact.
`TouchpadX0` / `TouchpadY0`	`double`	First finger normalized position (0.0–1.0).
`TouchpadX1` / `TouchpadY1`	`double`	Second finger normalized position.
`TouchpadDown0` / `TouchpadDown1`	`bool`	Per-finger contact state.
`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`	Sets `IsHidden = true`, raises `HideDeviceRequested`.
`RemoveDeviceCommand`	`HasSelectedDevice`	Removes device, raises `RemoveDeviceRequested`.

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(int axisCount, IReadOnlyList<int> buttonIndices, int povCount, bool isKeyboard, bool isMouse, bool isTouchpad, bool isMidi, bool isNfc, IReadOnlyList<ConsumerButtonDisplayItem> consumerButtons)`	Rebuilds axis/button/POV collections for a new device. `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` and `consumerButtons` to `null`. Handles keyboard, mouse, touchpad, MIDI, NFC, and Consumer Control cases.
`ClearRawState()`	Clears all raw state display data.
`RefreshSlotButtons()`	Rebuilds `ActiveSlotItems` from created slots and selected device assignments.
`FindByGuid(Guid)`	Finds a `DeviceRowViewModel` by instance GUID.
`RefreshCounts()`	Updates `TotalCount` and `OnlineCount`.
`NotifyDeviceHidingChanged(Guid)`	Raises `DeviceHidingChanged`.