> For the complete documentation index, see [llms.txt](https://docs.yanusstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yanusstudio.com/yanuslive-pro/function-guide/bunshin-headcam.md). # BUNSHIN Headcam BUNSHIN HMC USB and DeckLink connection, operation, and troubleshooting guide. ## BUNSHIN Camera User Manual **Target Users:** BUNSHIN Head-Mounted Camera (HMC) operators\ **Supported Input Paths:** USB / DeckLink SDI / DeckLink HDMI\ **Reference:** Current YANUS LIVE PRO implementation, September 2026 ### Connection methods | Connection method | YANUS LIVE PRO profile | Recommended use | | -------------------------- | ---------------------- | -------------------------------------- | | HDMI → USB capture device | **BUNSHIN Headcam** | Simple single-camera setup | | SDI → Blackmagic DeckLink | **BUNSHIN DeckLink** | Studio and reliable professional setup | | HDMI → Blackmagic DeckLink | **BUNSHIN DeckLink** | Multi-channel DeckLink HDMI setup | #### Abbreviations * **HMC** — Head-Mounted Camera * **SDI** — Serial Digital Interface * **HDMI** — High-Definition Multimedia Interface * **UVC** — USB Video Class * **MSMF** — Microsoft Media Foundation * **MJPG** — Motion JPEG * **BNC** — Bayonet Neill–Concelman coaxial video connector {% hint style="warning" %} **BUNSHIN Headcam** and **BUNSHIN DeckLink** are separate camera profiles. Do not assign the DeckLink profile to a USB capture device. Do not assign the USB profile to a native DeckLink input. {% endhint %} ### Quick profile selection #### USB capture device Select **Camera Profile → BUNSHIN Headcam**. | Setting | Recommended value | | ------------ | --------------------------------------------------- | | Resolution | **1024 × 768** | | Frame rate | **60 fps** | | Format | **MJPG** | | Backend | **Auto / Microsoft Media Foundation** | | Source Shape | **Off**, unless aspect-ratio correction is required | The current configuration targets 60 fps by default. #### Blackmagic DeckLink Select **Camera Profile → BUNSHIN DeckLink**. Do not force resolution, frame rate, MJPG/YUY2 format, or DirectShow/Media Foundation. The DeckLink backend detects the incoming signal and uses the detected mode. ### USB workflow #### Hardware connection ``` BUNSHIN Camera → HDMI output / wireless video system → HDMI-to-USB capture device → PC USB port → YANUS LIVE PRO ``` Windows must recognize the capture device as a camera. A previous project configuration identifies it as **HDMI USB Camera**. The USB path uses a standard Windows video device. #### Camera setup 1. Start YANUS LIVE PRO. 2. Open the required Camera Slot. 3. Set the source to **Camera**. 4. Select **Camera Profile → BUNSHIN Headcam**. 5. Select the connected USB capture device. 6. Confirm the recommended settings. 7. Connect the camera. 8. Confirm live video, face tracking, orientation, and stable frame rate. | Setting | Recommended value | | ------------ | ----------------------------------- | | Resolution | **1024 × 768** | | Frame rate | **60 fps** | | Format | **MJPG** | | Backend | **Auto / Media Foundation** | | Rotation | Match the camera mounting direction | | Source Shape | Normally **Off** | #### Why 1024 × 768 at 60 fps Facial capture prioritizes stable 60 fps, lower latency, reduced CPU/GPU overhead, fast facial response, and sufficient landmark detail. Use **1024 × 768 @ 60 fps** for USB BUNSHIN capture. Stable frame rate is generally more valuable than unnecessarily high resolution. ### DeckLink workflow #### Recommended SDI configuration ``` BUNSHIN Camera → Teradek Bolt TX → Wireless Video Link → Teradek Bolt RX → SDI / BNC → Blackmagic DeckLink → PC → YANUS LIVE PRO ``` Historical documentation also shows AJA U-TAP SDI and HyperDeck Studio configurations. Use tested hardware. Capture interfaces can behave differently. #### Required software Install **Blackmagic Desktop Video 14.2 or later**. YANUS LIVE PRO uses the Blackmagic runtime to enumerate and communicate with native DeckLink hardware. Restart Windows after installation or driver updates. #### Connect a DeckLink camera 1. Select **Camera Profile → BUNSHIN DeckLink** in the Camera Slot. 2. Select the corresponding DeckLink input. 3. Confirm the live image and face tracking. Typical entries are **DeckLink input \[SDI]** and **DeckLink input \[HDMI]**. Each physical input is an independent camera source. One Camera Slot does not silently switch to another input. #### Resolution and frame rate DeckLink detects the camera output automatically. ``` Camera / converter output → DeckLink signal detection → YANUS LIVE PRO → Tracking pipeline ``` Detected modes can include `1920 × 1080 @ 59.94`, `1920 × 1080 @ 60`, `1920 × 1080 @ 30`, `1280 × 720 @ 59.94`, and `1280 × 720 @ 60`. Configure the mode at the camera, wireless receiver, or converter. Do not force it in YANUS LIVE PRO. #### Connection states ``` Disconnected → Connecting → Signal Locked → Connected ``` The input is ready when video appears and facial tracking begins. ### Signal and device states #### NO SDI SIGNAL / NO HDMI SIGNAL The DeckLink device exists, but no valid video signal is arriving. This does not necessarily mean the card failed. Check the chain in this order: 1. BUNSHIN camera power. 2. Teradek TX power. 3. Teradek RX power. 4. Wireless link status. 5. SDI or HDMI cable. 6. Converter output. 7. DeckLink input port. #### FORMAT CHANGING This temporary state can appear after resolution, frame rate, scan type, or color format changes. ``` Locked → Format Changing → New Format Detected → Locked ``` A short interruption is normal. An example is `1080p 59.94 → 720p 59.94`. #### DEVICE MISSING / UNAVAILABLE This differs from **NO SIGNAL**. **NO SIGNAL** means the card is present without an incoming signal. **DEVICE MISSING / UNAVAILABLE** means the card cannot be accessed. Check Windows Device Manager, Blackmagic Desktop Video Setup, device status, PCIe installation, driver installation, and restart Windows. ### HDMI support and aspect ratio YANUS LIVE PRO uses the same DeckLink backend for SDI and HDMI capture. ``` BUNSHIN / Video Source → AV-to-HDMI Converter → DeckLink Quad HDMI Recorder → PC → YANUS LIVE PRO ``` Use **BUNSHIN DeckLink**. HDMI-only hardware uses an HDMI input automatically. SDI-only hardware uses an SDI input. On unusual multi-connector hardware, Blackmagic Desktop Video may select the active connector. Some converters place a 4:3 source in a 16:9 HDMI frame. The face may look stretched and tracking quality may drop. Select **Source Shape → 4:3**. Use **Source Shape → Off** when the image already has correct proportions. #### Interlaced video An interlaced source, such as **1920 × 1080i**, can display correctly but may cause combing artifacts and reduced landmark stability. Configure the source or converter for **1080p** or **720p Progressive** whenever possible. ### Camera hot-swap behavior | Event | Expected behavior | | ---------------------------------- | --------------------------------------------------- | | USB camera disconnected | Reconnecting → same device rediscovered → Connected | | DeckLink signal cable disconnected | NO SIGNAL → same DeckLink device remains assigned | | DeckLink card removed or disabled | Device Missing → Reconnecting / Unavailable | When the original device returns, the same stable device reconnects. A Camera Slot does not adopt a different physical camera automatically. ### Recording guidance Do not change camera hardware while recording a Take unless necessary. ``` Connect Camera → Confirm Image → Confirm Tracking → Confirm Audio → Start REC ``` Avoid unplugging USB devices, changing DeckLink assignments, disabling capture cards, or replacing a source during recording. This maintains consistent Take metadata and media. ### Pre-recording checklist #### USB BUNSHIN * [ ] BUNSHIN camera powered. * [ ] USB capture device connected. * [ ] `BUNSHIN Headcam` selected. * [ ] `1024 × 768`, `60 fps`, and `MJPG` selected. * [ ] Auto / Media Foundation backend selected. * [ ] Live image and facial tracking are active. * [ ] Rotation and aspect ratio are correct. #### DeckLink BUNSHIN * [ ] DeckLink card detected. * [ ] Blackmagic Desktop Video installed. * [ ] `BUNSHIN DeckLink` selected. * [ ] Correct SDI or HDMI input selected. * [ ] Signal Locked and live image visible. * [ ] Resolution, FPS, aspect ratio, and tracking are correct. * [ ] Short recording test completed. ### Quick troubleshooting | Symptom | Possible cause | Recommended action | | ------------------------------------- | ----------------------------- | ----------------------------------------------------- | | USB camera does not reach 60 fps | Wrong capture mode or backend | Use **1024 × 768 @ 60 MJPG**. Check Media Foundation. | | USB device is missing | Windows/UVC issue | Reconnect the USB device and refresh. | | DeckLink device does not appear | Driver/runtime issue | Install or update Blackmagic Desktop Video. | | Only `Blackmagic WDM Capture` appears | WDM path is used | Check native DeckLink runtime and device detection. | | `NO SDI SIGNAL` | SDI path missing | Check camera, Teradek, and BNC cable. | | `NO HDMI SIGNAL` | HDMI path missing | Check converter and HDMI cable. | | `Unavailable` | DeckLink hardware unavailable | Check driver, PCIe, and Device Manager. | | Face looks stretched | 4:3 source in a 16:9 frame | Set **Source Shape → 4:3**. | | Motion has combing artifacts | Interlaced video | Switch the source or converter to Progressive. | | Black frame after format change | DeckLink is renegotiating | Wait until the signal returns to Locked. | | Camera cannot change during REC | Recording protection | Stop recording before changing devices. | ### Advanced diagnostics This section is for administrators and developers. Runtime configuration: ``` %LOCALAPPDATA%\MultiExpression\config ``` The repository-root `config.json` is a developer working file. It is not the deployed runtime configuration. Log locations: ``` %LOCALAPPDATA%\MultiExpression\logs\MultiExpression.log %TEMP%\MultiExpression.log ``` The current configuration uses target FPS **60**, recording-relative timecode, the system clock as master clock, playback alignment, and **2 ms** synchronization tolerance. ### Field verification For a new BUNSHIN / DeckLink system: 1. Confirm the DeckLink device appears and assign Camera Slot 1. 2. Verify the live image and stable frame rate for at least two minutes. 3. Disconnect the SDI/HDMI cable and confirm **NO SIGNAL**. 4. Reconnect after about one minute and confirm **Locked / Connected**. 5. Change source resolution or frame rate and confirm automatic detection. 6. Disable and re-enable the DeckLink card. 7. Confirm reconnection to the same physical input. 8. Test a USB camera and DeckLink camera simultaneously. 9. Record a short Take and verify the expected video and metadata files. For a four-input DeckLink HDMI system, assign each HDMI input to a different Camera Slot. Disconnect HDMI 1 and confirm only Camera Slot 1 loses signal. Run all four inputs for 30 minutes, repeat reconnect tests, then record a short Take using all inputs. ### Historical hardware recommendations Earlier BUNSHIN documentation lists these reference configurations: * **AJA U-TAP SDI + BUNSHIN HMC Pro** * **HyperDeck Studio + BUNSHIN HMC Pro** HyperDeck Studio can operate independently of PC performance. Ethernet provides control, while USB can send video to the PC for display. These are historical configurations. YANUS LIVE PRO also has a native DeckLink camera path. ### Operating summary * **USB:** Use **BUNSHIN Headcam** with `1024 × 768`, `60 fps`, `MJPG`, and Media Foundation. * **DeckLink:** Use **BUNSHIN DeckLink** with Blackmagic Desktop Video and automatic input detection. * **Before REC:** Verify video, tracking, signal state, and audio.