Files
riojoy/deploy/README-DEPLOY.txt
T
CydandClaude Opus 4.8 d17fd018eb Add cockpit deployment package + single-instance guard
deploy/ builds a single zip for TeslaConsole: the self-contained tray app and
the signed ViGEmBus installer under a riojoy\ folder, with postinstall.bat at the
root. postinstall elevates and runs riojoy\install-rio.ps1, which installs
ViGEmBus silently (if absent) and registers RIOJoy to start at logon — no cert
trust, test signing, Secure Boot change, or reboot.

Also guard against two instances fighting over the COM port (machine-wide +
per-user autostart both firing): a per-session named mutex makes a second launch
exit immediately. Built zips (dist/) and the bundled installer (deploy/vendor/)
are git-ignored.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-29 09:29:01 -05:00

55 lines
2.6 KiB
Plaintext

RIOJoy — cockpit deployment package
====================================
This package deploys RIOJoy to a single directory (e.g. C:\games\RIOJOY) and runs
all local installation steps from postinstall.bat. It uses the signed ViGEmBus
virtual-controller driver, so there is NO test signing, NO Secure Boot change, and
NO reboot.
Contents
--------
postinstall.bat Entry point (at the root). Elevates, then runs
riojoy\install-rio.ps1.
riojoy\ The payload folder:
app\ The RIOJoy tray application (self-contained .NET 8 — no runtime
install required on the target machine).
vendor\ The signed ViGEmBus installer (Nefarius, WHQL/attestation-signed).
install-rio.ps1 The actual install steps (idempotent).
VERSION.txt Build stamp (date + git short SHA).
What postinstall.bat does
-------------------------
1. Elevates to administrator (UAC) if not already elevated.
2. Installs ViGEmBus silently if its driver service is not already present.
3. Registers RIOJoy to start at logon (HKLM ...\Run, machine-wide).
4. Launches RIOJoy.
Deploying with TeslaConsole
---------------------------
1. Extract this zip so that postinstall.bat and the riojoy\ folder sit together
(e.g. under C:\games\, giving C:\games\postinstall.bat and C:\games\riojoy\).
2. Run postinstall.bat ELEVATED (TeslaConsole should run it as administrator).
It is idempotent — re-running it is safe (e.g. for updates). The app and
ViGEmBus install from the riojoy\ folder; install-rio.ps1 locates itself, so
the riojoy\ folder can live wherever it is extracted.
After install
-------------
* RIOJoy runs in the system tray. Right-click it to pick/edit profiles, set the
auto-switch executables, and toggle output to the PC.
* The RIO's joystick output appears to games as a standard "Xbox 360 Controller"
(verify in joy.cpl). Note the XInput layout limits joystick BUTTONS to 11
(A, B, X, Y, LB, RB, Back, Start, L3, R3, Guide); bind everything else to the
keyboard. The hat maps to the D-pad; axes map to the sticks and triggers.
* Per-machine config lives in %APPDATA%\RIOJoy\config.json for the running user.
Building this package (on a dev machine)
-----------------------------------------
Requires the .NET 8 SDK and the signed ViGEmBus installer.
powershell -ExecutionPolicy Bypass -File deploy\build-package.ps1 `
-VigemInstaller <path-to-ViGEmBus_x.y.z_x64_x86_arm64.exe>
(Or drop ViGEmBus_*.exe into deploy\vendor\ and omit -VigemInstaller.)
Output: dist\RIOJoy-<version>.zip