터미널을 엽니다. ⌘ Command + Space 를 눌러 터미널 이라고 입력하고 Enter.
(또는 Finder → 응용 프로그램 → 유틸리티 → 터미널)
터미널 창에 ⌘ Command + V 로 붙여 넣고 Enter 를 누릅니다.
설치가 진행됩니다. 창을 닫지 말고 기다려 주세요. 처음에는 5~10분 걸립니다. 프로그램 실행에 필요한 파이썬과 구성 요소를 함께 받습니다. Mac 시스템은 건드리지 않습니다.
「설치 완료」 가 나오면 프로그램이 자동으로 열립니다. 다음부터는 바탕화면의 「월천 AI 스튜디오」 를 더블클릭해 실행합니다.
로그인 후, 사이드바 「🔑 API 키 관리」 에서 필수 API 키를 등록합니다.
키 등록을 마치면 가입 메일로 인증코드가 옵니다. 사이드바 「✉️ 무료 체험 시작」 에 6자리 코드를 넣으면 7일 무료 체험이 시작됩니다. 챌린지 참가자는 키 등록 뒤 사이드바 「🎟 챌린지 참가자 전용 코드」 에 안내받은 코드를 넣어 주세요.
윈도우에서 이미 쓰시던 분은 6~7번이 필요 없습니다. 같은 아이디로 로그인만 하시면 등록해 두신 API 키와 이용 기간이 그대로 적용됩니다.
· 같은 아이디는 한 번에 한 PC에서만 쓸 수 있습니다. Mac 에서 로그인하면 윈도우 쪽은 몇 분 안에 로그아웃됩니다.
🆕 처음 실행할 때
· 작업 폴더를 정하라는 화면이 나오면 「내 문서」를 고르시면 됩니다. 대본·이미지·음성이 여기에 저장됩니다. 윈도우에서 만든 프로젝트는 Mac 으로 자동으로 넘어오지 않습니다. 필요하면 작업 폴더를 통째로 복사해 오세요.
· "터미널이 문서 폴더에 접근하려고 합니다" 같은 창이 뜨면 [허용] 을 눌러 주세요. 허용하지 않으면 저장이 되지 않습니다.
🧩 크롬 확장(월천 자동) 설치 — 처음 한 번
장면 이미지·캐릭터·썸네일을 Flow 에서 자동으로 만들어 주는 확장입니다. 확장은 프로그램과 함께 설치되어 있고, 크롬에 한 번만 등록하면 됩니다.
확장 폴더: ~/WolcheonStudio/app/wolcheon_auto(홈 폴더 → WolcheonStudio → app → wolcheon_auto — 홈 폴더는 Finder 에 기본으로 안 보여서, 아래처럼 경로를 넣는 방법이 쉽습니다)
크롬 주소창에 chrome://extensions 를 넣고 Enter.
오른쪽 위 「개발자 모드」 스위치를 켭니다.
왼쪽 위 「압축해제된 확장 프로그램 로드」 를 누릅니다.
폴더 고르는 창이 뜨면 키보드로 ⌘ Command + Shift + G 를 누르고,
나온 칸에 ~/WolcheonStudio/app/wolcheon_auto 를 붙여 넣고 Enter → 「선택」.
목록에 「Wolcheon Media Auto」 가 생기면 끝입니다. 크롬 오른쪽 위 퍼즐 모양 → 핀(📌)으로 고정해 두세요.
프로그램 안 이미지·썸네일 화면의 「❓ 크롬 확장 설치 방법」 버튼에도 같은 순서가 그림과 함께 있습니다. 폴더를 Finder 로 보고 싶으면 터미널에 open ~/WolcheonStudio/app/wolcheon_auto 를 넣으세요.
🌐 기본 브라우저를 크롬으로
프로그램은 Mac의 기본 브라우저에서 열리고, 장면 이미지를 만드는 확장도 크롬에서만 동작합니다. 사파리가 기본이면 바꿔 주세요.
· 크롬 설치: google.com/chrome
· 바꾸는 법: 시스템 설정 → 데스크탑 및 Dock → 기본 웹 브라우저 → Google Chrome macOS 12(몬터레이)는 시스템 환경설정 → 일반 → 기본 웹 브라우저
🖤 실행 중 뜨는 "터미널 창"은?
터미널 창은 프로그램 본체입니다. 사용 중에는 닫지 마세요 — 닫으면 프로그램이 종료됩니다.
· 거슬리면 ⌘ Command + M 으로 Dock 에 내려 두세요.
· 프로그램을 끄고 싶을 때는 이 터미널 창을 닫으면 됩니다. "프로세스를 종료할까요?" 가 나오면 [종료].
🔄 업데이트
자동입니다. 바탕화면 아이콘으로 실행할 때 새 버전이 있으면 알아서 받아 바꿉니다.
프로그램 안에서 새 버전 안내가 뜨면 「⚡ 지금 업데이트」 를 누르셔도 됩니다. 만들어 두신 대본·이미지·프로젝트는 그대로 남습니다.
❓ 이럴 때는
· "Apple 칩 Mac만 지원합니다" — 인텔 Mac은 아직 지원하지 않습니다.
메뉴 → 이 Mac에 관하여 에서 칩이 Apple M… 인지 확인해 주세요.
· "macOS 12 이상이 필요합니다" — 시스템 설정 → 일반 → 소프트웨어 업데이트 후 다시 설치해 주세요.
· 설치가 중간에 멈추거나 실패 — 인터넷 연결을 확인하고 같은 명령을 다시 붙여 넣으면 이어서 설치됩니다. 여러 번 해도 안전합니다.
· 바탕화면 아이콘이 없어짐 — 같은 명령을 다시 실행하면 새로 만들어집니다.
· 지우고 싶을 때 — 홈 폴더의 WolcheonStudio 폴더와 바탕화면 아이콘을 휴지통에 넣으면 끝입니다.
작업 폴더(대본·이미지)는 따로 있어 함께 지워지지 않습니다.
🖥️ 권장 사양
· Apple 칩(M1 이후) Mac · macOS 12 이상
· 메모리 8GB 이상 권장
· 저장공간 3GB 이상 여유
· 인터넷 연결 필요 (설치·로그인·생성 기능)