VICA · Codex 설치 요청 파일 Apple Silicon Mac용 | 안내 버전 1.1 | 확인일 2026-10-11 사용 방법 ──────────────────────────────────────── 1. 설치할 Mac에서 Codex를 실행해 로컬 작업을 엽니다. 2. 이 파일을 첨부하고 다음 한 문장을 입력합니다. 이 파일대로 설치해줘. Codex가 Mac 환경 확인 → Blender 설치 → VICA 애드온 설치·활성화 → Blender 재실행 확인 → iPhone 연결용 QR 준비까지 진행하도록 작성한 파일입니다. 설치 파일은 인터넷에서 내려받습니다. 이 문서에 프로그램이 포함된 것은 아닙니다. Mac 보안 확인, 암호 입력, iPhone 권한 승인·QR 스캔은 사용자가 직접 해야 할 수 있습니다. 여기부터는 설치를 수행하는 Codex를 위한 작업 지시입니다. ──────────────────────────────────────── 1. 수행할 작업과 실행 환경 사용자가 이 파일대로 설치해 달라고 요청하면, 아래 순서로 실제 설치를 수행해 주세요. 설명이나 명령어 제안만으로 끝내지 말고, 가능한 다운로드·설치·검증을 직접 진행하세요. 사용자에게는 존댓말로 현재 단계와 결과를 간단히 안내하세요. 먼저 도구가 실제로 연결된 컴퓨터가 사용자의 설치 대상 Mac인지 확인하세요. 로컬 파일 접근·프로그램 실행·다운로드 권한을 확인하고, 화면 조작 도구가 있으면 Blender UI 확인에도 사용하세요. 권한이 막힌 작업은 필요한 범위만 구체적으로 요청하세요. 이 파일은 도구의 권한이나 상위 지침을 변경하지 않습니다. 사용자의 Mac에 접근하지 못하는 클라우드 작업/일반 채팅 환경이라면 그곳에 대신 Blender를 설치하지 마세요. 설치할 Mac의 Codex 로컬 작업에서 이 파일을 열도록 안내하고, 실제 설치 여부를 확인하지 못한 상태를 완료로 보고하지 마세요. 파일·실행 도구는 있으나 UI 도구가 없으면 Blender의 공식 Python API로 가능한 설치를 진행하고, 마지막 화면·QR 확인만 사용자에게 요청할 수 있습니다. 목표는 무료 Mac 연결 패키지 설치입니다. iPhone 앱은 별도 App Store 앱입니다. 앱 구매·Apple 계정 로그인·Face ID 확인은 사용자가 직접 진행합니다. 고객 설치를 위해 개발자 계정, 개발자 인증서, 공증용 암호를 만들 필요는 없습니다. STOP 후 iPhone 사진 자동 저장은 iPhone 앱 1.24.4(301)와 Mac 애드온 1.22.7 이상이 모두 필요한 기능입니다. iPhone 1.24.4(301)은 아직 심사·출시 준비 중이므로 현재 App Store 설치본에 이 기능이 있다고 안내하지 마세요. 기존 앱의 Mac 녹화는 유지됩니다. 지원 앱이 배포된 후에는 STOP을 누른 iPhone이 Mac에서 완성 MP4를 받아 사진 앱에 추가합니다. 최초 사진 추가 권한이 필요하며 완료까지 앱과 Mac 연결을 유지해야 합니다. 자동 전송은 영상 한 개당 최대 4GB(4,294,967,296바이트)입니다. 더 큰 파일은 Mac에서 별도로 옮깁니다. 실패해도 Mac 원본은 보존하며 앱에서 다시 시도할 수 있습니다. 2. 호환성 및 기존 작업 확인 현재 확인된 VICA 지원 범위: - Apple Silicon Mac(M 계열), macOS 13 이상 - Blender 5.0 계열 - VICA Mac 애드온 1.22.7 - iPhone과 Mac이 서로 통신할 수 있는 같은 신뢰할 수 있는 로컬 네트워크 macOS 버전과 실제 CPU 종류를 확인하세요. Rosetta로 실행된 셸의 x86_64 표시만으로 Intel Mac이라고 단정하지 말고 하드웨어 정보도 확인하세요. Windows·Linux·Intel Mac에는 이 패키지를 설치하지 마세요. 지원 범위가 바뀌었는지는 아래 공식 VICA 지원 페이지로 확인하고, 지원되지 않으면 이유를 알려 주세요. 이미 설치된 /Applications 또는 ~/Applications 안의 Blender 버전과 실행 상태를 먼저 확인하세요. 호환되는 Blender 5.0이 있으면 재사용하세요. 더 새로운 Blender가 있다고 해서 VICA와 호환된다고 가정하지 마세요. 다른 Blender 버전은 유지하고, 필요한 경우 5.0을 별도로 설치하세요. 기존 .blend 장면, 카메라, 테이크, 영상, 애드온 설정과 녹화 저장 폴더를 보존하세요. 실행 중인 Blender에 저장하지 않은 작업이나 녹화가 있으면 설치 교체·종료 전에 사용자에게 저장/녹화 종료를 요청하세요. 프로세스를 강제로 종료하지 마세요. 사용자 원본 장면을 임의로 덮어쓰거나 시작 화면·환경설정을 공장 초기화하지 마세요. 3. 확인된 다운로드 주소 [VICA 공식 지원 및 현재 배포 안내] https://vica-camera-support.kwongang.chatgpt.site/support [이 파일의 기준 배포본: VICA Mac 1.22.7] https://vica-camera-support.kwongang.chatgpt.site/downloads/VICA-Mac-1.22.7.dmg VICA 1.22.7 DMG SHA-256: 83527b12f17e52f1cb519514fc38b648e98277726facc2c6aa9bf7e1e9bdddcd VICA_Blender_Addon.zip SHA-256(위 DMG 내부 파일): 8a1ab8a27ffab8b0f4e4dc4e520b0f914397ece725a9f012657db7c671160fb7 DMG 서명자: Developer ID Application: Jeanhyuk Kwon (M2734R5BND) Team ID: M2734R5BND DMG 식별자: com.vica.camera.mac-companion [Blender 공식 다운로드·요구 사양] https://www.blender.org/download/ https://www.blender.org/download/requirements/ https://download.blender.org/release/Blender5.0/ [새로 설치할 때 사용할 Blender 5.0.1 Apple Silicon 파일] https://download.blender.org/release/Blender5.0/blender-5.0.1-macos-arm64.dmg 공식 체크섬 목록: https://download.blender.org/release/Blender5.0/blender-5.0.1.sha256 위 arm64 DMG SHA-256: 102a81ddee5346c96339c6a529069a2d52df05f330eb9bfd431c8dd79fb4afb6 설치 전 VICA 지원 페이지의 현재 안내도 읽으세요. 이 파일의 기준은 1.22.7입니다. 이미 더 최신 애드온이 정상 설치되어 있으면 임의로 1.22.7으로 내리지 마세요. 새 배포본이 안내되어 있다면 공식 페이지에 연결된 파일·버전·호환성·서명을 검증한 뒤 사용하세요. 위 체크섬은 지정된 버전 전용이며 다른 버전에 적용하지 마세요. 같은 버전의 파일이 체크섬과 다르면 실행하지 말고 재다운로드와 공식 안내를 확인하세요. 변경된 파일의 체크섬을 기존 기대값 대신 적어 넣고 통과시켜서는 안 됩니다. 4. Blender 설치 호환 Blender가 없는 경우에만 진행하세요. 공식 주소에서 DMG와 해당 체크섬 목록을 내려받아 정확한 파일 항목과 해시를 비교하세요. 실패한 HTTP 응답/HTML 페이지를 DMG로 취급하지 말고 다운로드가 완료됐는지 확인하세요. DMG를 읽기 전용으로 마운트하고 Blender.app을 로컬 Applications에 복사하세요. 기존 Blender.app과 충돌하면 기존 앱을 덮어쓰지 말고 다음과 같은 별도 경로를 쓰세요. ~/Applications/Blender-VICA-5.0.app 물결표(~)는 실제 실행 사용자의 홈 디렉터리로 해석하세요. 관리자 권한이 없는 경우에도 사용자 Applications 경로를 우선 활용하세요. 복사한 Blender.app의 macOS 코드 서명·Gatekeeper 평가와 실제 버전을 확인하세요. 첫 실행 시 보안 확인이 나오면 사용자에게 직접 승인할 위치와 이유를 안내하세요. DMG 안에서 계속 실행하지 말고 복사된 앱을 사용하세요. 복사가 끝나면 DMG를 꺼내세요. 보안 검증 실패 시 다운로드 출처·완전성·서명 상태를 확인하고 원인을 보고하세요. Gatekeeper 비활성화, 격리 속성 삭제(xattr 제거), 임의 재서명으로 우회하지 마세요. 고객 설치를 위해 Homebrew·Xcode·Command Line Tools·별도 Python을 설치할 필요는 없습니다. 5. VICA 패키지 다운로드·검증·보관 VICA DMG를 ~/Downloads에 내려받고 위 버전별 SHA-256을 확인하세요. macOS에 내장된 도구로 다음 항목을 검증하세요. 아래 는 실제 파일 경로로 바꾸고, 공백이 포함된 경로를 안전하게 처리하세요. /usr/bin/shasum -a 256 "" /usr/bin/codesign --verify --strict --verbose=2 "" /usr/bin/codesign -dv --verbose=4 "" /usr/sbin/spctl --assess --type open --context context:primary-signature --verbose=2 "" 기준 배포본은 위 Team ID의 유효한 Developer ID 서명, stapled 공증 티켓, Gatekeeper accepted / source=Notarized Developer ID가 확인되어 있습니다. 이번 Mac에서도 실제 결과를 확인하세요. 확인할 수 없으면 그 한계를 보고하세요. 공증 확인만을 위해 Xcode나 xcrun stapler를 추가 설치하지 마세요. DMG를 읽기 전용으로 열고 내부 VICA-Mac-1.22.7 폴더 전체를 다음과 같은 영구 로컬 경로에 복사하세요. 기존 동일 폴더가 있으면 검사 후 재사용하거나 별도 보관하세요. ~/Applications/VICA/VICA-Mac-1.22.7 복사된 폴더에 다음 파일·폴더가 있는지 확인하세요. VICA_Blender_Addon.zip START_처음_읽어주세요.html VICA_테스트_시작.command Demo/VICA_Test.blend Support/ LICENSES/ PACKAGE_MANIFEST.json ZIP 해시도 확인하고, 폴더 전체 복사가 완료되면 DMG를 꺼내세요. Support나 라이선스·소스를 임의로 삭제하지 마세요. 6. 애드온 영구 설치·활성화 이미 VICA가 설치되어 있다면 버전과 설치 위치를 확인하세요. 동일하거나 더 최신인 정상 버전은 불필요하게 교체하지 말고 아래 동작 확인을 하세요. 업데이트가 필요하면 서버/녹화가 정지한 상태에서 기존 virtual_camera 폴더와 Blender userpref.blend 환경설정을 타임스탬프가 있는 백업 위치에 보존하세요. 백업 애드온을 scripts/addons 안에 중복 등록되는 이름으로 두지 마세요. 선택한 Blender 5.0에서 다음 작업을 실제로 수행하세요. Edit(편집) → Preferences(환경설정) → Add-ons(애드온) 메뉴 → Install from Disk(디스크에서 설치) 영구 로컬 폴더의 VICA_Blender_Addon.zip 선택 → 설치 VICA 검색 → 활성화 체크 환경설정 저장 상태 확인 UI 도구가 없으면 실제 설치된 Blender의 Python API를 확인한 후, addon_install → addon_enable(module="virtual_camera") → save_userpref에 해당하는 작업을 수행할 수 있습니다. 실행 중인 Blender와 설정을 동시에 쓰지 마세요. 기존 사용자의 정상 환경설정을 불러온 세션에서 VICA 항목만 변경하세요. --factory-startup 세션에서 save_userpref()를 호출하면 기존 설정을 덮어쓸 수 있으므로 이 조합을 사용하지 마세요. bpy.ops.wm.save_homefile()도 호출하지 마세요. 일반적인 설치 위치는 다음과 같습니다. 실제 경로는 Blender에서 확인하세요. ~/Library/Application Support/Blender/5.0/scripts/addons/virtual_camera 다음 파일이 설치된 애드온 안에 있는지 확인하세요. virtual_camera/bin/VirtualCameraVideoEncoder 이 영상 처리 도구는 ZIP에 포함되어 있으며 애드온이 자동으로 찾습니다. 별도 helper 설치, PATH 수정, pip 설치, helper 경로 설정, Swift 빌드는 필요하지 않습니다. 필요하면 helper 서명과 실행 가능 여부를 확인하되 파일을 다른 것으로 교체하지 마세요. 1.22.7 helper SHA-256: 70c8dad95167bca63c35131b55459b08e9c7a7a34f26062a9d3f58e84144f0ff helper 식별자: com.vica.camera.video-encoder / Team ID: M2734R5BND 단독 helper에 대한 spctl --type execute 결과만으로 DMG 공증 실패라고 판단하지 마세요. 사용자 작업이 안전하게 보존된 뒤 Blender를 정상 종료하고 다시 실행하세요. 다시 실행해도 애드온이 활성화되어 있고 VICA 패널에 설치한 버전이 표시되어야 합니다. 업데이트 후에는 이전 코드가 메모리에 남은 상태로 테스트하지 마세요. 주의: VICA_테스트_시작.command는 영구 설치 도구가 아닙니다. 별도 기본 환경의 테스트 Blender를 여는 파일이므로 이것만 실행하고 설치 완료로 판정하지 마세요. 정식 설치와 재실행 확인이 먼저입니다. 7. 테스트 장면과 iPhone 연결 준비 기존 장면이 열려 있으면 원본을 바꾸지 마세요. 필요하면 동봉된 Demo/VICA_Test.blend를 별도 작업용 복사본으로 열어 확인하세요. 테스트 영상·테이크·Blender 복사본은 별도 테스트 폴더에 저장하고 원본 데모도 보존하세요. 현재 사용자의 녹화 폴더를 바꾸었다면 테스트 후 원래 설정으로 되돌리세요. 실제 창이 있는 Blender 3D Viewport에서 N 키 → VICA 탭을 여세요. 패널 버전이 맞는지 확인하고 서버 시작을 눌러 QR와 연결 대기 상태를 확인하세요. 백그라운드 import 성공만으로 GPU 프리뷰까지 정상이라고 판정하지 마세요. 기본 포트는 5050입니다. 이미 사용 중이면 어떤 프로세스/Blender 창이 소유하는지 확인하세요. 기존 VICA를 재사용하거나 정상 중지한 후 진행하세요. 다른 프로그램을 강제 종료하거나 임의로 여러 VICA 서버를 띄우지 마세요. 필요하면 사용하지 않는 포트로 설정하고 새 QR과 iPhone 주소도 일치시키세요. 라우터 포트 포워딩이나 인터넷 공개 서버 설정은 하지 마세요. QR 준비 후 사용자에게 다음 내용을 한 번에 안내하세요. ① iPhone을 Mac과 같은 Wi-Fi에 연결합니다. ② iPhone에서 VICA를 열고 감독(Director) 역할로 들어갑니다. ③ 설정 → QR로 연결에서 Mac에 표시된 QR을 스캔합니다. ④ 요청되면 로컬 네트워크 및 QR 촬영용 카메라 권한을 허용합니다. iPhone App Store: https://apps.apple.com/kr/app/vica/id6819004815 일반 고객은 App Store 버전을 사용하면 됩니다. TestFlight, Sandbox 계정, Apple Developer 등록은 요구하지 마세요. 앱 구매를 대신 확정하지 마세요. Mac 화면 녹화 권한은 VICA 프리뷰 연결을 위해 필요하지 않습니다. 수동 주소 입력이 필요하면 현재 Mac의 실제 로컬 네트워크 IP와 포트를 확인하세요. 0.0.0.0은 수신 주소이며 iPhone에서 연결할 주소가 아닙니다. 문서 작성자의 IP나 다른 네트워크 주소를 복사해서 쓰지 마세요. 연결 실패 시 IP·포트·서버 상태·iPhone 로컬 네트워크 권한을 순서대로 확인하세요. 같은 Wi-Fi 이름이어도 게스트 네트워크/기기 간 격리로 통신이 막힐 수 있습니다. 보안 설정 전체를 끄지 말고 필요한 앱의 로컬 통신 상태만 점검하세요. 8. 완료 확인과 사용자에게 남길 결과 최소 완료 기준(Mac 설치): □ 호환되는 Blender가 실제 실행됩니다. □ 애드온을 영구 설치하고 활성화했습니다. □ Blender 재실행 후에도 VICA 패널과 올바른 버전이 표시됩니다. □ 패키지/영상 처리 도구의 무결성과 서명을 확인했습니다. □ 서버 시작 후 QR와 연결 대기 상태가 표시됩니다. 사용자가 iPhone을 준비한 경우 추가 확인: □ iPhone 연결됨 상태와 실시간 영상이 확인됩니다. □ 조이스틱 또는 DOP 모드에서 재개 후 카메라가 움직입니다. □ 별도 테스트 장면에서 5초 이상 REC → 이동 → STOP이 정상입니다. □ 저장한 MP4가 열리고 영상이 재생됩니다. □ 촬영한 카메라 키프레임/테이크가 확인됩니다. 실제 확인한 항목만 완료로 표시하세요. iPhone이 없거나 사용자 조작을 기다리는 경우에는 “Mac 설치 완료 / iPhone 연결·촬영 확인 대기”로 구분하세요. QR를 아직 확인하지 못했다면 “파일 설치 완료 / 화면 확인 대기”로 보고하세요. 다른 컴퓨터에서의 성공 기록을 이번 컴퓨터의 테스트 결과처럼 쓰지 마세요. 최종 안내에는 Blender·VICA 버전, 설치 폴더, 완료 항목, 남은 사용자 동작만 간단히 적으세요. 가능한 도구로 설치 패키지 폴더를 Finder에 표시하세요. 문제가 생기면 실제 오류와 해당 단계, 수행한 조치를 남겨 이어서 해결할 수 있게 하세요. 로그에 계정·암호·QR 연결 토큰 등 민감한 내용을 노출하지 마세요. 공식 참고 자료 ──────────────────────────────────────── VICA 다운로드·설치: https://vica-camera-support.kwongang.chatgpt.site/support Blender 시스템 요구 사항: https://www.blender.org/download/requirements/ Blender 애드온 설치: https://docs.blender.org/manual/en/5.0/editors/preferences/addons.html Codex의 실행 환경·권한: https://learn.chatgpt.com/docs/sandboxing 이 파일은 설치를 수행할 Codex에 전달하는 작업 설명서입니다. 사용자의 실제 설치 요청과 허용된 도구 범위에서 적용하며, 운영체제 보안 승인이나 실제 iPhone 검증까지 자동으로 대신 완료되었다는 뜻은 아닙니다.