LookLoot Capture SDK for Overwolf Native

Use this package from a classic Overwolf Native app background window. It mirrors the public LookLootCapture API from the Electron SDK, but records through Overwolf Native replay, game-event, and input-tracking APIs by default.

pnpm add @lookloot/capture-sdk-overwolf-native

import { LookLootCapture } from "@lookloot/capture-sdk-overwolf-native";

const capture = new LookLootCapture({
  appId: "your-registered-app-slug",
  appVersion: "1.0.0",
  getDeviceToken: async ({ appId, appVersion, deviceName, anonymousId }) => {
    const res = await fetch("https://your-api.example.com/api/lookloot/device-token", {
      method: "POST",
      headers: { "content-type": "application/json" },
      body: JSON.stringify({ appId, appVersion, deviceName, anonymousId }),
    });
    const data = await res.json();
    return data.token;
  },
  uploadBridge: window.looklootOverwolfUploadBridge,
});

await capture.init();

The upload bridge is required for production video uploads because Overwolf replay capture returns a local media_path. JSON artifacts upload directly with browser fetch.

Capture backend choice

The default replay.captureBackend is "overwolf_recorder". Use it when you want Overwolf Recorder as the no-OBS capture engine:

const capture = new LookLootCapture({
  appId: "your-registered-app-slug",
  getDeviceToken,
  uploadBridge: window.looklootOverwolfUploadBridge,
  upload: { videoBackend: "chunked_hls" },
});

Use upload.videoBackend: "chunked_hls" for the custom growing HLS upload/playback stack. Mux Live upload mode is deprecated for production captures. Omit upload.videoBackend for one finalized replay upload after stop().

Developers can choose Overwolf Recorder in either Overwolf runtime. This is the classic Overwolf Native side of the same recorder path used by Overwolf Electron apps through @lookloot/capture-sdk with captureEngine: "overwolf-recorder".

The native recorder settings enable Overwolf game-window capture and game-only audio, with microphone capture disabled. They do not request default output-device or system audio capture, so unrelated apps such as browsers are not intentionally included in native recorder audio.

Apps that need user-selected window capture outside Overwolf Recorder support can opt into:

const capture = new LookLootCapture({
  appId: "your-registered-app-slug",
  getDeviceToken,
  replay: { captureBackend: "browser_display_media" },
  upload: { videoBackend: "chunked_hls" },
});

browser_display_media rejects monitor and browser-tab selections so it does not upload desktop capture. It uses playable WebM browser Blob chunks and does not require the file upload bridge for video.

Verify locally before upload

Use the native verification helpers from a debug menu or smoke-test command. They do not call getDeviceToken, create a LookLoot session, or upload anything.

const diagnostics = capture.getRuntimeDiagnostics();
const result = await capture.runLocalVerification({ durationMs: 8000 });
await capture.openLocalVerificationViewer(result);

Open a game, keep it focused, and press keys or click during the verification window. Passing local verification means result.video.ok === true, result.video.replayId is present, result.video.mediaPath or result.video.mediaUrl is present, and result.input.eventCount > 0.

After local verification passes, run a normal token-backed capture and verify remote ingestion with GET https://www.lookloot.gg/api/partner/captures/verify.