지원
연결을 도와드리겠습니다.
페어링, 디스플레이 문제, 제어, 원격 연결에 관한 도움말입니다.
시작하기
Mac 2.1 앱(macOS 14 이상)을 다운로드하고, App Store에서 iPhone 및 iPad용 MeowDisplay를 받으십시오(iOS 또는 iPadOS 16.4 이상). 설치, 권한, 첫 연결 방법은 설정 가이드에서 안내합니다.
수신 앱을 열어 두고 두 앱이 서로 호환되는지 확인하십시오. Mac과 iOS 2.1은 공개 릴리스이며, Android 2.0은 Google Play 비공개 테스트 중이고 Mac 2.0 이상과 함께 작동합니다.
Android 베타
Android 2.0 수신 앱은 Google Play 비공개 테스터에게 제공되며 Mac 2.0 이상과 함께 작동합니다. Mac 2.1에서는 Mac이 잠겨 있는 동안 Android 화면이 어두워지고, Mac 앞에서 잠금을 해제하면 다시 나타납니다. Android 얼리 액세스 프로그램에 참여하고, 같은 계정으로 Google Play에서 테스트에 참여한 다음, 비공개 베타를 설치하십시오. 실시간 세션에는 Mac 송신 앱이 필요하며, ‘Try the Demo’는 오프라인에서도 실행됩니다.
Android는 USB를 지원하지 않습니다. 로컬 Wi-Fi 또는 사설 네트워크(Tailscale 등)로 연결하십시오. 신뢰된 세션을 시작하려면 먼저 기기를 페어링해야 합니다. 버그를 신고할 때는 Android 버전, 휴대폰/태블릿 모델, 그리고 실제 기기와 에뮬레이터 중 어디에서 테스트했는지를 포함하십시오.
페어링
두 기기의 코드를 비교하고 일치할 때만 수락하십시오. 이전에 신뢰한 기기에 예기치 않게 ‘Pair’가 표시되면 먼저 두 앱을 다시 시작하십시오. 문제가 계속되면 해당 기기를 의도적으로 지우고 다시 페어링하십시오.
두 기기의 화면을 확인하지 않은 채 예상치 못한 페어링 요청을 절대 수락하지 마십시오.
macOS 15: 페어링을 승인한 직후 Mac 앱이 종료된다면 알려진 문제입니다(#219). MeowDisplay 2.1에는 제안된 수정 사항이 포함되어 있지만, 아직 macOS 15에서 검증되지 않았습니다. 직접 시도해 볼 수 있다면 확인한 내용을 이슈에 추가해 주십시오. Tailscale을 통한 연결 실패는 아직 조사 중입니다.
미러링 및 확장
검은 화면: Mac의 화면 및 시스템 오디오 녹음 권한을 확인하고, 스트림이 연결되어 있으며 일시 정지되지 않았는지 확인하십시오.
Mirror를 사용할 수 없는 경우: 활성화된 실제 디스플레이가 필요합니다. 활성화된 외장 디스플레이 없이 덮개를 닫은 노트북은 디스플레이를 제공하지 못할 수 있습니다. 대신 Extend를 선택하십시오. 자체 디스플레이를 만들므로 더미 어댑터가 필요 없습니다.
덮개를 닫으면 세션이 중단되는 경우: 클램셸로 사용할 때는 MacBook을 전원에 연결해 두고, iPhone이나 iPad에서 Extend를 사용하십시오.
Extend를 사용할 수 없는 경우: 비디오 캡처를 켜십시오. Displays를 열고 Extend를 선택한 다음, Arrange Displays…로 추가 화면의 위치를 확인하십시오.
오디오
세션이 연결되어 재생 중인지 확인한 다음, 수신 기기의 음량과 Mac의 오디오 출력을 확인하십시오. 오디오는 수신 기기에서 시작하며, 상태는 Mac의 Streaming 설정에 표시됩니다. 수신 기기에 실시간 세션이 아닌 이전 프레임이 표시되고 있다면 다시 연결하십시오.
입력 및 제스처
Mac에서 손쉬운 사용 권한을 허용하고, Allow Input을 켜고, 일시 정지된 스트림이 있으면 다시 시작하십시오. 탭과 드래그는 한 손가락, 스크롤은 두 손가락을 사용합니다. 세 손가락으로 탭하면 Spotlight가 열립니다.
그래도 입력이 되지 않으면 권한을 변경한 후 앱을 다시 여십시오. 또한 Natural Touch, Classic, Trackpad, Window view 중 무엇을 사용했는지 기록해 두십시오. 연결만으로는 절대 입력 권한이 주어지지 않습니다. 수신 앱에서 Request Control을 사용하십시오. 신고할 때는 해당 제스처나 키보드 동작, 그리고 Mirror, Extend, Window view 중 어느 모드였는지를 포함하십시오.
Window view 및 플로팅 윈도우
Float 옵션이 없는 경우: 플로팅 윈도우를 사용하려면 Mac과 iPhone 또는 iPad 모두에 MeowDisplay 2.1이 있어야 하고, Settings ▸ Controls ▸ Window Switcher에서 Enable Floating Windows가 켜져 있어야 합니다. Android나 Mac Receiver에서는 사용할 수 없습니다.
플로팅 윈도우가 사라진 경우: 화면 가장자리에 얇은 띠가 있는지 찾아 탭하십시오. 한 가장자리에 플로팅 윈도우가 많이 몰려 있으면 손잡이 하나를 함께 쓰며, 이 손잡이를 탭하면 해당 윈도우들의 메뉴가 나타납니다. 플로팅 윈도우를 지원하지 않는 Mac에 연결되어 있으면, 지원하는 Mac에 연결할 때까지 플로팅 윈도우는 가장자리로 밀어 넣은 상태로 유지됩니다.
플로팅 윈도우의 크기를 조절해도 Mac 윈도우가 바뀌지 않는 경우: 정상적인 동작입니다. 모서리 핸들은 기기에서 보이는 화면만 바꿉니다. 실제 윈도우 크기를 바꾸려면 Fill Window on Mac을 사용하십시오. Mac에 대한 제어 권한과 Mac의 MeowDisplay 2.1이 필요합니다. Restore Previous Size on Mac은 되돌아갈 크기가 생기면 나타납니다.
패널 안의 열기 또는 저장 대화상자가 반응하지 않는 경우: Mac에 MeowDisplay 2.1이 있으면 이 대화상자는 화면에 그려진 위치에서 탭을 받습니다. 대화상자의 버튼이 MeowDisplay 컨트롤에 가려져 있으면 Esc 키를 눌러 취소하거나 Return 키를 눌러 확인하십시오.
“No … Window to Show”: Mac에서 앱이 열려 있지만 윈도우가 없는 상태입니다. Show a Window on Mac을 선택해 Mac에서 해당 앱을 앞으로 가져와 윈도우를 열게 하거나, Choose a Window를 선택하십시오.
“This pane’s window was closed on the Mac.” Mac에서 이 패널의 윈도우가 닫힌 경우입니다. Choose Window를 선택해 해당 패널에 다른 윈도우를 표시하거나, Remove Pane을 선택하십시오.
패널에 Mission Control 때문에 일시 정지되었다고 표시되는 경우: Mac에서 Mission Control이 열려 있습니다. Exit Mission Control을 선택하거나 Mac에서 Esc 키를 누르십시오.
사용 방법: Window view 및 플로팅 윈도우.
키보드
입력한 내용이 Mac에 전달되지 않는 경우: 먼저 제어가 허용되어야 합니다. 수신 앱에서 Request Control을 사용하십시오. Window view에서는 입력하려는 윈도우를 먼저 터치해 맨 앞으로 가져오십시오.
Zoom While Typing이 예상한 위치를 확대하지 않는 경우: Mac이 보고하는 입력 위치를 따라가므로 일부 앱에서는 위치가 어긋날 수 있습니다. 키보드를 닫았다가 다시 열거나, 핀치로 보기를 조정하거나, Settings ▸ Input ▸ Keyboard에서 Zoom While Typing을 끄십시오.
화살표 키패드의 ⇧ ⌥ ⌘가 흐리게 표시되는 경우: Mac의 MeowDisplay가 이전 버전이면, Control Tray에 고정된 보조 키가 없을 때만 작동합니다. Control Tray의 보조 키 고정을 해제하거나 Mac의 MeowDisplay를 업데이트하십시오.
Mac이 잠겨 있을 때
Mac이 잠겨 있는 동안에는 일반 세션 콘텐츠가 표시되거나 전송되지 않으며, 기기에 Mac이 잠겨 있다고 표시됩니다. 권한이 있는 iPhone이나 iPad는 여전히 잠금 화면 보기를 요청할 수 있습니다. 잠금이 해제되면 레이아웃이 다시 나타납니다.
Show Lock Screen 버튼이 없는 경우: 해당 기기에 Mac 잠금 화면 사용이 허용되지 않은 것이며, 기기에 그 이유가 표시됩니다. Mac 앞에서 직접 잠금을 해제하십시오. 다음번에 사용하려면 Mac에서 해당 기기가 Always Allow Requests로 설정되어 있고, Allow Input이 켜져 있고, 해당 기기의 Allow Lock Screen Control이 켜져 있으며, 양쪽 모두 MeowDisplay 2.1이어야 합니다. Ask로 설정된 경우에는 Mac이 잠기기 전에 기기에 이미 제어 권한이 있었을 때만 작동합니다.
잠금 화면이 닫힌 경우: 잠금 화면 보기는 2분 동안 입력이 없거나, 연결이 끊기거나, Mac의 잠금이 해제되면 종료됩니다. Show Lock Screen을 다시 탭하십시오.
작동 방식: Mac 잠금 및 잠금 해제.
USB 및 로컬 네트워크
iPhone/iPad의 USB: 데이터 전송이 가능한 케이블과 다른 포트를 사용해 보십시오. 기기의 잠금을 해제하고 ‘이 컴퓨터를 신뢰하겠습니까?’에서 ‘신뢰’를 탭하십시오. Android USB 연결은 구현되어 있지 않습니다.
Wi-Fi: 두 기기 모두에서 로컬 네트워크 접근을 허용하고, 수신 앱을 열어 두고, 두 기기가 같은 네트워크에 있는지 확인하십시오. 게스트 네트워크 격리나 방화벽 규칙 때문에 검색이나 연결이 안 될 수 있습니다.
경로 레이블은 현재 사용 중인 경로(USB, LAN 또는 근거리 피어 투 피어 AWDL)를 나타냅니다. 문제를 신고할 때 함께 적어 주십시오.
새 기기를 승인한 직후 Mac 앱이 종료되는 경우: macOS 15에서 알려진 문제입니다(#219). MeowDisplay 2.1에는 원인 중 하나(연결에 QUIC을 사용하는 경우)에 대한 수정안이 포함되어 있습니다. 이 수정안은 아직 macOS 15에서 검증되지 않았습니다. 계속 발생하면 Mac의 로그를 이슈에 추가해 주십시오.
Remote Access 및 깨우기
사설 네트워크에서 두 기기가 모두 온라인으로 표시되는지, 저장된 원격 엔드포인트가 최신인지 확인하십시오. 접근 가능한 주소가 있어도 신뢰된 페어링을 대신하지는 않습니다.
Wake & Connect를 사용하려면 지원되는 하드웨어와 ‘네트워크 연결 시 깨우기’가 필요합니다. 로컬 Wake-on-LAN은 잠자기 상태라 연결할 수 없는 Mac의 자체 Tailscale 연결을 통과하지 못합니다. 원격으로 깨우려면 해당 Mac의 LAN에 별도의 기기나 라우터가 있어야 합니다.
콜드 부팅과 완전히 로그아웃된 Mac은 현재 지원되는 세션 사용 방식에 포함되지 않습니다. Remote Access 설정을 참고하십시오.
문제 신고
Mac에서는 Logs를 사용해 진단 파일을 표시하십시오. iOS에서는 Settings & Help → Connection log를 열거나 기기를 흔드십시오.
공유하기 전에 비공개 엔드포인트, 식별자, 기기 이름, 개인 콘텐츠를 제거하십시오. Android에서는 Settings & Help → Share Connection Log를 사용하십시오. 실제 기기 테스트와 자동/에뮬레이터 테스트를 구분해 주십시오.
- 앱 버전(다운로드, App Store, Google Play 비공개 테스트 또는 소스 빌드)과 macOS/iOS/Android 버전.
- Mac 및 수신 기기 모델, 모드, 활성 경로.
- 수행한 작업, 예상한 결과, 실제로 일어난 일.
- 재시작하거나 다시 연결하면 결과가 달라지는지 여부.
보안 문제 신고
보안 또는 개인정보 보호 취약점을 발견했나요? 공개 GitHub 이슈를 열지 말아 주십시오. 대신 MeowDisplay 저장소에서 GitHub의 비공개 Report a vulnerability 절차를 사용하십시오.
MeowDisplay 저장소의 Security 페이지를 열고 Report a vulnerability를 선택하십시오. 보낸 내용은 프로젝트 관리자만 볼 수 있습니다. 포함할 내용은 보안 정책에서 설명합니다.
문의처
MeowDisplay가 데이터를 저장하고 전송하는 방식은 개인정보 보호를 참고하십시오.