📱 ⇋ 💻

macmirror

아이폰·아이패드를 맥의 무선 보조 모니터로.
디스플레이 사이즈는 자유. 프리셋도 있고, 직접 픽셀로 잡아도 됩니다.

⬇ macmirror.dmg 다운로드 GitHub

macOS 14+ · 무료 · 오픈소스 · Apple 공증 완료  ·  아이폰 앱은 Xcode 로 직접 빌드

💻
macOS
가상 디스플레이 (자유 사이즈)
— HTTP /frame —→
📱
iPhone / iPad
풀스크린 렌더

프리셋 + 사용자 정의

흔한 아이폰·아이패드 비율은 프리셋으로 한 번에. 그 외엔 W×H 직접 입력해서 정확히 원하는 화면 만들 수 있습니다.

iPhone Pro Max
860 × 1556
iPhone Pro
786 × 1434
iPhone Mini
720 × 1290
iPad Pro 13"
2064 × 2588
iPad Pro 11"
1668 × 2270
iPad Air
1640 × 2270
iPad mini
1488 × 2142
Square 1:1
1200 × 1200
16:9
1080 × 1920
사용자 정의
W × H

모든 프리셋은 사파리 안전영역(Dynamic Island·홈 인디케이터·툴바) 제외한 실제 표시 가능 영역 기준. 메뉴바에서 방향(세로/가로)·HiDPI(Retina 렌더링) 토글로 즉시 변경.

이렇게 동작합니다

맥에 비공개 CGVirtualDisplay API 로 가상 디스플레이를 만들고, ScreenCaptureKit 으로 30fps JPEG 캡처. 아이폰은 HTTP 폴링으로 받아서 풀스크린 렌더.

📐

사이즈 자유

프리셋 한 번 탭 또는 W×H 직접 입력. 메뉴바에서 즉시 변경.

⚡️

30fps HTTP 폴링

WebSocket 의존 없음. 어떤 iOS 환경에서도 동작.

🌐

LAN + Cloudflare 터널

같은 WiFi 또는 외부망 양쪽 다. 메뉴바에서 주소 복사.

🎛️

메뉴바 앱

Dock 아이콘 없음. 항상 떠 있는 작은 메뉴.

🔓

오픈소스

MIT. Swift + SwiftUI 네이티브. 코드 100% 공개.

⌚️

워치 호환

같은 /frame 으로 워치 버전과 호환.

설치 — 맥

Apple 공증된 DMG. 받아서 드래그하면 끝. 빌드도, Gatekeeper 우회도 필요 없습니다.

1

DMG 다운로드 & 설치

macmirror.dmg 를 열어서 macmirror 를 Applications 폴더로 드래그.

2

더블클릭으로 실행

Apple 공증(notarized)된 앱이라 경고 없이 바로 열립니다. 메뉴바에 macmirror 아이콘 등장.

3

화면 기록 권한

메뉴바 아이콘 클릭 → 권한 요청 시 시스템 설정 → 개인정보 보호 및 보안 → 화면 기록 에서 macmirror 켜고, 한 번 종료 후 재실행.

설치 — 아이폰

iOS 앱은 App Store 미배포라 Xcode 로 직접 빌드합니다 (무료 Apple ID).

1

레포 클론 & 프로젝트 생성

git clone https://github.com/Gojaehyeon/macmirror.git
cd macmirror/ios
xcodegen generate
open MacMirror.xcodeproj
2

서명 & 실행

TARGETS → Signing 에서 본인 Apple ID 선택 → 폰 연결 → ⌘R.

3

주소 입력

앱 가운데 탭 → 맥 메뉴바의 "주소 복사" 한 LAN 주소 입력 → 연결.

# 예시
192.168.0.10:8890

한계 / 알아두실 점

  • 비공개 API: CGVirtualDisplay 는 비공개. macOS 메이저 업데이트로 깨질 수 있음.
  • System Settings UI: 너무 작은 가상 디스플레이는 macOS 26.5 의 디스플레이 설정 UI 에서 숨겨질 수 있음. 프리셋은 모두 노출되는 크기로.
  • 무료 Apple ID: 7일마다 재서명 필요.
  • 요구 사항: macOS 14+, iOS 17+, Apple Silicon 권장, Xcode 16+.
⌚️

워치 버전도 있습니다

같은 아키텍처로 애플워치를 맥 보조 모니터로 쓰는 watchmac.

watchmac.gojaehyun.com →