Merge branch 'main' of https://github.com/sesouthall/PCGameShuffler

.github/workflows/dotnet-desktop.yml

@@ -0,0 +1,86 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# This workflow will build, test, sign and package a WPF or Windows Forms desktop application
+# built on .NET Core.
+# To learn how to migrate your existing application to .NET Core,
+# refer to https://docs.microsoft.com/en-us/dotnet/desktop-wpf/migration/convert-project-from-net-framework
+#
+# To configure this workflow:
+#
+# 1. Configure environment variables
+# GitHub sets default environment variables for every workflow run.
+# Replace the variables relative to your project in the "env" section below.
+#
+# 2. Signing
+# Generate a signing certificate in the Windows Application
+# Packaging Project or add an existing signing certificate to the project.
+# Next, use PowerShell to encode the .pfx file using Base64 encoding
+# by running the following Powershell script to generate the output string:
+#
+# $pfx_cert = Get-Content '.\SigningCertificate.pfx' -Encoding Byte
+# [System.Convert]::ToBase64String($pfx_cert) | Out-File 'SigningCertificate_Encoded.txt'
+#
+# Open the output file, SigningCertificate_Encoded.txt, and copy the
+# string inside. Then, add the string to the repo as a GitHub secret
+# and name it "Base64_Encoded_Pfx."
+# For more information on how to configure your signing certificate for
+# this workflow, refer to https://github.com/microsoft/github-actions-for-desktop-apps#signing
+#
+# Finally, add the signing certificate password to the repo as a secret and name it "Pfx_Key".
+# See "Build the Windows Application Packaging project" below to see how the secret is used.
+#
+# For more information on GitHub Actions, refer to https://github.com/features/actions
+# For a complete CI/CD sample to get started with GitHub Action workflows for Desktop Applications,
+# refer to https://github.com/microsoft/github-actions-for-desktop-apps
+
+name: .NET Core Desktop
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+
+  build:
+
+    strategy:
+      matrix:
+        configuration: [Debug, Release]
+
+    runs-on: windows-latest  # For a list of available runner types, refer to
+                             # https://help.github.com/en/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on
+
+    env:
+      Solution_Name: GameShuffler.sln
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+      with:
+        fetch-depth: 0
+
+    # Install the .NET Core workload
+    - name: Install .NET Core
+      uses: actions/setup-dotnet@v3
+      with:
+        dotnet-version: 6.0.x
+
+    # Add  MSBuild to the PATH: https://github.com/microsoft/setup-msbuild
+    - name: Setup MSBuild.exe
+      uses: microsoft/setup-msbuild@v1.0.2
+
+    # Publish the solution
+    - name: Build
+      run: dotnet publish
+
+    # Upload the MSIX package: https://github.com/marketplace/actions/upload-a-build-artifact
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v3
+      with:
+        name: GameShuffler
+        path: bin/Release/net6.0-windows/publish/win-x64

README.md

@@ -1 +1,16 @@
-# PCGameShuffler
+# PCGameShuffler
+A simple tool to shuffle PC games. Inspired by [Brossentia and Authorblues' Bizhawk Shuffler](https://github.com/authorblues/bizhawk-shuffler-2)
+
+## Usage
+* Download and launch the shuffler
+* Start the games you want to shuffle
+  * Be aware that when you start shuffling, the games will be in whatever state you leave them, so you may wish to do save selection, character creation, etc.
+* Click Refresh to populate the list of processes available for shuffling
+* Select the games you want to shuffle and change the minimum and maximum time between shuffles, if desired
+* Click Start Shuffle
+  * All but one of the games should become minimized and unresponsive, the other should be maximized
+  * The active game will change randomly within the limits set
+  * Press PageDown at any time to remove the current game from the shuffle, and force-quit it
+  * Click Stop Shuffle to resume all games, and stop the shuffler
+
+<img width="403" alt="ShufflerImage" src="https://user-images.githubusercontent.com/125438356/218967334-0cd24cb3-2d0f-4191-9bad-2349586cf7e1.png">