macOS: camera track fails with 'Frame dimension mismatch' / NotWriting when Insta360 Virtual Camera changes frame size (studio recording, 0.6.0)

Open
#2,724 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
rust

Research direction

Start by tracing camera capture in cap_recording::feeds::camera and the macOS MP4 encoder in cap_enc_avfoundation::mp4, where the logs show the negotiated and delivered frame sizes disagreeing. Check how the encoder handles mismatched dimensions and what camera recording tests cover this path. Done means frames are adopted or scaled consistently and the camera track finishes successfully when the virtual camera changes size.

Written by the indexing model from the issue text.

Description

bug macos
Description

On macOS, with the Insta360 Virtual Camera as the camera input, studio recordings sometimes lose the whole camera track. Cap's camera feed reports 1280x720, but the virtual camera delivers frames at a different size (3840x2160) partway into the start of the recording, or the encoder is initialised at 3840x2160 and then receives 1280x720 frames. Every mismatched frame is dropped ("to protect writer"), and when the recording stops the camera track fails with NotWriting. The screen and mic tracks are fine, so the result is a recording with no usable camera video.

Expected: the camera encoder should adopt the actual frame size (or scale frames to the encoder size) instead of dropping every frame once the size changes.

Reproduction

I don't have a deterministic repro. Observed 4 studio recordings in about 20 minutes with the same camera and settings; 2 of the 4 hit the bug, the other 2 recorded normally:

Recording (UTC) Camera encoder init Frames received Result
00:06 1280x720 3840x2160 mismatch from the first frame, 200+ dropped, camera track failed
00:08 3840x2160 1280x720 mismatch from the first frame, 100+ dropped, camera track failed
00:10 1280x720 1280x720 OK
00:23 1280x720 1280x720 OK (43 s, 1283 frames)

In every case Starting camera capture logged width=1280 height=720 frame_rate=30.0 pixel_format="BGRA", so the feed's advertised size and the delivered frame size disagree.

Log excerpts
INFO cap_recording::feeds::camera: Starting camera capture camera="Insta360 Virtual Camera" width=1280 height=720 frame_rate=30.0 pixel_format="BGRA"
INFO cap_enc_avfoundation::mp4: Initializing AVFoundation MP4 encoder (VideoToolbox hardware encoding) width=1280 height=720 pixel_format=BGRA frame_rate=Rational(30/1) ...
WARN cap_enc_avfoundation::mp4: Frame dimension mismatch, dropping frame to protect writer expected_width=1280 expected_height=720 frame_width=3840 frame_height=2160 mismatch_count=1
...
WARN cap_enc_avfoundation::mp4: Frame dimension mismatch, dropping frame to protect writer expected_width=1280 expected_height=720 frame_width=3840 frame_height=2160 mismatch_count=200
WARN cap_recording::output_pipeline::macos: Failed to finish camera MP4 encoder: NotWriting
WARN cap_recording::studio_recording: Optional recording track failed during stop track=Camera error=Failed to finish camera MP4 encoder: NotWriting

The second failing recording is the same with the sizes swapped (expected 3840x2160, frame 1280x720).

Additional Context
  • Cap version: 0.6.0 (the latest release at the time of writing)
  • Operating system, version: macOS 27.0.1 (26A434), Apple Silicon (Mac16,8, M4 Pro, 24 GB)
  • Camera: Insta360 Virtual Camera (model id vid D91F / pid B4D3 in Cap's logs)
  • Mode: Studio recording, screen + camera + Elgato Wave:3 mic

I have not checked whether the physical camera, without the virtual camera layer, reproduces this. The same pattern (a frame size that differs from what the feed negotiated) could affect any virtual camera that switches output size. Related but different: #2606 (main-thread panic in tauri-runtime-wry).

Dominant language
Rust
Stars
25k
Forks
2.4k
Avg merge
1d 8h
Merged PRs (30d)
676

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from CapSoftware/Cap

All issues in CapSoftware/Cap

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.