맥에서 앱으로 쓰기
나눔OS 를 맥의 앱 하나처럼 씁니다. 텔레비전 속 작은 화면처럼, 창 안에 컴퓨터 한 대가 통째로 돕니다. 지금 할 일: NanumOS.app 을 「응용 프로그램」으로 끌어 놓고 두 번 누르세요.
이 앱은
- 창 크기를 바꾸면 나눔OS 화면도 그 크기로 바뀝니다. 전체 화면은 Control-Command-F.
- 맥의 파일을 창 위로 끌어 놓으면 나눔OS 의 「다운로드」 폴더로 복사됩니다(메뉴 기계 › 나눔OS 로 파일 보내기 도 같음).
- 맥에서 가져오기: 동영상 편집·포토리터치처럼 파일을 받는 앱 위에 맥 바탕화면의 파일을 끌어 놓으면 그 앱이 바로 열고, 받지 않는 곳에 놓으면 「다운로드」로 들어가고 알림이 뜹니다. 앱의 「가져오기…」 화면에서 「맥에서 가져오기…」를 누르면 맥의 파일 창이 열리고(그 앱이 다루는 종류만 보임), 고른 파일만 복사되어 그 앱에서 열립니다. 나눔OS 가 맥의 폴더를 스스로 들여다보거나 연결해 두지 않습니다. 고르거나 끌어 놓은 파일만 갑니다. 「사진」 앱·메일·사파리에서 끌어온 사진과 첨부도 받고(이런 앱은 파일 대신 「파일 약속」을 넘깁니다 — 놓는 순간 그 앱이 파일을 만들어 줍니다), 폴더는 안의 폴더까지 통째로, 여러 개는 한 번에 모두 들어옵니다.
- 맥으로 보내기: 파일 앱에서 파일이나 폴더를 고르고 파일 › 「맥으로 보내기…」(Shift+Ctrl+E)를 누르면 맥의 저장 창이 뜹니다. 저장할 곳과 이름은 맥 창에서 내가 고릅니다(여러 개면 폴더를 고름). 메모장 같은 앱의 「다른 이름으로 저장」 창에는 「맥에 저장…」이 있어 나눔OS 에 저장한 뒤 같은 파일을 맥의 저장 창으로 넘기고, 포토리터치의 「내보내기 형식」·비디오리터치의 내보내기 완료 줄에도 「맥에 저장…」이 있습니다.
- 끌어서 내보내기: 파일 앱이나 바탕화면의 항목을 끌어 창 밖(맥 바탕화면·Finder)으로 가져가 놓으면 그 자리에 복사됩니다. 맥이 「여기 놓였다」고 할 때에만 나눔OS 가 그 파일을 보냅니다. 나눔OS 안의 원본은 그대로 있습니다.
- 글자 복사·붙여넣기는 맥과 나눔OS 사이에 양쪽으로 됩니다. 소리는 맥 스피커로 나옵니다.
- 메뉴 나눔OS › 나눔OS 끝내기(Option-Command-Q)나 기계 › 끄기를 누르면 나눔OS 가 파일을 저장하고 깨끗하게 꺼집니다. 빨간 단추는 나눔OS 앞에 앱(동영상 플레이어 포함)이 떠 있으면 그 앱을 닫습니다. 바탕 화면만 있을 때 누르면 창만 사라지고 나눔OS 는 계속 돕니다(소리·라디오도) — Dock 아이콘이나 윈도우 › 나눔OS(Command-0)로 그대로 다시 봅니다. Command-Q 는 나눔OS 의 것입니다(앞의 앱을 닫음).
- 키는 어디로 가나: 창이 앞에 있으면 키는 나눔OS 가 받습니다. 다만 맥 화면 찍기(Command-Shift-3 전체 · Command-Shift-4 고른 곳 · Command-Shift-5 찍기 막대, Control 을 더하면 클립보드로)는 늘 맥이 받습니다 — 방 안에 있어도 집의 초인종은 집이 듣는 것과 같습니다. 나눔OS 안의 화면 찍기는 Control-Shift-3/4/5 와 Command-Shift-S 입니다.
쓰는 법
- 메뉴 기계: 켜기 · 끄기 · 다시 시작 · 나눔OS 로 파일 보내기 · 금고 가져오기(잠긴 .kdbx 파일만 넘김, 금고 장 참고) · 메모리와 프로세서(다음에 켤 때 바뀜) · 맥 브라우저 쓰기 · 맥 브라우저의 비서 · 나눔OS 에 내줄 장치 · 맥으로 듣고 읽기.
- 내 파일 칸은 4GB 입니다. 맥 디스크는 실제로 쓴 만큼만 차지합니다(빈 칸은 자리를 먹지 않음). 예전 판의 64MB 칸은 처음 켤 때 저절로 넓혀지고, 파일은 그대로입니다(옛 칸은 「home-64MiB-before-grow.raw」로 한 번 남겨 둡니다).
- 끌어 놓는 파일은 하나에 256MB 까지 됩니다. 더 큰 파일은 보내지 않고 창 위쪽 줄에 그렇게 알려 줍니다. 나눔OS 의 이름은 31바이트(한글 약 10자)까지라 더 긴 이름은 줄여서 받고, 그것도 알려 줍니다.
- M3 이후 맥에서는 나눔OS 안에서 가상 머신을 돌릴 자리(16GB, 역시 쓴 만큼만)가 함께 생깁니다. 브라우저 가상 머신 틀은 아직 들어 있지 않아서, 그동안 브라우저는 Z브라우저로 열리고 그 까닭을 한 번 알려 줍니다.
- 내 파일은 맥의 한 곳(Application Support › NanumOS)에 모여 있습니다. 메뉴 나눔OS › 내 파일 보기.
- 맥 브라우저 쓰기(선택, 기본 꺼짐): 켜면 나눔OS 의 브라우저가 나눔OS 위에 열립니다. 제목줄·옮기기·크기·닫기는 다른 나눔OS 창과 같고, 쪽 자체는 맥 앱이 그 창 몸통 위에 얹어 보여 줍니다. 쪽에 포커스가 있는 동안 Cmd-Tab·Cmd-Space 는 맥으로 가며, 나눔OS 제목줄을 누르면 다시 나눔OS 로 돌아옵니다. 다녀간 쪽·기록·로그인은 나눔OS 안이 아니라 이 맥에 남습니다.
- 맥 브라우저의 비서: 맥 브라우저 쓰기를 켜면 비서가 그 웹 창에 쪽을 열고, 열린 쪽의 제목·주소·글을 읽을 수 있습니다 (허락 카드 없이 — 보기·읽기는 되돌릴 수 있는 일이라서). 읽는 동안 웹 창 위에 주황색으로 「비서가 이 페이지를 읽는 중」이 보입니다. 누르기·글 치기는 허락 카드 「<사이트> 에서 <일> 동안 조작 허락?」을 눌러야 그 사이트에서 이번 일 동안만 됩니다(사이트가 바뀌거나 웹 창에 손을 대면 바로 끝나고, 웹 창 위에 빨간색으로 「비서가 이 페이지를 조작 중」이 보입니다). 비밀번호·카드 칸은 비서가 채우지 않고 직접 채우셔야 하며, 보내기·결제·글 올리기 단추는 누를 때마다 따로 허락을 받습니다. 메뉴 기계 › 맥 브라우저의 비서… 에서 「멈추기」를 누르면 비서의 열기·읽기를 한꺼번에 거절합니다. 나눔OS 의 설정 › 공유 에는 이 상태가 보이기만 합니다(바꾸는 곳은 맥 앱).
- 맥으로 듣고 읽기(기본 켜짐): 비서에게 말하면 말은 이 맥 안에서만 글로 바뀝니다. 답은 맥이 나눔 목소리 「민서」로 읽어 줍니다 — 나눔OS 안의 읽기 프로그램(
speak)과 같은 프로그램·같은 목소리 파일을 맥이 직접 돌리는 것이라, 나눔OS 안에서 듣던 민서와 똑같은 소리가 납니다(첫 소리 약 0.3~0.6초). 목소리는 나눔OS 의 설정 › 앱 › 비서 「목소리」에서 고릅니다(민서·준호·수아·지훈, 민서는 밝게·놀람·걱정·언짢음도). 맥 기본 목소리는 「맥 기본 목소리로 읽기」를 켤 때만 읽고, 영어 문장은 아직 늘 맥 목소리로 읽습니다 (나눔 목소리에 영어 목소리가 아직 없어서). 목소리 파일이 없는 앱(공개판 등)이면 맥 목소리가 읽습니다. 소리는 나눔OS 로도, 어느 서버로도 가지 않고, 나눔OS 에는 글 한 줄만 건너갑니다 — 통역사가 옆에서 듣고 쪽지만 건네주는 것과 같습니다. 처음 말하기 단추를 누를 때 맥이 마이크와 받아쓰기를 써도 되는지 한 번 묻습니다. 비서가 읽는 중에 말을 시작하면 0.3초 안에 읽기가 잠깐 멈추고, 말이 이어지면 읽기를 끝내고 그 말을 다음 질문으로 받습니다. 「네」「응」처럼 짧은 맞장구나 기침이면 멈춘 자리에서 이어 읽습니다(길이만 보고 정하고, 말의 뜻으로 가르지 않습니다). 맥 스피커에서 나온 비서 자기 목소리는 마이크의 반향 제거가 빼고, 남은 소리는 맥이 방금 낸 소리 크기와 견줘 거르므로 제 목소리에 멈추지 않습니다. 말을 마치면 약 0.55초 조용할 때 끝난 것으로 보고 바로 답을 구합니다. 메뉴 기계 › 맥으로 듣고 읽기 를 끄면 예전처럼 나눔OS 가 직접 듣고(음성 서버) 읽습니다. 나눔OS 의 설정 › 공유 에는 이 상태가 보이기만 합니다. 지금 할 일: 비서 단추(또는 Command-J)를 누르고 「메모장 열어 줘」라고 말해 보세요. - 나눔OS 에 내줄 장치(기본 켜짐): 나눔OS 는 무거운 일(그래픽 칩으로 그리기·계산, 동영상 풀기)을 맥 앱에 부탁할 수 있습니다. 부탁은 맥 앱과 나눔OS 사이 전용 통로(vsock — 망을 거치지 않는 가상 장치 하나) 하나로만 오가고, 맥 앱이 정한 「창구」(포트 번호마다 서비스 하나)만 답합니다. 창구마다 한도(동시 연결 수·주고받는 양·말 없는 시간)가 있어 넘으면 그 연결을 닫습니다. 맥의 파일·앱은 이 길로 보이지 않습니다. 메뉴 기계 › 나눔OS 에 내줄 장치… 에서 끄면 새 부탁은 모두 거절되고 열린 연결도 바로 끝나며, 나눔OS 는 그 일을 제 프로세서로 합니다. 직접 해 보기: 나눔OS 터미널에서
vsock echo— 맥 앱의 메아리 창구가 64KB 를 그대로 돌려주면VSOCK echo ok가 보입니다. - 나눔OS 에서 열 수 있는 맥 앱(처음엔 비어 있음): 메뉴 기계 › 나눔OS 에서 열 수 있는 맥 앱… 에서 내가 채우는 목록입니다(예: 카카오톡). 나눔OS 의 「맥 앱」 창(또는 허락 카드 없이 비서)이 그 앱을 열어 달라 하거나 앞으로 가져와 달라 하면, 맥 앱이 번들 이름표가 내 목록에 있고 은행·금융 앱이 아닌지 확인하고 이 맥의 기록에 남긴 뒤에야 macOS 에 부탁하며, 나눔OS 에 「맥에서 카카오톡을 열었어요」가 뜹니다. 은행·금융 앱(알려진 한국 은행·증권 앱 목록, 이름에 은행이 든 이름표, 금융 분류를 밝힌 앱)은 열리지도 더해지지도 않습니다 — 맥에서 직접 열어 주세요. 그 앱의 창이나 자료는 나눔OS 로 가지 않습니다.
키 나누기
| 키 | 받는 쪽 | 까닭 |
|---|---|---|
| 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 안의 화면 찍기가 열립니다.
작동 원리
- 맥에 들어 있는 애플의 가상화 기능(Virtualization)이 가상 하드웨어를 만들고, 칩이 나눔OS 를 바로 실행합니다.
- 끌어 놓은 파일은 맥 쪽 앱이 밀어 넣습니다. 나눔OS 는 받기만 하고, 맥의 파일이나 앱을 거꾸로 부르지 못합니다 — 택배 기사가 문 앞에 두고 가는 것처럼, 집 안에서 밖의 창고를 열 수는 없습니다.
- 이름이 같은 파일이 있으면 덮어쓰지 않고 「이름 2」로 둡니다.
- 비서가 쪽을 읽을 때도 맥 앱이 정합니다. 나눔OS 는 「지금 쪽을 읽어 줘」 한 줄만 보낼 수 있고, 맥 앱이 허락 상태를 보고 제목·주소·글(16KB 까지)만 건넵니다. 쿠키·입력칸 값·다른 탭은 건네지 않습니다 — 창구 직원이 서류 사본 한 장만 내주는 것과 같습니다.
- 내 파일 칸은 저장을 두 벌(번갈아 쓰는 두 칸)로 합니다. 칸이 넓어지면 둘째 벌의 자리가 옮겨지므로, 맥 앱이 넓히기 전에 그 둘째 벌을 새 자리로 그대로 옮겨 적습니다. 그래서 어느 쪽이 새것이든 그대로 열립니다.
- 비서의 귀와 입도 맥 앱이 맡습니다. 나눔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