Kaish Capture Manual

1. Install and unlock Capture

1. Download the current public Kaish Capture DMG.
2. Drag Kaish Capture to Applications, eject the DMG, and open the Applications copy.
3. Sign in with the account assigned Capture access.
4. Allow Camera, Microphone, Local Network, and folder access only as the chosen source and workflow require them.

Capture requires signed-in access for protected capture, review, save, and export commands while preserving existing local packages. If access behaves unexpectedly, sign in again and contact support before using customer work.

2. Choose the video source

Capture refreshes compatible source choices when Setup opens or sources change. Select the named source explicitly; the Blackmagic default label is a route, not proof that a device is connected.

3. Use OBS for the current no-hardware workflow

1. In OBS, create a scene and add the browser, camera, capture card, or network input.
2. Confirm OBS canvas and frame rate.
3. Choose Start Virtual Camera.
4. In Capture Setup, choose OBS Virtual Camera.
5. Select the audio device separately if OBS Virtual Camera does not expose the required audio.
6. Record one minute, Stop, reopen the result, and check picture and sound.

4. Prepare Blackmagic ingest

1. Install the supported Blackmagic Desktop Video version and restart when required.
2. Confirm UltraStudio or another supported DeckLink device appears in Desktop Video Setup.
3. Connect HDMI or SDI and match the source resolution and frame rate.
4. Close Media Express and any other app holding the device.
5. Choose the direct Blackmagic route in Capture and confirm live video and audio.

A device appearing in Desktop Video does not guarantee a correct signal. Test the exact cable, switcher/camera output, format, and recording destination.

5. Create the session before recording

1. Choose New Session.
2. Enter a clear session name and optional opponent or event.
3. Choose the sport profile, recording quality, and destination folder.
4. Confirm source, format, audio, storage, remaining capacity, and Ready state.
5. Keep the destination drive connected and awake.

Name test sessions clearly. Never record a real game into an old test package or a nearly full system drive.

6. Record and mark the game

1. Press Record and confirm elapsed time and file size advance.
2. Open the Code Window and confirm its target is Live Capture.
3. Use instant markers for point events and manual markers for start/end events.
4. Apply lead and lag only when pre-roll or post-roll is required.
5. Watch dropped-frame, storage, signal, and audio status during the session.
6. Press Stop and wait for finalization before moving files or disconnecting storage.

Marker creation and clip preparation are designed to stay off the live-preview path. If a click visibly freezes preview, preserve the package and report the source, format, lead/lag, and exact build.

7. Record periods or segments safely

1. Stop and finalize the current segment.
2. Start the next segment within the same session when it belongs to the same game.
3. Confirm the new movie filename and continuous session timing.
4. Do not rename, move, or delete a segment while the session is open.

Stopped time is not part of recorded-video time. Imported period movies can also be appended in their intended order where the current postgame workflow offers that action.

8. Use Bench DVR only on the supported path

Bench DVR uses the direct Blackmagic capture backend. OBS and generic AVFoundation camera sources can record normally but do not provide the protected DVR stream.

1. Enable DVR before the Blackmagic recording begins.
2. Wait for the first finalized ready chunk.
3. Open DVR Review on Mac or connect an iPad running Kaish App on the same LAN.
4. Replay ready media while the main preview remains live.
5. Return to live before resuming normal bench use.

Pairing may need to be repeated after the DVR server restarts. Be ready to enter the new six-digit code.

9. Review the completed session

1. Open Review Video or the saved .kaishcode.
2. Confirm every segment and the full timeline duration.
3. Play an early, middle, and late marker clip.
4. Add notes or labels needed for handoff.
5. Relink missing external media through the file or parent-folder picker, then save.

A current portable .kaishcode package may contain its media. Legacy or reference-style files may keep external paths and require relinking.

10. Code an existing video

1. Choose Review Video and add one movie or ordered segment movies.
2. Open the intended Code Window and target Review Video.
3. Import supported XML or JSON review data only after media order and duration are correct.
4. Play representative rows and verify clip boundaries.
5. Save an editable .kaishcode package before exporting a handoff.
6. If saved media moved, use the visible relink action, verify the active segment, and save again.

The editable Review package and the share file serve different purposes: .kaishcode preserves Review work for Capture or Analyst, while Capture Share File JSON carries markers and video references into Kaish App.

11. Combine compatible Kaish timelines

1. Choose File → Combine .kaishcode Files….
2. Add two or more compatible files from Capture, Analyst, or another supported Kaish workflow.
3. Arrange them in the intended game order.
4. Save a new combined package; do not overwrite an original.
5. Open the output and verify segment order, duration, tags, and media.

There is no intended two-file limit. Combination should create a new result and leave every source file unchanged.

12. Hand work to App or Analyst

Send a Review scope to Analyst

1. In Review Video, switch to the intended Current Segment or Full Game scope.
2. Select row checkboxes for a row-based handoff, or select individual clips for a clip-based handoff.
3. Open Send to Analyst and choose Selected Rows…, Selected Clips…, or Complete Timeline….
4. Choose a destination for the portable .kaishcode. Capture includes only the requested tags and copies the available source media needed by the package.
5. Open the saved package in Analyst and verify segment order, continuous timing, notes, labels, and representative clips.

Send Capture markers to Kaish App

1. Use Export Capture Share File (JSON) after the session or Review project is ready.
2. In Kaish App, import that Capture Share File into the correct finalized game and segment, or use the supported New Game import.
3. Attach or relink the source video if the receiving device cannot resolve it, then verify several tags.

A Capture Share File JSON is not an Analyst .kaishcode package. Keep the original Capture project and media until the intended receiver opens the handoff and representative clips play.

13. Manage storage and cleanup

1. Record to a tested local or external drive with comfortable free space.
2. Keep active packages, recovery sidecars, and movie files together.
3. After verification and backup, archive old sessions to external storage.
4. Remove old installers and duplicate test exports only after confirming the current installer and package copies.

14. Troubleshoot without damaging the session

15. Know the current platform limits

• Only direct Blackmagic capture supports the protected Bench DVR path.
• OBS can route SRT, NDI, browser, and other supported sources into Capture; Capture receives OBS’s composed output.
• Use a backup venue recorder.
• Pair again after the DVR server restarts.
• Hardware depends on drivers, cabling, source format, macOS permissions, and storage performance.

Game-day readiness checklist

1. Current Capture release and signed-in account.
2. Chosen source, picture, audio, and format verified.
3. Destination drive and free space verified.
4. One-minute recording reopens and scrubs.
5. Multiple tag clicks do not hitch live preview.
6. Stop/finalize and postgame clip playback pass.
7. If used, Blackmagic DVR and current App Store iPad pairing pass on the venue LAN; the fallback OBS or local recording path is ready.