notParsec / 문서전체 문서

설명·설계 문서

Mac 호스트의 이중 커서 수정

design/MAC_CURSOR.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

2026-09-26 · progress-33 · F07 / F20 · E05

증상과 원인

사용자가 이전 권한 복구 후 Windows→Mac 연결 성공을 확인했지만, Windows 포인터와 함께 Mac 포인터도 원격 영상에 보인다고 보고했다.

기존 Mac 캡처 코드는 FFmpeg AVFoundation에 -capture_cursor 1을 전달했다. 이 옵션은 화면 픽셀 안에 Mac 포인터를 그린다. 동시에 Windows 뷰어는 로컬 OS 포인터를 표시하므로 두 포인터가 보인다. 영상에 들어간 포인터는 입력 전달·화면 캡처·인코딩·네트워크·디코딩을 거쳐 늦게 따라온다.

설치된 FFmpeg 6.1.6의 원본 libavdevice/avfoundation.m 850–853행과 908–911행에서 옵션 1은 AVCaptureScreenInput.capturesCursor=YES, 0은 NO를 설정하는 것을 확인했다. 기본값은 1224행에서 0이다. FFmpeg 공식 장치 문서도 같은 옵션을 설명한다. 배포에 포함된 정확한 소스 SHA-256은 d4fcb164028dd3beee5d92c0ac72e46aac6973c75ea12dc14de07bf8f407370a다.

변경

crates/platform/src/unix/macos.rs에서 Mac 캡처 옵션을 **-capture_cursor 0**으로 바꿨다. Mac 시스템 포인터를 화면 영상에서 제외하고 기존 뷰어의 로컬 포인터를 사용한다. Mac 실물 모니터의 포인터를 숨기는 설정은 아니다. 창·앱 안에서 직접 그리는 커서 모양까지 지우는 영상 후처리도 아니다.

이 변경은 H.264/H.265 인코더 앞의 공통 Mac 캡처에 적용된다. 입력 좌표 전달, 클릭, 키보드, 메뉴, Windows 영상 경로 및 네트워크 프로토콜은 바꾸지 않았다. Linux의 별도 X11 포인터 캡처는 이번 Mac 수정 범위에 포함하지 않았다.

수정 앱은 0.1.0 / 빌드 1790450061이며 Apple Silicon DMG로 패키징했다. 앱 SHA-256은 cb2295390ccca180dff1466524dac1ce1c230e66df15dbaef08f8496a2225286이다.

Parsec 원본 대조와 남은 차이

기준 Windows Parsec 150-104a 코어 SHA-256은 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f다. 보관한 디컴파일 의사 코드의 FUN_1800ddfa0에는 로그 이름 app_set_rgba_cursor, 색상 비트맵 생성, hotspot 설정, fIcon=0의 CreateIconIndirect 호출이 있다. 별도의 포인터 객체를 구성하는 근거다. 설정 테이블 0x18033d630에는 client_png_cursor도 있다. 이 자료는 원본 소스가 아니라 디컴파일 결과이며, 이름 없는 타입·구조와 전체 프로토콜은 미확인이다.

현재 수정은 중복된 Mac 캡처 포인터 제거다. 원본처럼 원격 포인터의 모양·hotspot·숨김 상태를 별도 메시지로 전달하는 전체 기능은 아직 구현하지 않았다. 따라서 글자 입력·창 크기 조절·앱별 특수 포인터가 원격 Mac의 모양과 완전히 같아지는 수정이라고 주장하지 않는다. F07/F20은 부분 구현 및 parity different를 유지한다. 원본 Mac Parsec의 캡처 내부 구조와도 직접 대조하지 못했다.

빌드마다 권한을 다시 승인해야 하나

progress-33 당시 패키지는 ad-hoc 시험 서명이었다. 앱 코드가 바뀌면 특정 코드 버전에 묶인 식별 조건도 바뀔 수 있다. 이전 권한 복구 때 확인한 것처럼 오래된 승인 기록이 새 앱과 일치하지 않으면 다시 승인이 필요하다. 단순히 빌드 번호 문자열만 바뀌는지 여부가 기준은 아니다.

일반적인 업데이트처럼 권한을 유지하려면 지속적으로 사용하는 서명 인증서와 호환되는 앱 식별 조건을 유지해야 한다. Apple은 개인정보 권한 식별에 designated requirement를 사용한다고 설명한다. Apple의 배포 서명 설명, 버전에 묶이는 ad-hoc 서명 설명.

progress-33 조사 당시 이 Mac의 코드 서명 인증서는 0개였다. Developer ID 서명·Apple 공증은 미구성이다. 이번 수정본은 새 ad-hoc 서명을 사용했으며 notParsec의 이전 Accessibility/ScreenCapture 기록만 정상 초기화하고 현재 앱 항목을 등록했다. 권한 동의는 Mac 사용자에게 맡긴다. 이전 서명을 흉내 내거나 OS 보호 기능을 끄지 않는다.

progress-35에서 이 문제에 고정 인증서 서명을 적용했다. 최초 전환 승인 후 실제 A→B 교체에서 권한 유지와 화면 캡처를 확인했다. 영상 프로세스의 capture_cursor=0도 관찰했다. Windows 뷰어의 최종 커서 관찰은 별도다.

검증

검증 기록 · 권한 불일치 복구 원인 · Mac 다운로드