📚 Zap Platform Documentation

Complete documentation for the Zap platform, including development guides, testing procedures, and infrastructure details

Core Documentation
Platform-wide documentation and guides
Topic Documentation
Specific guides and troubleshooting
External Links
Camera Freeze Troubleshooting
WebRTC camera issues and solutions • Topic Documentation

Windows 11 Camera Freeze Troubleshooting Guide

Problem

Camera video freezes intermittently in Chrome, Edge, and other browsers. The issue affects both normal and incognito/private modes. Sometimes it works, sometimes it doesn't.

Root Cause

This is a Windows system-level issue, not a code or browser issue. The Windows Camera FrameServer service gets into a bad state, causing video frames to stop rendering even though the camera stream is active.

Quick Fix

Option 1: Run the Fix Script

Open PowerShell as Administrator and run:

cd C:\path\to\zap\scripts
.\fix-camera-win11.ps1

This script will:

  • Kill all browser processes
  • Restart Windows FrameServer service
  • Clear temporary camera files
  • Report camera and service status

    • Option 2: Manual Fix

  • Close all browsers completely (check Task Manager)
  • Restart FrameServer service:
    •    Restart-Service -Name "FrameServer" -Force
   ``

  • Wait 5 seconds
    • 

  • Open only Chrome Incognito
    • 

  • Test camera
    • Advanced Troubleshooting
    If Quick Fix Doesn't Work
    1. Nuclear Option - Reset Camera Devices
    
Run the fix script with the     -Nuclear flag:
    powershell .\fix-camera-win11.ps1 -Nuclear 
    
This will disable and re-enable all camera devices.
    2. Disable Hardware Acceleration
    
The GPU may be causing rendering issues.
    Chrome:

  • Open chrome://settings/system
    • 

  • Turn OFF "Use hardware acceleration when available"
    • 

  • Restart Chrome
    • Edge:

  • Open edge://settings/system
    • 

  • Turn OFF "Use hardware acceleration when available"
    • 

  • Restart Edge
    • 3. Check GPU Status
    

  • Open chrome://gpu in Chrome
    • 

  • Look for:
    • 
   - Problems Detected section - any warnings?
   - Graphics Feature Status - anything disabled or software-only?
   - Driver issues - any errors?
    4. Update GPU Drivers
    

  • Press Win + X, select Device Manager
    • 

  • Expand "Display adapters"
    • 

  • Right-click your GPU → "Update driver"
    • 

  • Restart computer
    • 5. Reset Windows Camera App
    powershell Get-AppxPackage WindowsCamera | Reset-AppxPackage 
    

    6. Check Camera Permissions
    powershell

    Check camera privacy settings

    Start-Process "ms-settings:privacy-webcam" 
    
Ensure:

    • "Camera access" is ON
      • 

    • "Let apps access your camera" is ON
      • 

    • Chrome/Edge are allowed
      • Diagnostic Commands
      Run these to gather information:
    powershell

    Check camera devices

    Get-PnpDevice -Class Camera | Format-Table Status, FriendlyName, InstanceId

    Check FrameServer service

    Get-Service FrameServer | Format-List

    Check browser processes

    Get-Process | Where-Object {$_.ProcessName -match "chrome|msedge"} | Format-Table ProcessName, Id, CPU, @{Name="Memory(MB)";Expression={[math]::Round($_.WorkingSet64/1MB, 2)}}

    Check camera-related processes

    Get-Process | Where-Object {$_.ProcessName -match "Camera|FrameServer|Video"} 
    

    Testing Procedure
    After applying fixes, follow this procedure:
  • Close ALL browsers (verify in Task Manager - no chrome.exe or msedge.exe)
    • 

  • Wait 10 seconds
    • 

  • Open ONLY Chrome Incognito
    • 

  • Navigate to: https://orcus.getzap.co/test-cam.php
    • 

  • Watch console logs (F12) for:
    • 
   - "Video playing event" → Good
   - "Video pause event" → Bad (but expected initially)
   - Check if     currentTime advances in console logs

  • If frozen: Check currentTime in console - if stuck, it's a rendering issue
    • 

  • Try manual play: Run in console:
    • 
       `javascript
   document.getElementById('video').play()
   `
    Known Issues
    Windows 11 FrameServer Bugs
    

  • FrameServer service can get stuck in a bad state
    • 

  • Multiple browser instances can confuse the service
    • 

  • Service doesn't properly release camera between sessions
    • Hardware Acceleration Issues
    

  • Some GPU drivers have bugs with video rendering
    • 

  • Intel integrated graphics are particularly problematic
    • 

  • Multi-monitor setups can cause issues
    • Browser Session Cleanup
    

  • Browsers don't always properly release camera when closed
    • 

  • Background processes can keep camera locked
    • 

  • Profile settings can interfere with camera access
    • 


    Prevention
    Best Practices
    

  • Use Incognito/Private mode for testing (cleaner state)
    • 

  • Close browsers completely between tests (not just tabs)
    • 

  • Wait a few seconds between closing and reopening browsers
    • 

  • Restart FrameServer regularly if issues persist
    • 

  • Disable hardware acceleration if you have GPU driver issues
    • Regular Maintenance
    
Run the fix script daily if issues are frequent:
    powershell

    Add to Task Scheduler for automatic execution

    $trigger = New-ScheduledTaskTrigger -Daily -At 9am $action = New-ScheduledTaskAction -Execute "PowerShell.exe" -Argument "-File C:\path\to\fix-camera-win11.ps1" Register-ScheduledTask -TaskName "Fix Camera" -Trigger $trigger -Action $action -RunLevel Highest     `

    Still Not Working?

    If the issue persists after all fixes:

  • Hardware issue: Camera may be failing
    • - Test camera in Windows Camera app - Try a different USB port - Try an external USB camera

  • Driver issue: Reinstall camera drivers
    • - Device Manager → Camera → Uninstall device - Restart computer (Windows will reinstall)

  • Windows issue: System files may be corrupted
    • `powershell sfc /scannow DISM /Online /Cleanup-Image /RestoreHealth `

  • Last resort: Windows reset
    • - Settings → System → Recovery → Reset this PC

    Contact

    If issues persist, provide:
  • Output from .\fix-camera-win11.ps1 -DiagOnly
  • Content of log file from %TEMP%\camera-fix-*.log
  • Screenshot of chrome://gpu`
  • Camera device model and driver version

    • ← Back to Zap Projects 🖥️ Orcus Server Docs →