Release 0.3.1 installer flavors

Author: shiftedx

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -14,7 +14,7 @@ body:
     id: version
     attributes:
       label: DSCC version
-      description: Example: 0.3.0
+      description: Example: 0.3.1
     validations:
       required: true
   - type: dropdown

.github/ISSUE_TEMPLATE/feedback.yml

@@ -14,7 +14,7 @@ body:
     id: version
     attributes:
       label: DSCC version
-      description: Example: 0.3.0
+      description: Example: 0.3.1
   - type: dropdown
     id: area
     attributes:

.github/workflows/README.md

@@ -22,11 +22,21 @@ Linux runners install `libudev-dev` so `hidapi` can compile.
 
 It builds:
 
-- Unsigned Windows MSI.
+- Unsigned Windows Standard MSI.
+- Unsigned Windows Bridge MSI.
+- Unsigned Windows Bridge framework-dependent MSI.
 - Windows raw binary zip.
 - Linux beta archive with bundled web UI.
 - SHA256 checksum files.
 
+Windows installer intent is deliberately explicit:
+
+| Artifact | Default audience |
+| --- | --- |
+| `standard` | Most users. Controller tuning, profiles, haptics, telemetry, diagnostics, and Steam Input support without the non-Steam bridge broker payload. |
+| `bridge` | Users testing DSCC Input Bridge for non-Steam games. Bundles the self-contained HIDMaestro broker. |
+| `bridge-framework-dependent` | Advanced bridge users with the matching x64 .NET runtime already installed. |
+
 The release workflow publishes the GitHub Release and uploads artifacts. Windows
 artifacts are unsigned unless signing is added later.
 

.github/workflows/release.yml

@@ -11,6 +11,8 @@ permissions:
 env:
   CARGO_TERM_COLOR: always
   WINDOWS_TARGET: x86_64-pc-windows-gnu
+  HIDMAESTRO_RELEASE_URL: https://github.com/hifihedgehog/HIDMaestro/releases/download/v1.3.13/HIDMaestro-v1.3.13.zip
+  HIDMAESTRO_RELEASE_SHA256: 4948B815E65AFDD72BED8C1E29E8108ED8388B58F805FECA2C452E06CF499227
 
 jobs:
   rust-checks:
@@ -83,6 +85,9 @@ jobs:
       - uses: actions/checkout@v6
       - uses: dtolnay/rust-toolchain@stable
       - uses: Swatinem/rust-cache@v2
+      - uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "10.0.x"
       - uses: actions/download-artifact@v6
         with:
           name: release-web-dist
@@ -99,31 +104,106 @@ jobs:
         run: |
           $tag = '${{ github.ref_name }}'
           if ($tag -notmatch '^v?([0-9]+\.[0-9]+)(?:\.([0-9]+))?(?:[-+].*)?$') {
-            throw "Release tag '$tag' must look like v0.3, v0.3.0, or v0.3.0-beta.1."
+            throw "Release tag '$tag' must look like v0.3, v0.3.1, or v0.3.1-beta.1."
           }
           $patch = if ([string]::IsNullOrWhiteSpace($Matches[2])) { '0' } else { $Matches[2] }
           "msi_version=$($Matches[1]).$patch" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
           "artifact_suffix=$tag" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
       - name: Build Windows GNU binaries
         shell: pwsh
         run: cargo build -p dscc-agent -p dscc-tray -p dscc-cli --release --target $env:WINDOWS_TARGET
-      - name: Build unsigned MSI
+      - name: Resolve HIDMaestro broker dependency
+        id: hidmaestro
+        shell: pwsh
+        run: |
+          $root = Join-Path $PWD 'target\hidmaestro'
+          $zipPath = Join-Path $root 'HIDMaestro-v1.3.13.zip'
+          $extractPath = Join-Path $root 'release'
+          New-Item -ItemType Directory -Path $root -Force | Out-Null
+          Invoke-WebRequest -Uri $env:HIDMAESTRO_RELEASE_URL -OutFile $zipPath
+          $hash = (Get-FileHash -LiteralPath $zipPath -Algorithm SHA256).Hash.ToUpperInvariant()
+          if ($hash -ne $env:HIDMAESTRO_RELEASE_SHA256.ToUpperInvariant()) {
+            throw "HIDMaestro release hash mismatch. Expected $env:HIDMAESTRO_RELEASE_SHA256 but found $hash."
+          }
+          if (Test-Path -LiteralPath $extractPath) {
+            Remove-Item -LiteralPath $extractPath -Recurse -Force
+          }
+          Expand-Archive -LiteralPath $zipPath -DestinationPath $extractPath -Force
+          $coreDll = Join-Path $extractPath 'HIDMaestro.Core.dll'
+          if (-not (Test-Path -LiteralPath $coreDll)) {
+            throw "HIDMaestro.Core.dll was not found in the approved release archive."
+          }
+          "core_dll=$coreDll" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
+      - name: Build HIDMaestro broker package flavors
+        shell: pwsh
+        run: |
+          $coreDll = '${{ steps.hidmaestro.outputs.core_dll }}'
+          $publishRoot = Join-Path $PWD 'target\hidmaestro-broker'
+          $selfContained = Join-Path $publishRoot 'self-contained'
+          $frameworkDependent = Join-Path $publishRoot 'framework-dependent'
+          foreach ($dir in @($selfContained, $frameworkDependent)) {
+            if (Test-Path -LiteralPath $dir) {
+              Remove-Item -LiteralPath $dir -Recurse -Force
+            }
+          }
+          dotnet publish tools/dscc-hidmaestro-broker `
+            -c Release `
+            -r win-x64 `
+            -o $selfContained `
+            --self-contained true `
+            -p:PublishSingleFile=true `
+            -p:EnableCompressionInSingleFile=true `
+            -p:DebugType=None `
+            -p:DebugSymbols=false `
+            -p:HidMaestroCoreDll="$coreDll"
+          dotnet publish tools/dscc-hidmaestro-broker `
+            -c Release `
+            -r win-x64 `
+            -o $frameworkDependent `
+            --self-contained false `
+            -p:PublishSingleFile=false `
+            -p:DebugType=None `
+            -p:DebugSymbols=false `
+            -p:HidMaestroCoreDll="$coreDll"
+      - name: Build unsigned MSIs
         shell: pwsh
         run: |
+          $selfContainedBroker = Join-Path $PWD 'target\hidmaestro-broker\self-contained'
+          $frameworkDependentBroker = Join-Path $PWD 'target\hidmaestro-broker\framework-dependent'
           powershell -NoProfile -ExecutionPolicy Bypass -File packaging\package-msi.ps1 `
             -Version '${{ steps.version.outputs.msi_version }}' `
             -TargetTriple $env:WINDOWS_TARGET `
-            -SkipWebBuild
+            -SkipWebBuild `
+            -InstallerFlavor Standard
+          powershell -NoProfile -ExecutionPolicy Bypass -File packaging\package-msi.ps1 `
+            -Version '${{ steps.version.outputs.msi_version }}' `
+            -TargetTriple $env:WINDOWS_TARGET `
+            -SkipWebBuild `
+            -InstallerFlavor Bridge `
+            -BrokerPublishPath $selfContainedBroker
+          powershell -NoProfile -ExecutionPolicy Bypass -File packaging\package-msi.ps1 `
+            -Version '${{ steps.version.outputs.msi_version }}' `
+            -TargetTriple $env:WINDOWS_TARGET `
+            -SkipWebBuild `
+            -InstallerFlavor BridgeFrameworkDependent `
+            -BrokerPublishPath $frameworkDependentBroker
       - name: Stage Windows artifacts and checksums
         shell: pwsh
         run: |
           $suffix = '${{ steps.version.outputs.artifact_suffix }}'
           $artifactRoot = Join-Path $PWD 'target\release-artifacts\windows'
           New-Item -ItemType Directory -Path $artifactRoot -Force | Out-Null
 
-          $msiSource = Join-Path $PWD "target\installer\DualSenseCommandCenter-${{ steps.version.outputs.msi_version }}.msi"
-          $msiDest = Join-Path $artifactRoot "DualSenseCommandCenter-$suffix-windows-x86_64-unsigned.msi"
-          Copy-Item -LiteralPath $msiSource -Destination $msiDest -Force
+          $msiArtifacts = @(
+            @{ Flavor = 'standard'; Name = 'standard' },
+            @{ Flavor = 'bridge'; Name = 'bridge' },
+            @{ Flavor = 'bridge-framework-dependent'; Name = 'bridge-framework-dependent' }
+          )
+          foreach ($artifact in $msiArtifacts) {
+            $msiSource = Join-Path $PWD "target\installer\DualSenseCommandCenter-${{ steps.version.outputs.msi_version }}-$($artifact.Flavor).msi"
+            $msiDest = Join-Path $artifactRoot "DualSenseCommandCenter-$suffix-windows-x86_64-$($artifact.Name)-unsigned.msi"
+            Copy-Item -LiteralPath $msiSource -Destination $msiDest -Force
+          }
 
           $binaryStage = Join-Path $PWD 'target\release-artifacts\windows-bin'
           if (Test-Path -LiteralPath $binaryStage) {
@@ -288,6 +368,17 @@ jobs:
 
           Verify downloaded files against the published SHA256 checksum files.
 
+          Windows users should choose one installer:
+
+          - `standard`: recommended for most users. Includes controller tuning,
+            profiles, haptics, diagnostics, telemetry, and Steam Input support.
+            It does not bundle the optional non-Steam Input Bridge broker.
+          - `bridge`: includes the self-contained HIDMaestro broker for DSCC
+            Input Bridge testing with local non-Steam apps. Larger download.
+          - `bridge-framework-dependent`: advanced bridge build for machines
+            that already have the matching x64 .NET runtime installed. Smaller
+            than `bridge`, less plug-and-play than `standard`.
+
           The Linux archive includes the bundled production web UI, so
           `./dscc-cli serve --addr 127.0.0.1:43473` can serve the app without
           running Vite. Linux HID permissions and hardware validation remain

.gitignore

@@ -80,6 +80,8 @@ pnpm-debug.log*
 /release/
 /releases/
 /artifacts/
+/tools/dscc-hidmaestro-broker/bin/
+/tools/dscc-hidmaestro-broker/obj/
 /*.zip
 *.msi
 *.exe

CHANGELOG.md

@@ -1,3 +1,63 @@
+# DualSense Command Center 0.3.1
+
+Latest release notes are listed first. For install steps, start with the
+[README](README.md).
+
+Release date: 2026-05-26
+
+0.3.1 splits Windows installers into clear, named choices so the normal user
+path stays slim while non-Steam bridge testing remains available.
+
+## Windows Installers
+
+Pick one installer. Do not install Bridge unless you need non-Steam DSCC Input
+Bridge testing.
+
+| Installer | Intended user | Why it exists |
+| --- | --- | --- |
+| **DSCC Standard** | Most users | Smallest normal install. Includes profiles, haptics, telemetry, diagnostics, controller tuning, and Steam Input support. Does not bundle the HIDMaestro broker. |
+| **DSCC Bridge** | Non-Steam bridge testers | Bundles the self-contained HIDMaestro broker so DSCC Input Bridge can create a virtual Xbox 360 controller for local non-Steam app profiles. |
+| **DSCC Bridge Framework-Dependent** | Advanced bridge testers | Bundles the smaller framework-dependent broker and requires the matching x64 .NET runtime to already be installed. |
+
+## Packaging
+
+- Added explicit `Standard`, `Bridge`, and `BridgeFrameworkDependent` MSI
+  flavors to `packaging/package-msi.ps1`.
+- Standard packaging no longer requires or stages any `hidmaestro` broker
+  payload.
+- Bridge packaging still validates that the broker output shape matches the
+  selected flavor, so a framework-dependent build cannot accidentally package a
+  self-contained runtime shape.
+- The tag release workflow now builds and uploads all three Windows MSI
+  variants with flavor names in the artifact filenames.
+- Release notes now tell users to choose Standard first and use Bridge only for
+  compatibility beyond Steam.
+
+## UI
+
+- Moved the Controllers page tuning bar to the top of the page so Controllers,
+  Adaptive Triggers & Haptics, and Button Mapping use the same command layout.
+- Kept Profiles focused on game/profile scope selection, with controller
+  targeting in the expanded tuning ribbon.
+
+## Validation Gate
+
+This release was cut after a clean run of:
+
+```powershell
+npm.cmd --prefix web run typecheck
+npm.cmd --prefix web run build
+npm.cmd --prefix web run test:button-map
+npm.cmd --prefix web run test:release-size
+cargo +stable-x86_64-pc-windows-gnu build -p dscc-agent -p dscc-tray -p dscc-cli --release --target x86_64-pc-windows-gnu
+```
+
+## Install
+
+Download the `standard` Windows x86_64 MSI unless you specifically need
+non-Steam DSCC Input Bridge testing. Verify downloads with the included SHA256
+checksum file.
+
 # DualSense Command Center 0.3.0
 
 Latest release notes are listed first. For install steps, start with the

Cargo.lock

@@ -10,18 +10,32 @@ lightbar controls, and racing telemetry without Python setup or scripts.
 
 Get the latest Windows installer from [GitHub Releases](https://github.com/shiftedx/dualsense-command/releases/latest).
 
-- Current release: `0.3.0`
-- Recommended download: Windows x86_64 MSI
+- Current release: `0.3.1`
+- Recommended download: **DSCC Standard** Windows x86_64 MSI
 - Linux builds: beta archive with bundled web UI
 
 The MSI is unsigned, so Windows SmartScreen may warn you. DSCC stores profiles
 and settings in your user folder and preserves them during upgrades. Continue
 past SmartScreen only if you downloaded the MSI from the official release page
 and checked it against the published checksum when needed.
 
+## Which Windows Installer Should I Use?
+
+Pick one. Most people should not install the larger bridge build.
+
+| Installer | Use this when | Includes non-Steam DSCC Input Bridge broker? | Notes |
+| --- | --- | --- | --- |
+| **DSCC Standard** | You want controller tuning, profiles, haptics, telemetry, diagnostics, Steam Input support, and the smallest normal install. | No | **Recommended for most users.** Non-Steam bridge screens stay available but show the provider as not installed. |
+| **DSCC Bridge** | You want to test DSCC Input Bridge with local non-Steam games and you do not want to install a separate .NET runtime. | Yes, self-contained | Larger installer. Best plug-and-play bridge option. |
+| **DSCC Bridge Framework-Dependent** | You want bridge support and already have the matching x64 .NET runtime installed. | Yes, framework-dependent | Smaller than Bridge, but it has a prerequisite. Advanced users only. |
+
+Steam games and normal controller tuning do not need the Bridge installers.
+Use Bridge only to expand compatibility beyond Steam.
+
 ## Quick Start
 
-1. Download and run the Windows MSI.
+1. Download and run the **DSCC Standard** Windows MSI unless you specifically
+   need non-Steam DSCC Input Bridge testing.
 2. Launch **DualSense Command Center** from the Start menu.
 3. Connect a DualSense or DualSense Edge controller over USB or Bluetooth.
 4. Open DSCC from the tray icon, or visit `http://127.0.0.1:43473/`.

README.md

@@ -1,6 +1,6 @@
 [package]
 name = "dscc-adapters"
-version = "0.3.0"
+version = "0.3.1"
 edition.workspace = true
 license.workspace = true
 rust-version.workspace = true

crates/dscc-adapters/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dscc-agent"
-version = "0.3.0"
+version = "0.3.1"
 edition.workspace = true
 license.workspace = true
 rust-version.workspace = true