Use faulthandler package.

Author: hsorby

.github/workflows/create-release.yaml

@@ -9,7 +9,7 @@ jobs:
   create_release:
     if: github.repository == 'MusculoskeletalAtlasProject/mapclient'
     name: create_release
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     steps:
       - name: Determine release properties
         shell: bash

.github/workflows/on-demand-deployment.yaml

@@ -56,7 +56,7 @@ jobs:
           matrixElements=()
           variants=${{ steps.set-variants.outputs.variants }}
           for v in $variants; do
-            matrixElements+=('{"os":"windows-2019","variant":"'$v'","tag":"${{ steps.get-tag.outputs.tag }}","release-name":"${{ steps.get-release-name.outputs.name }}","python-version":"3.9"}')
+            matrixElements+=('{"os":"windows-2025","variant":"'$v'","tag":"${{ steps.get-tag.outputs.tag }}","release-name":"${{ steps.get-release-name.outputs.name }}","python-version":"3.9"}')
             matrixElements+=('{"os":"macos-13","variant":"'$v'","tag":"${{ steps.get-tag.outputs.tag }}","release-name":"${{ steps.get-release-name.outputs.name }}","python-version":"3.10"}')
           done
           if [ "${#matrixElements[@]}" -eq "0" ]; then
@@ -140,10 +140,26 @@ jobs:
         run: |
           echo -n $EV_CERTIFICATE_PFX_BASE64 | base64 -d - > ./ev_certificate.pfx
           #dotnet tool install --global AzureSignTool
+      - name: Find signtool
+        if: runner.os == 'Windows'
+        shell: cmd
+        run: |
+          rem Leaving this here for finding signtool.exe when the runner upgrades.
+          echo "Finding signtool"
+          dir /s /b "C:\Program Files (x86)\Windows Kits\10\bin\signtool.exe"
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+      - name: Install NSIS
+        if: runner.os == 'Windows'
+        uses: repolevedavaj/install-nsis@v1.0.3
+        with:
+          nsis-version: '3.11'
+      - name: Verify NSIS Installation
+        if: runner.os == 'Windows'
+        run: |
+          & "C:\\Program Files (x86)\\NSIS\\makensis.exe" -VERSION
       - name: Checkout codebase
         uses: actions/checkout@v4
         with:
@@ -223,6 +239,7 @@ jobs:
             asset=${asset//\\//}
           fi
           
+          echo "Asset created: $asset"
           echo "file=$asset" >> $GITHUB_OUTPUT
           cat $GITHUB_OUTPUT
 
@@ -231,7 +248,7 @@ jobs:
         shell: cmd
         run: |
           rem AzureSignTool sign -kvu "${{ secrets.AZURE_KEY_VAULT_URI }}" -kvi "${{ secrets.AZURE_CLIENT_ID }}" -kvt "${{ secrets.AZURE_TENANT_ID }}" -kvs "${{ secrets.AZURE_CLIENT_SECRET }}" -kvc ${{ secrets.AZURE_CERT_NAME }} -tr http://timestamp.acs.microsoft.com -v ${{ steps.create-application.outputs.file }}
-          "C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x86\signtool" sign /d "MAP Client - mapping tools" /tr http://rfc3161timestamp.globalsign.com/advanced /fd SHA256 /td SHA256 /f ev_certificate.pfx ${{ steps.create-application.outputs.file }}
+          "C:\Program Files (x86)\Windows Kits\10\bin\10.0.26100.0\x86\signtool" sign /d "MAP Client - mapping tools" /tr http://rfc3161timestamp.globalsign.com/advanced /fd SHA256 /td SHA256 /f ev_certificate.pfx ${{ steps.create-application.outputs.file }}
 
       - name: Codesign application (macOS)
         if: runner.os == 'macOS'
@@ -272,7 +289,7 @@ jobs:
         if: runner.os == 'Windows'
         shell: cmd
         run: |
-          "C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x86\signtool" sign /d "MAP Client - mapping tools" /tr http://rfc3161timestamp.globalsign.com/advanced /fd SHA256 /td SHA256 /f ev_certificate.pfx ${{ steps.create-installer.outputs.file }}
+          "C:\Program Files (x86)\Windows Kits\10\bin\10.0.26100.0\x86\signtool" sign /d "MAP Client - mapping tools" /tr http://rfc3161timestamp.globalsign.com/advanced /fd SHA256 /td SHA256 /f ev_certificate.pfx ${{ steps.create-installer.outputs.file }}
           rem AzureSignTool sign -kvu "${{ secrets.AZURE_KEY_VAULT_URI }}" -kvi "${{ secrets.AZURE_CLIENT_ID }}" -kvt "${{ secrets.AZURE_TENANT_ID }}" -kvs "${{ secrets.AZURE_CLIENT_SECRET }}" -kvc ${{ secrets.AZURE_CERT_NAME }} -tr http://timestamp.acs.microsoft.com -v ${{ steps.create-installer.outputs.file }}
 
       - name: Notarize and Staple installer (macOS)

docs/getting_started/install-mapclient.rst

@@ -2,7 +2,7 @@
 Install MAP Client
 ==================
 
-The MAP Client software is a Python application that uses the PySide2 Qt library bindings.
+The MAP Client software is a Python application that uses the PySide6 Qt library bindings.
 
 There are three main ways of getting the MAP Client installed on your operating system.
 
@@ -14,6 +14,13 @@ The MAP Client relies heavily on plugins to do anything interesting.
 If you `Install Using Pre-Built Binary`_ you get everything you need, however you can only use plugins that have all the dependencies already available to the binary. At this time you cannot add dependencies that a new plugin may or may not require to work.
 If you `Install Using Pip`_ or `Install Using Git`_, you can either create these yourself or add already available ones to your application by downloading them and using the Plugin Manager Tool in the MAP Client, read the documents :ref:`MAP-feature-demonstration` and :ref:`MAP-plugin-wizard` to learn more.
 
+MAP Client uses OpenGL to render 3D scenes, so OpenGL support must be available on your system for the application to run correctly.
+On Windows and macOS, OpenGL is typically pre-installed.
+On GNU/Linux systems, you may need to install the necessary OpenGL libraries manually.
+For Ubuntu 22.04, you can install the required packages using the following command::
+
+  sudo apt install libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev
+
 ------------
 Installation
 ------------