CydandClaude Fable 5
f77cd55b11
The Settings "Background light control" list only offers apps that have BOTH package identity and the com.microsoft.windows.lighting windows.appExtension in their manifest (declaration verified against Lenovo's LegionLightingController manifest) — without a grant, Windows hands the LEDs to vRIO only while it is the foreground window, i.e. never during gameplay. pkg/AppxManifest.xml is a sparse package (external location) that grants the existing VRio.App.exe identity as-is: win32App runtime behavior, runFullTrust + unvirtualizedResources, and the lighting app-extension. Register-vRIO.ps1 registers/unregisters it against any exe folder (repo build or an extracted dist zip); unsigned registration needs Developer Mode. Identity is granted through shell activation only — launch from the Start menu entry or an AUMID taskbar pin, not by double-clicking the exe (the script prints this warning). Verified end-to-end on this machine: process reports the package full name, vRIO appears in the background-control list, and the wire log shows the withheld → available transition once granted. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
54 lines
2.0 KiB
PowerShell
54 lines
2.0 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Grants VRio.App.exe package identity by registering the sparse package
|
|
(pkg\AppxManifest.xml) with the exe's folder as the external location.
|
|
|
|
Identity is what lets Windows Dynamic Lighting offer vRIO under
|
|
Settings > Personalization > Dynamic Lighting > "Background light control",
|
|
so the keyboard lamp mirror keeps working while the game has focus.
|
|
|
|
Unsigned registration requires Developer Mode
|
|
(Settings > System > For developers).
|
|
|
|
.PARAMETER ExePath
|
|
Folder containing VRio.App.exe. Defaults to the repo's Release output;
|
|
for a deployed zip, pass the extracted VRio folder.
|
|
|
|
.PARAMETER Unregister
|
|
Remove the registration instead.
|
|
#>
|
|
param(
|
|
[string]$ExePath = (Join-Path $PSScriptRoot '..\src\VRio.App\bin\Release\net48'),
|
|
[switch]$Unregister
|
|
)
|
|
|
|
$ErrorActionPreference = 'Stop'
|
|
$packageName = 'VWE.vRIO'
|
|
|
|
$existing = Get-AppxPackage -Name $packageName -ErrorAction SilentlyContinue
|
|
if ($existing) {
|
|
Write-Host "Removing existing registration $($existing.PackageFullName)..."
|
|
Remove-AppxPackage -Package $existing.PackageFullName
|
|
}
|
|
if ($Unregister) {
|
|
Write-Host 'Unregistered.'
|
|
return
|
|
}
|
|
|
|
$exe = Join-Path $ExePath 'VRio.App.exe'
|
|
if (-not (Test-Path $exe)) { throw "VRio.App.exe not found in '$ExePath'" }
|
|
$manifest = Join-Path $PSScriptRoot 'AppxManifest.xml'
|
|
|
|
Add-AppxPackage -Register $manifest -ExternalLocation (Resolve-Path $ExePath).Path
|
|
$family = (Get-AppxPackage -Name $packageName).PackageFamilyName
|
|
Write-Host "Registered $packageName with external location '$ExePath'."
|
|
Write-Host ''
|
|
Write-Host 'IMPORTANT: identity is granted through shell activation only. Launch vRIO'
|
|
Write-Host 'from the Start menu entry ("vRIO") or via:'
|
|
Write-Host " explorer shell:AppsFolder\$family!vRIO"
|
|
Write-Host 'Double-clicking VRio.App.exe runs it WITHOUT identity (lamp mirror then'
|
|
Write-Host 'works only while vRIO has focus).'
|
|
Write-Host ''
|
|
Write-Host 'Then enable the lamp mirror and pick vRIO under Settings > Personalization >'
|
|
Write-Host 'Dynamic Lighting > Background light control.'
|