2026-09-25 · progress-23 · Linux/macOS 지원은 사용자의 추가 요청 E05
현재 결과: Windows 전용 GUI 제한을 제거하고 공통 앱에 OS별 영상·입력 처리를 연결했습니다. Linux X11의 실제 캡처·H.264/H.265 인코딩·디코딩·입력 시험과 Linux 앱 창 실행을 확인했습니다. macOS 전용 모듈은 Apple Silicon·Intel 대상 Rust 타입 검사를 통과했지만, 전체 앱의 네이티브 빌드와 실제 Mac 실행은 아직 확인하지 못했습니다.
2026-09-26 후속: progress-27 실제 Mac 빌드·게시에서 Apple Silicon 전체 앱과 내장 FFmpeg를 게시하고 GUI·합성 H.264/H.265 VideoToolbox→CPU 디코딩을 확인했다. 아래 progress-23 설명은 최초 포트 시점의 기록이며, Intel·TCC·OS 간 실제 세션·GPU 디코드/표시는 여전히 미완료다.
개발 계획·구현 현황 · 검증 기록 · 여러 화면·가상 디스플레이
1. 무엇을 공통으로 쓰고 무엇을 바꾸나
기기 등록·관리자 승인·기기 키·접속 비밀번호·목록·직접 UDP·WSS 대체 경로·화면 ID는 공통입니다. 같은 사용자 앱에서 연결과 호스팅을 제공합니다. Windows는 기존 notparsec.exe, Linux는 notparsec, macOS는 동일 실행파일을 포함한 .app 번들을 사용합니다.
OS마다 달라지는 것은 화면을 얻는 방법, 인코더·디코더, 화면 표시, 키보드·마우스 주입, 권한과 프로필 위치입니다. 이를 crates/platform 경계로 분리했습니다. Windows 구현은 기존 crates/platform-win의 DXGI·NVENC/MFT·D3D11 경로를 계속 사용합니다. 새 OS 지원 때문에 Windows 영상을 FFmpeg 경로로 바꾸지 않았습니다.
Linux/macOS는 먼저 FFmpeg를 별도 프로세스로 사용하는 초기 호환 경로를 연결했습니다. 이는 Parsec의 내부 소스·프로세스 구조를 그대로 복원한 구현이 아닙니다. 기존 Windows 기준 150-104a의 코어 SHA-256은 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f이며, 다른 OS의 Parsec 바이너리는 아직 동일 조건으로 분석·실행하지 않았습니다.
2. 플랫폼별 구현과 검증
| 항목 | Linux | macOS |
|---|---|---|
| Computers·Settings·등록·연결 UI | 공통 GUI 연결, Xvfb에서 실제 창 확인 | 공통 GUI 코드 연결, 전체 앱 빌드·실행 미검증 |
| 화면 캡처 | X11/RandR + FFmpeg x11grab, 실제 가상 X 서버 시험 | CoreGraphics 화면 열거 + AVFoundation, 코드·타입 검사 |
| H.264/H.265 인코딩 | NVENC → VAAPI → 소프트웨어 순서로 초기화 시도 | VideoToolbox → 소프트웨어 순서로 초기화 시도 |
| 하드웨어 인코더 검증 | 이 시험 환경은 GPU 사용 불가. 소프트웨어 경로만 실제 확인 | 실제 Mac 필요 |
| 디코딩·표시 | FFmpeg 소프트웨어 디코드 → RGBA → OpenGL 업로드 | 동일 초기 호환 경로, 실제 실행 미검증 |
| 마우스·키보드 | XTEST, 선택 모니터 좌표와 키 해제 시험 | CoreGraphics 이벤트, 손쉬운 사용 권한 검사 |
| 화면 전환·추가 | 공통 /7 제어·화면별 디코더·추가 창 코드 재사용. 실제 여러 모니터 시험 남음 |
같은 코드, 실제 여러 모니터 시험 남음 |
| Wayland | 뷰어 GUI 빌드 경로 포함, 실제 실행 미검증. 호스팅 미구현 | 해당 없음 |
| Virtual Displays·Privacy·종료 잠금 | OS 전용 구현 미완료, 동작하는 설정으로 표시하지 않음 | OS 전용 구현 미완료 |
| 자동 업데이트 | 초기 Unix 패키지는 수동 업데이트 | 초기 Unix 패키지는 수동 업데이트 |
Parsec의 현재 공식 기능표는 OS별 기능 범위가 다르다는 근거로 참조했습니다. 공식 호환성 안내에서는 Linux 호스팅을 지원하지 않는다고 설명합니다. 우리의 Linux 호스팅은 E05 아래에서 작업한 확장이며, 원본 Linux 기능과 같다고 표시하지 않습니다. 최신 웹 문서를 보관한 Windows 150-104a 전체의 사양으로 대체하지도 않습니다.
3. 영상이 오가는 방법
Linux X11 / macOS AVFoundation
→ FFmpeg 캡처·인코더
→ H.264/H.265 Annex B access unit
→ 기존 인증 연결과 /7 화면별 패킷
→ FFmpeg 디코더
→ RGBA 프레임
→ 공통 GUI의 화면별 텍스처·창
파이프에서 한 번 읽은 데이터가 영상 한 프레임이라는 보장은 없습니다. 그래서 AUD(access unit delimiter)를 삽입하고 시작 코드가 여러 읽기로 나뉘는 경우까지 처리합니다. 첫 프레임은 키프레임인지 확인합니다. 디코더에는 참조 프레임을 순서대로 전달하며, 이미 디코딩한 화면의 표시 큐만 제한합니다. 파이프 정체는 무한 대기로 숨기지 않고 기존 키프레임 복구 경로로 넘깁니다.
시험 중 인코더와 비트스트림 필터가 각각 AUD를 삽입해 중복 경계가 생기는 문제를 발견했습니다. 인코더의 중복 삽입 옵션을 제거하고 한 곳에서만 경계를 넣도록 수정한 뒤, H.264·H.265의 실제 영상 왕복을 다시 확인했습니다.
초기 Unix 경로에는 CPU 메모리 복사와 OpenGL 업로드가 남습니다. 따라서 Windows D3D11 경로나 Parsec의 지연·CPU 사용량과 같다고 말할 수 없습니다. UI도 이를 Hardware 디코더라고 표시하지 않습니다. 순수 Encode·Decode 시간을 보조 프로세스 대기와 분리하지 못한 경우 —로 표시하고, 기존 Network RTT 측정은 유지합니다.
대역폭 변경은 실제 인코더에 전달하지만 현재 FFmpeg 프로세스를 재시작합니다. 해상도 변경·키프레임 요청도 같은 제약이 있어 잠깐 멈출 수 있습니다. 비트레이트 변경 중에는 협상된 코덱을 고정하여 화면 형식 응답 없이 H.264에서 H.265로 바뀌지 않도록 했습니다. 장기적으로는 네이티브 미디어 API·실시간 재설정·GPU 텍스처 공유로 교체할 부분입니다.
FFmpeg 입력 장치의 옵션 근거는 공식 devices 문서입니다. FFmpeg 실행파일은 번들하지 않으며 사용자가 설치한 빌드에 따라 코덱과 라이선스가 달라집니다.
4. Linux: X11과 Wayland를 구분해야 하는 이유
X11은 RandR 화면 목록과 XTEST 입력을 사용합니다. 선택 화면 안의 0~65535 좌표를 해당 화면의 바탕화면 좌표로 변환합니다. 키·버튼 상태를 기억하고 포커스 해제·연결 종료 때 눌린 상태를 해제합니다. 비 ASCII IME 텍스트 입력은 아직 구현하지 않았습니다.
Wayland에서는 X11 방식으로 전체 데스크톱을 읽거나 입력할 수 있다고 가정하면 안 됩니다. XDG RemoteDesktop portal의 사용자 동의·세션·입력과 ScreenCast/PipeWire 스트림을 연결하는 구현이 필요합니다. 현재는 Wayland 호스팅 요청을 명시적으로 거절합니다. XWayland 화면 일부를 전체 데스크톱인 것처럼 전송하지 않습니다.
Linux 프로필은 $XDG_DATA_HOME/notParsec/desktop, XDG_DATA_HOME이 없으면 ~/.local/share/notParsec/desktop입니다. 기존 Unix 자격 증명 파일은 소유자 전용 0600으로 저장·검사합니다. Windows DPAPI와 동일한 저장 암호화나 macOS Keychain 통합을 구현했다는 뜻은 아닙니다.
5. macOS: 캡처·입력 권한과 앱 패키지
화면은 CoreGraphics로 열거하고, FFmpeg의 AVFoundation 장치 목록에서 Capture screen 항목을 찾습니다. 카메라와 화면이 같은 숫자 목록에 있으므로 디스플레이 ID를 그대로 카메라 인덱스로 사용하지 않습니다. 입력은 CoreGraphics CGEvent로 전달합니다. Retina 화면의 입력은 픽셀 수와 논리 좌표를 구분하여 디스플레이 bounds에 매핑합니다.
호스팅에는 macOS의 화면 기록과 손쉬운 사용 권한이 필요합니다. 현재 외부 FFmpeg 방식에서는 FFmpeg 실행파일에 대한 화면 기록 권한도 확인해야 합니다. 실제 권한 부여·거부·철회와 재실행 동작은 Mac에서 시험해야 합니다.
python3 scripts/build-portable.py를 Mac에서 실행하면 네이티브 실행파일·Info.plist를 포함한 notParsec.app을 만들고 로컬 시험용 ad-hoc 서명을 적용합니다. 이는 Developer ID 배포 서명·Apple 공증을 대신하지 않습니다. Intel과 Apple Silicon은 각 아키텍처에서 빌드하도록 했으며, Universal 앱이나 서명된 DMG를 완성한 상태는 아닙니다. GitLab에는 NOTPARSEC_MACOS_RUNNER=1로 켜는 네이티브 Mac 검사·패키징 작업도 추가했으며, 등록된 Mac runner에서 아직 실행하지 않았습니다.
이 Ubuntu 환경에서 macOS 전용 Rust 모듈은 양 아키텍처 대상으로 검사했습니다. 전체 앱 검사는 ring 네이티브 코드 빌드 단계에서 Apple용 C 도구체인이 없어 실패했습니다. 이 실패를 전체 Mac 빌드 성공으로 기록하지 않습니다.
6. 빌드·실행과 다음 검증
Linux 개발 패키지는 dist/notparsec-linux-x86_64.tar.gz에 생성합니다. 현재 패키지는 release 최적화 시험 빌드이며 서버의 Windows 자동 업데이트 파일과 별개입니다. 2026-09-26에 Mac별 웹 다운로드·패키지 게시 경로를 추가했습니다. 실제 Mac 빌드 파일 게시·실행 검증, Linux 웹 다운로드·Unix 자동 업데이트는 아직 남아 있습니다.
# Ubuntu의 미디어·GUI 런타임
sudo apt install ffmpeg libxkbcommon-x11-0 libegl1 libgl1
# 소스에서 현재 OS의 최적화 패키지 생성
python3 scripts/build-portable.py
# 개발 시험 패키지
CARGO_PROFILE_DEV_DEBUG=0 CARGO_INCREMENTAL=0 python3 scripts/build-portable.py --debug
Linux 패키지는 압축을 푼 뒤 ./notparsec로 실행합니다. 한글 글꼴이 없는 시스템에서도 등록 안내가 깨지지 않도록 SIL OFL 1.1의 NanumGothic 원본을 포함하고 출처·해시·라이선스를 기록했습니다. Mac은 deploy/desktop/PORTABLE_README.ko.md의 네이티브 빌드·권한 절차를 따릅니다.
다음 검증은 실제 Windows↔Linux↔Mac 두 PC 접속, Linux Wayland 뷰어, Mac TCC 권한과 Retina·다중 모니터, 실제 NVENC/VAAPI/VideoToolbox 장치, 지연·입력·종료 복구입니다. 이후 Wayland 호스팅, 네이티브 GPU 디코드·표시, OS별 가상 화면·프라이버시, 패키지 서명과 자동 업데이트를 연결합니다. 오디오·클립보드·게임패드 등 기존 미구현 기능도 OS 지원만으로 완료 처리하지 않습니다.