NanumOS

맥에서 앱으로 쓰기

나눔OS 를 맥의 앱 하나처럼 씁니다. 텔레비전 속 작은 화면처럼, 창 안에 컴퓨터 한 대가 통째로 돕니다. 지금 할 일: NanumOS.app 을 「응용 프로그램」으로 끌어 놓고 두 번 누르세요.

이 앱은

쓰는 법

키 나누기

키받는 쪽까닭
Command-Shift-3 / 4 / 5 (Control 을 더해도)맥맥 사람이 늘 쓰는 화면 찍기. 나눔OS 창도 함께 찍힙니다.
Option-Command-Q · Command-H맥 앱 메뉴끝내기(저장하고 끔) · 가리기
Command-Q나눔OS앞의 앱 닫기(동영상 플레이어도) — 맥 습관대로 눌러도 나눔OS 가 꺼지지 않음
Control-Command-F맥 앱 메뉴전체 화면
Command-Tab나눔OS나눔OS 의 앱 바꾸기(맥 키보드의 Command = 나눔OS 의 Super). 맥의 다른 앱으로 가려면 Command-H 나 다른 창을 누름.
Command-Space나눔OS짧게 = 나눔OS 찾기, 누르고 있기 = 비서
Command-Option-Esc나눔OS나눔OS 의 강제 종료 창
Control-화살표 · 그 밖의 키나눔OS낱말 건너뛰기 등 나눔OS 의 단축키

직접 해 보기: 나눔OS 창을 누른 뒤 Command-Shift-4 를 누르면 맥의 십자 표시가 나옵니다(나눔OS 에는 아무 키도 가지 않음). Control-Shift-4 를 누르면 나눔OS 안의 화면 찍기가 열립니다.

작동 원리

  1. 맥에 들어 있는 애플의 가상화 기능(Virtualization)이 가상 하드웨어를 만들고, 칩이 나눔OS 를 바로 실행합니다.
  2. 끌어 놓은 파일은 맥 쪽 앱이 밀어 넣습니다. 나눔OS 는 받기만 하고, 맥의 파일이나 앱을 거꾸로 부르지 못합니다 — 택배 기사가 문 앞에 두고 가는 것처럼, 집 안에서 밖의 창고를 열 수는 없습니다.
  3. 이름이 같은 파일이 있으면 덮어쓰지 않고 「이름 2」로 둡니다.
  4. 비서가 쪽을 읽을 때도 맥 앱이 정합니다. 나눔OS 는 「지금 쪽을 읽어 줘」 한 줄만 보낼 수 있고, 맥 앱이 허락 상태를 보고 제목·주소·글(16KB 까지)만 건넵니다. 쿠키·입력칸 값·다른 탭은 건네지 않습니다 — 창구 직원이 서류 사본 한 장만 내주는 것과 같습니다.
  5. 내 파일 칸은 저장을 두 벌(번갈아 쓰는 두 칸)로 합니다. 칸이 넓어지면 둘째 벌의 자리가 옮겨지므로, 맥 앱이 넓히기 전에 그 둘째 벌을 새 자리로 그대로 옮겨 적습니다. 그래서 어느 쪽이 새것이든 그대로 열립니다.
  1. 비서의 귀와 입도 맥 앱이 맡습니다. 나눔OS 는 「들어 줘」「이 문장 읽어 줘」「그만」 같은 글 한 줄만 보내고, 맥이 자기 안에서 (인터넷 없이) 들은 말을 글로 바꿔 돌려줍니다. 그래서 소리는 맥 밖으로 나가지 않습니다.

직접 해 보기: 맥의 사진 하나를 창 위로 끌어 놓고 나눔OS 의 파일 › 다운로드를 여세요. 맥 브라우저를 켰다면 비서에게 「맥 웹 창에 열린 쪽 요약해 줘」라고 해 보고, 웹 창 위의 주황 줄을 보세요.

기술 자세히

애플 Virtualization.framework(VZ): virtio-gpu 화면(창 크기 → 디스플레이 사건 → 다시 배치), USB 키보드·포인터, virtio-net NAT, virtio-blk 집 디스크, virtio-sound, SPICE 에이전트 클립보드, 이름 붙은 virtio-console 포트 kim.zeus.drop(맥 → 나눔OS 파일·명령, 나눔OS → 맥 한 줄 대답). M3 이후 + macOS 15 이상이면 중첩 가상화(EL2)가 켜지고 둘째 디스크 vmstore.raw(ZEUSOS-VMSTORE-v1, 16GiB 성긴 파일)가 붙습니다. 집 디스크 home.raw 는 4GiB 성긴 lab 디스크(저장 칸 둘 = (섹터 수 − 16384) / 2 씩). 비서 읽기: 손님 read → 맥 앱 page <바이트> + 「제목\n주소\n글」(WKWebView innerText), 거절은 page 0; appdo browser.host_browser_open·host_browser_read(needs_ok 0). 조작: 손님은 hgrant <출처> <일>·hlist·hclick N·hconfirm N·htype N 글·hfind 글·hdone 줄로 부탁만 하고 맥 앱이 대답(hres ok|no …)합니다. 허락 카드(host_browser_allow·host_browser_confirm_click, needs_ok 1)의 글은 코드가 맥 앱이 보낸 쪽의 출처(주소의 스킴·호스트·포트)로 만들며, 열린 쪽의 출처가 카드와 다르면 맥 앱이 거절합니다. 허락은 출처 하나에 묶이고 사이트가 바뀜·손님이 아닌 사람의 마우스/키/스크롤·멈춤 스위치·hdone·10분 동안 동작 없음 중 하나로 끝납니다. 기록 data/hostweb-actions.log 에는 동작·종류·결과만 남고 친 글·쪽의 글은 남지 않습니다. 맥 앱 저장 상태(keepstate)는 아직 선택 사항 — 되살린 뒤 이름 붙은 포트와 망이 조용함(MAC-APP.md). 목소리: 손님 vlisten 1 auto|hold|duplex ko|en·vlisten 0·vsay 문장·vstop·vvoice <목소리 이름>|mac → 맥 앱 vheard partial|end|final <ms> <글>·vsaid start <ms> <목소리>|end|stop, 켜짐 알림 cmd hostvoice 1|0. 맥은 SFSpeechRecognizer(requiresOnDeviceRecognition, ko-KR·en-US)로 듣고, 읽기는 앱 안 Contents/MacOS/nanum-speak(user/speak 를 맥용으로 빌드, --serve: 한 줄 문장 → 24 kHz 조각) + Resources/voices(민서 묶음)로 — 문장 조각이 마이크의 반향 제거 엔진으로 바로 들어가 끼어들기가 그대로 됩니다. AVSpeechSynthesizer 는 영어 문장·vvoice mac·목소리 묶음 없는 앱에서만. 목록 전체는 docs/contracts/VOICE.md 「Host voice」. 자세한 것은 개발 문서 docs/MAC-APP.md. 키: 보기(VZVirtualMachineView)는 시스템 키를 잡습니다(capturesSystemKeys) — Command-Tab·Command-Space 가 나눔OS 로 가게. Command 와 Shift 를 함께 누르고 Option 은 안 누른 동안만 잡기를 끄므로 맥의 화면 찍기 키는 맥으로 갑니다. 그래도 보기에 닿은 Command-Shift-3/4/5/6 은 나눔OS 에 건네지 않고 앱이 맥의 screencapture 로 같은 찍기를 합니다. 시험: tests/mac_app.py 12 (나눔OS 의 opt/zeusos/keytrace=on 기록으로 어느 키가 닿았는지 잼).

NanumOS 0.1.8349 · 2026-11-16