Skip to content

facetrack v1.2

Choose a tag to compare

View all tags
@legofsalmon legofsalmon released this 28 Jul 00:45
· 25 commits to main since this release
v1.2
411a52b

Capture cards, mask shaping, and machine-load safety.

Capture cards

  • Capture format and Capture driver are now panel controls (Input card). Pro cards usually refuse "auto" and need an exact signal — ask for 1080p50 and pick DirectShow and Blackmagic DeckLink / Magewell Pro / AVerMedia PCIe / AJA KONA come up on Windows. USB devices (Elgato, Magewell USB, AJA U-TAP) keep working everywhere.
  • Re-applying the same source reconnects with the current settings — also a manual kick for a card that has wedged. The camera scanner now probes 8 slots for multi-card machines.
  • README documents the per-vendor paths, plus an honest ST 2110 / Blackmagic IP10 status: no native software path (needs PTP NICs + Rivermax/MTL; IP10 has no public SDK), so use a DeckLink IP card inbound or an NDI→2110 gateway outbound.

Machine-load safety

Nothing previously limited how much of a machine facetrack could take — the AI runtimes default to every core. New Machine load panel card, both settings also enabled by the Power saver preset:

  • Limit CPU use — caps the ML runtimes to about a third of the cores, always leaving some in reserve (2 cores → 1, 12 → 4). Measured 448% → 347% CPU at the same frame rate on a 12-core Mac. On macOS only the ONNX models are capped (the OpenCV wheel uses GCD, which ignores thread limits); Windows caps both.
  • Auto relief (on by default) — if the pipeline cannot hold the frame budget for 5 seconds it sheds quality in three steps (silhouette less often → face finding every other frame → detector size capped), restoring itself once there is headroom. Your own settings are never rewritten.
  • Frame-rate ceiling — every source now paces to its own fps, so a 30 fps camera caps the loop at 30.

Cutout and panel

  • Silhouette margin (−30…+30 px): the people-shape equivalent of cutout margin. Shrinking trims the background fringe matting models leave on hair and shoulders.
  • Performance card bars now scale against the priciest stage so small stages are visible, with a stable layout at any value width.

Fixes

  • fps was reported optimistically — the average over-weighted cheap frames when work landed on alternate frames (a 30 fps source read as 37–41). It now averages frame time.
  • The frame pacer banked timing debt and burst to "catch up" under load.

Install: download the source ZIP below, then double-click Facetrack.app (Mac) or Facetrack Windows.bat (Windows). Model licences unchanged — see LICENSE (RVM is GPL-3.0, commercial use fine; SCRFD remains under InsightFace research terms).

Assets 2
Loading