OpenCore Legacy Patcher (OCLP) – USB Capture Card Troubleshooting Guide
================================================================

System Setup
------------
- Mac: Mac Pro 5,1 (Mid-2010)
- macOS: Sequoia (macOS 15.5) via OpenCore Legacy Patcher (OCLP)
- Video Capture Device: UGREEN USB Video Capture
- Camera: Panasonic Lumix GH4
- Software: Latest OBS Studio
- Patcher: Latest OCLP with full root patches applied

Symptoms
--------
- Capture card appears in OBS Studio
- No video feed appears (black screen)
- Camera is verified to be outputting signal

Troubleshooting Steps
=====================

1. GH4 HDMI Output Settings
---------------------------
- Menu > HDMI Rec Output:
    - HDMI Info Display = OFF (for clean HDMI)
    - HDMI Rec Output = Auto or 1080p
- Verify signal on TV/monitor directly

2. OBS Studio Configuration
---------------------------
- Add “Video Capture Device” > Select UGREEN card
- Try these settings:
    - Resolution: 1920x1080
    - FPS: 30 or 60
    - Format: MJPEG, YUY2, or H.264
    - Color Space: Rec.709
    - Color Range: Full or Partial
- Disable “Use Custom Audio Device”

3. System Check via QuickTime
-----------------------------
- QuickTime > File > New Movie Recording
- Select UGREEN as video source
- If black here too, issue is with macOS-level device handling

4. Hardware & Port Tests
------------------------
- Try all USB ports on the Mac Pro
- Use a powered USB 2.0 hub
- Avoid USB 3.0 ports if issues persist

5. OBS Logs
-----------
- Help > Log Files > View Last Log File
- Look for:
    - “device opened, no frames received”
    - “format not supported”

Advanced OCLP Debugging
=======================

1. Enable Verbose Boot
-----------------------
In OpenCore config.plist:
- boot-args: -v keepsyms=1 debug=0x100

2. USB Quirks in OpenCore
-------------------------
Under config.plist > Kernel > Quirks:
- Enable: XhciPortLimit = true
- Enable: DisableIoMapper = true
- Enable: ThirdPartyDrives = true (if relevant)

3. Re-Apply Post-Install Root Patches
-------------------------------------
- Run OCLP again > Apply all patches
- Ensure Legacy USB support is enabled

4. Test on Another OS
---------------------
- Boot into Linux or Windows on the same machine
- See if UGREEN card shows video input

Other Notes
===========
- UGREEN devices sometimes fail with macOS due to signal or format quirks.
- Elgato Cam Link or Magewell USB Capture HDMI are more reliable.
- UVC devices need proper USB driver mapping and AVFoundation support.

Support
-------
- GitHub Discussions: https://github.com/dortania/OpenCore-Legacy-Patcher/discussions
- Discord: https://discord.gg/oclp
- Useful logs to gather:
    - system_profiler SPUSBDataType
    - ioreg -l | grep -i uvc
    - OBS logs
    - Verbose boot output

Prepared by ChatGPT – May 2025