docs(readme): rewrite for fork release

Replace the inherited README with fork-specific release docs and
screenshots so the repository front page reflects the current app.

The previous README still described the upstream project more than this
fork's v1 beta feature set and setup flow.

The profile storage section describes the layout the app actually uses.
The inherited text still described the pre-universal format, telling
users their profiles live in a subfolder per controller type. Those
directories are now a migration source under LegacyProfiles, and live
profiles are single files that work with any supported controller,
grouped into folders the user names. Anyone following the old text to
back up or move profiles would have copied the wrong directory.

It also states where the fork's configuration now lives and that the
upstream folder is left alone, so a user running both apps knows which
folder belongs to which and that neither will disturb the other.

Author: HelloHim

README.md

@@ -1,34 +1,116 @@
 # DS4MapperTest
 
-Mainly used as a test ground for trying out different mapping ideas. The application can currently
-support using a DualShock 4, DualSense, 8BitDo Ultimate 2 Wireless, Steam Controller 2015,
-Steam Controller 2026, JoyCon, and Switch Pro.
+Fork of [archived DS4MapperTest](https://github.com/Ryochan7/DS4MapperTest), used as a testing ground for controller mapping ideas, binding behaviour, sensitivity settings, etc. The application currently supports the DualShock 4, DualSense, 8BitDo Ultimate 2 Wireless, Steam Controller 2015, Steam Controller 2026, JoyCon, and Switch Pro.
 
-## Runtime Dependencies
+## Quick Start
 
-https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-10.0.9-windows-x64-installer
+- Download and unzip the latest build: [Latest release](https://github.com/HelloHim/DS4MapperTest/releases/tag/v1.0.0-beta)
+- Install the runtime dependencies listed below.
+- Connect a supported controller.
+- Run `DS4MapperTest.exe` from the unzipped folder.
+- Select or create a profile.
+- Configure the bindings and settings you want.
+- Save the profile and start using it.
 
-.NET 10 Desktop Runtime x64 - [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-10.0.9-windows-x64-installer](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-10.0.9-windows-x64-installer)  
-Visual C++ 2015-2022 Redistributable. [x64](https://aka.ms/vs/17/release/vc_redist.x64.exe)  
-USBIP Driver (0.9.7.7 or later) - [https://github.com/vadimgrn/usbip-win2](https://github.com/vadimgrn/usbip-win2)  
-libVIIPER (Bundled) - [https://github.com/Alia5/VIIPER](https://github.com/Alia5/VIIPER)
+## Profile Storage
 
-### Optional Tools
+Profiles are saved under your Windows user profile, in `%APPDATA%\DS4TestUniversal\Profiles\`
+(i.e. `C:\Users\<you>\AppData\Roaming\DS4TestUniversal\Profiles\`). Each profile is a
+`.universal-profile.json` file and works with any supported controller, so profiles are
+grouped into folders you name yourself (`Default` and `VALORANT` are created for you) rather
+than by controller type. Back them up or move them between machines by copying that folder.
+
+Profiles from before the universal format live alongside it in
+`%APPDATA%\DS4TestUniversal\LegacyProfiles\`, in a subfolder per controller type
+(`DualShock4`, `DualSense`, `SwitchPro`, `JoyCon`, `SteamController`,
+`SteamControllerTriton`, `EightBitDoUlt2Wireless`). These are kept only as a migration
+source and are not loaded directly.
 
-FakerInput 0.1.1 - [https://github.com/Ryochan7/FakerInput/releases/download/v0.1.1/FakerInput_Setup_0.1.1_x64.msi](https://github.com/Ryochan7/FakerInput/releases/download/v0.1.1/FakerInput_Setup_0.1.1_x64.msi)  
-HidHide - [https://vigem.org/projects/HidHide/](https://vigem.org/projects/HidHide/)
+The upstream Ryochan7 DS4MapperTest stores its data in `%APPDATA%\DS4Test\`. This fork does
+not read, write, copy, move, or migrate that folder automatically, so the original app and
+this fork can be installed side by side without affecting each other's profiles. If you want
+to reuse an upstream profile here, copy it manually into this fork's profile folder.
 
-## Final Release
+## Runtime Dependencies
+
+- .NET 10 Desktop Runtime x64
+  [https://dotnet.microsoft.com/en-us/download/dotnet/10.0](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)
+- Visual C++ 2015-2022 Redistributable x64
+  [https://aka.ms/vs/17/release/vc_redist.x64.exe](https://aka.ms/vs/17/release/vc_redist.x64.exe)
+- USBIP Driver 0.9.7.7 or later
+  https://github.com/vadimgrn/usbip-win2
+- libVIIPER is bundled with the application
+  https://github.com/Alia5/VIIPER
 
-https://github.com/Ryochan7/DS4MapperTest/releases/tag/v0.0.32
+### Optional Tools
+
+- FakerInput 0.1.1
+  Needed for the FakerInput mouse and keyboard output backend.
+  https://github.com/Ryochan7/FakerInput/releases/download/v0.1.1/FakerInput_Setup_0.1.1_x64.msi
+- HidHide
+  For if you want to hide the physical controller while using a virtual output device.
+  [https://docs.nefarius.at/projects/HidHide/Simple-Setup-Guide/](https://docs.nefarius.at/projects/HidHide/Simple-Setup-Guide/)
 
 ## Screenshots
 
-![example_mapper_screen_20220605](https://user-images.githubusercontent.com/581968/172064947-bc3358c7-7ec3-4a5d-86f5-3715bd4638e7.png)
+![DS4MapperTest](readMeImages/hero-shot.jpg)
+
+### Binding workflow
+
+![Binding workflow](readMeImages/binding-workflow-shot.jpg)
+
+### Mouse routing
+
+![Mouse routing](readMeImages/mouse-routing-shot.jpg)
+
+### Gyro sensitivity and angle calibration
+
+![Gyro sensitivity and angle calibration](readMeImages/gyro-sensitivity-angle-calibration.jpg)
+
+## Controller Compatibility
+
+- DualShock 4
+- DualSense
+- DualSense Edge
+- 8BitDo Ultimate 2 Wireless
+- Steam Controller 2015
+- Steam Controller 2026
+- JoyCon
+- Switch Pro
+
+## Installation for Devs
+
+- Install Visual Studio with the `.NET desktop development` workload.
+- Install the `.NET 10 SDK`.
+- Open `DS4MapperTest.sln`.
+- Use the `x64` platform.
+- Set `DS4MapperTest` as the startup project if you want to run the app directly.
+- Restore NuGet packages before building.
+- If you want to work on FakerInput-backed features, make sure the `FakerInputWrapper` dependency is available to the project.
+
+### Running the Tests
+
+The unit tests build only under the `Debug Tests` and `Release Tests` configurations:
+
+```
+dotnet test DS4MapperTest.sln -c "Release Tests"
+```
+
+A bare `dotnet test` resolves the `Debug` configuration, where the test project is
+deliberately left out of the build, and reports a missing test assembly rather than
+running anything. Those two configurations define `MAKE_TESTS`, which stubs out the
+real keyboard and mouse injection, so a test run cannot type into the desktop of
+whoever is running it. That is why the tests are not simply built everywhere.
 
-![example_mapper_profile_overview_20220614](https://raw.githubusercontent.com/Ryochan7/SteamControllerTest/master/example_mapper_profile_overview_20220614.png)
+## Acknowledgements
 
-## License
+- GamepadMotionHelpers: Source of some ported gyro-related logic. MIT licensed.
+  <https://github.com/JibbSmart/GamepadMotionHelpers/blob/master/LICENSE>
+- JoyShockMapper: behavioural reference and source of some ported gyro-related logic. MIT licensed.
+  <https://github.com/JibbSmart/JoyShockMapper/blob/master/LICENSE.md>
+- JSM Custom Curve: UI inspiration.
+  <https://github.com/evan1mclean/JSM_custom_curve>
 
-[GPL v.3](https://www.gnu.org/licenses/gpl-3.0-standalone.html)
+## Licence
 
+- GPL v3: [LICENSE.txt](LICENSE.txt)