Run the application
Open the extracted folder and double-click:
Background mode (optional)
Run hidden with production settings in PowerShell:
Start-Process -FilePath ".\SmartWorkz.SolverPro.Client.exe" -WindowStyle Hidden
appsettings.json.Ctrl+Shift+0 — Clear context
Ctrl+Shift+1 — Capture screenshot
Ctrl+Shift+2 — Transcribe (fast text answer + optional code)
Ctrl+Shift+3 — Ask with AI (images + audio + transcription)
Ctrl+Shift+4 — Analyze error
App won't start on Windows
Install the .NET 8.0 Desktop Runtime from dotnet.microsoft.com. Run dotnet --version in PowerShell to verify.
macOS: "App is damaged" or blocked by Gatekeeper
Go to System Settings → Privacy & Security → Open Anyway. Or run: xattr -cr ./SmartWorkz.SolverPro.Client in Terminal.
Cannot connect to server (Hub status red)
Check that the server is running and the URL in appsettings.json is correct. Ensure firewall allows the server port. Try ping <server-host> from the client machine.
Audio transcription not working
Ensure a microphone is connected and accessible. Check Azure Cognitive Services credentials in server appsettings.json. The Audio status in System tab will show red if not configured.
AI responses not coming back
Check the AI and API status indicators in the Settings → System tab. Verify your API key is valid and has remaining quota. Check server logs for detailed error messages.
Screenshot capture not working on Windows
Run the client as Administrator. Some apps (games, protected windows) block screenshot capture — this is expected behavior.
Android APK install blocked
Enable Install from unknown sources for your file manager app in Settings → Apps → Special app access → Install unknown apps.
Mobile WebView not loading
Ensure the server URL in the MAUI app config points to your server. Check that your device can reach the server on the same network or via internet.