Document PTZControl2 GUI and package releases

Author: jochenwezel

.github/workflows/gh-release.yml

@@ -28,6 +28,9 @@ jobs:
     - name: Publish PTZControlConsole (x64)
       run: dotnet publish PTZControlConsole/PTZControlConsole.csproj -c Release -r win-x64 --self-contained false -o ${{ github.workspace }}\console-win-x64
 
+    - name: Publish PTZControl2 (x64)
+      run: dotnet publish PTZControl2/PTZControl2.csproj -c Release -r win-x64 --self-contained false -o ${{ github.workspace }}\ptzcontrol2-win-x64
+
     - name: Upload PTZControl (x64) as artifact
       uses: actions/upload-artifact@v4
       with:
@@ -40,6 +43,12 @@ jobs:
         name: PTZControlConsole-win-x64
         path: ${{ github.workspace }}\console-win-x64\*
 
+    - name: Upload PTZControl2 (x64) as artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: PTZControl2-win-x64
+        path: ${{ github.workspace }}\ptzcontrol2-win-x64\*
+
   build-x86:
     runs-on: windows-2025-vs2026
     steps:
@@ -59,6 +68,9 @@ jobs:
     - name: Publish PTZControlConsole (x86)
       run: dotnet publish PTZControlConsole/PTZControlConsole.csproj -c Release -r win-x86 --self-contained false -o ${{ github.workspace }}\console-win-x86
 
+    - name: Publish PTZControl2 (x86)
+      run: dotnet publish PTZControl2/PTZControl2.csproj -c Release -r win-x86 --self-contained false -o ${{ github.workspace }}\ptzcontrol2-win-x86
+
     - name: Upload PTZControl (x86) as artifact
       uses: actions/upload-artifact@v4
       with:
@@ -71,6 +83,12 @@ jobs:
         name: PTZControlConsole-win-x86
         path: ${{ github.workspace }}\console-win-x86\*
 
+    - name: Upload PTZControl2 (x86) as artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: PTZControl2-win-x86
+        path: ${{ github.workspace }}\ptzcontrol2-win-x86\*
+
   build-linux-x64:
     runs-on: ubuntu-latest
     steps:
@@ -126,12 +144,24 @@ jobs:
           name: PTZControlConsole-win-x64
           path: PTZControlConsole-${{ env.TAG_NAME }}-win-x64
 
+      - name: Download PTZControl2 x64 artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: PTZControl2-win-x64
+          path: PTZControl2-${{ env.TAG_NAME }}-win-x64
+
       - name: Download console x86 artifact
         uses: actions/download-artifact@v4
         with:
           name: PTZControlConsole-win-x86
           path: PTZControlConsole-${{ env.TAG_NAME }}-win-x86
 
+      - name: Download PTZControl2 x86 artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: PTZControl2-win-x86
+          path: PTZControl2-${{ env.TAG_NAME }}-win-x86
+
       - name: Download console linux x64 beta artifact
         uses: actions/download-artifact@v4
         with:
@@ -155,6 +185,8 @@ jobs:
           (cd PTZControl-win-x86 && zip -r ../PTZControl-win-x86.zip .)
           (cd PTZControlConsole-${{ env.TAG_NAME }}-win-x64 && zip -r ../PTZControlConsole-win-x64.zip .)
           (cd PTZControlConsole-${{ env.TAG_NAME }}-win-x86 && zip -r ../PTZControlConsole-win-x86.zip .)
+          (cd PTZControl2-${{ env.TAG_NAME }}-win-x64 && zip -r ../PTZControl2-win-x64.zip .)
+          (cd PTZControl2-${{ env.TAG_NAME }}-win-x86 && zip -r ../PTZControl2-win-x86.zip .)
           tar -czf PTZControlConsole-linux-x64-beta.tar.gz PTZControlConsole-${{ env.TAG_NAME }}-linux-x64-beta
   
       - name: Create Release
@@ -167,5 +199,7 @@ jobs:
             ./PTZControl-win-x86.zip
             ./PTZControlConsole-win-x64.zip
             ./PTZControlConsole-win-x86.zip
+            ./PTZControl2-win-x64.zip
+            ./PTZControl2-win-x86.zip
             ./PTZControlConsole-linux-x64-beta.tar.gz
       

README.md

@@ -16,9 +16,26 @@ verbs for camera discovery, camera selection, zoom, pan/tilt, presets, metadata,
 and diagnostics so PTZ camera actions can be integrated into existing production
 workflows.
 
+## Purpose of the PTZControl2 GUI
+
+`PTZControl2` is the fork's modern Windows GUI for interactive camera operation.
+It offers a larger, clearer, dark-mode capable control surface than the classic
+GUI while keeping the familiar preset and camera-slot workflow.
+
+![PTZControl2 dark-mode main window](docs/assets/ptzcontrol2-main-window.png)
+
+Highlights include large live-operation buttons, per-camera settings, preset
+names, camera aliases, optional live preview, camera diagnostics, picture
+controls, and Windows device display-name rename support with UAC elevation when
+required. See [PTZControl2 GUI](docs/ptzcontrol2.md) for details.
+
+PTZControl2 is currently promoted as a Windows application. Linux/macOS GUI
+behavior is not part of the supported release scope yet.
+
 Important additions in this fork include:
 
 - A .NET-based `PTZControlConsole` command-line application.
+- A modern Windows-only `PTZControl2` GUI application.
 - Cross-platform console support for Windows and experimental Linux builds, with
   macOS support planned for the same backend architecture.
 - Modern CLI verbs for device discovery, camera information, zoom, pan/tilt,
@@ -30,8 +47,8 @@ Important additions in this fork include:
   registry storage, while Linux/macOS use JSON metadata files.
 - Config export/import commands for moving preset names and camera slot aliases
   between systems.
-- GitHub Actions release packaging for the Windows GUI, Windows console builds,
-  and experimental Linux console builds.
+- GitHub Actions release packaging for the classic Windows GUI, PTZControl2
+  Windows GUI, Windows console builds, and experimental Linux console builds.
 - Guided Windows/Linux camera test scripts to collect reproducible feedback from
   real PTZ Pro 2 camera tests.
 
@@ -51,6 +68,7 @@ packaging, and cross-platform metadata work. See [LICENSE](LICENSE) and
 - [Command syntax](docs/syntax.md)
 - [Generated CLI help](docs/generated/cli-help.md)
 - [Generated example output](docs/generated/example-output.md)
+- [PTZControl2 GUI](docs/ptzcontrol2.md)
 - [Stream Deck guide](docs/streamdeck.md)
 - [Bitfocus Companion guide](docs/bitfocus-companion.md)
 - [Linux installation](install-linux.md)

docs/assets/ptzcontrol2-main-window.png

@@ -0,0 +1,46 @@
+# PTZControl2 GUI
+
+`PTZControl2` is the modern Windows GUI in this fork. It is designed for live
+camera operation where the classic GUI is too small, too dense, or too hard to
+use repeatedly during production work.
+
+![PTZControl2 dark-mode main window](assets/ptzcontrol2-main-window.png)
+
+## Why PTZControl2 exists
+
+The original `PTZControl.exe` remains available for compatibility, but
+`PTZControl2` provides a more operator-friendly control surface:
+
+- Larger preset, home, default, pan/tilt, and zoom buttons.
+- A clearer layout for live operation on smaller control displays.
+- Light and dark theme support.
+- A modern Settings dialog with camera, movement, preset, compatibility, and
+  appearance sections.
+- Better status feedback for success and warning states.
+
+## Main features
+
+- Camera selection by slot with compact names and full device path tooltips.
+- Camera slot aliases and preset names.
+- Per-camera movement settings such as pan/tilt inversion.
+- Per-camera compatibility options for standard UVC controls versus Logitech
+  extension controls.
+- Optional Windows live preview window for checking the selected camera image.
+- Camera monitor window with current zoom, pan, tilt, and picture-control
+  values.
+- Picture controls for supported cameras: brightness, contrast, sharpness, and
+  saturation.
+- Windows device display-name rename support with UAC elevation when required.
+
+## Platform scope
+
+PTZControl2 is currently promoted as a Windows GUI application. The project uses
+Avalonia, but Linux/macOS GUI behavior is not part of the supported release
+scope yet because camera control, live preview, and device rename features are
+currently Windows-oriented.
+
+## Relation to PTZControlConsole
+
+Use `PTZControl2` for interactive operation. Use `PTZControlConsole` for
+automation from scripts, Stream Deck, Bitfocus Companion, batch files, and other
+external control systems.