Pro
한국어
로그인계정 Mac용 다운로드
Mac용 다운로드

문서 / 시작하기

시작하기

내 Mac에서 돌아갈까요? 모든 Apple Silicon Mac의 메모리, 칩, 디스크, 렌더링 시간을 한 페이지에 모았어요.

Phosphene은 영상, 이미지, 노래, 사운드를 내 Mac에서 만들어요. 아무것도 업로드되지 않고, 아무것도 빌려 쓰지 않아요. 샷을 묘사하면 대기열에 들어가고, 완성된 파일은 갤러리에 저장돼요.

아직 설치하지 않았거나 디스크 공간이 부족한가요? 설치, 업데이트, 디스크 공간을 보세요.

탭

왼쪽 열 맨 위의 탭 줄에서 무엇을 만들지 골라요. ⇧1~⇧7으로 키보드에서 탭을 전환할 수 있어요.

탭용도
영상프롬프트로 클립을 만들어요. 이미지, 시작과 끝 프레임, 키프레임, 연장할 클립, 내 미디어(리믹스)로도 만들 수 있어요. 영상을 보세요.
One Shot컷 없이 이어지는 30초에서 2분 길이의 샷 하나. One Shot을 보세요.
이미지스틸 이미지: 참조 이미지를 편집하거나 Ideogram 4로 그림에 글자를 넣어요. 이미지를 보세요.
스토리보드아이디어 하나로 영화 전체를 기획하고, 모든 샷을 렌더링하고, 색을 맞추고, 컷으로 잘라요. 스토리보드를 보세요.
편집기타임라인: 트림하고, 나누고, 사운드를 옮기고, 타이틀과 음악을 넣고, 영화를 렌더링해요. 편집기를 보세요.
오디오작곡은 보컬이 있는 노래나 연주곡을 써요(뮤직 스튜디오). 뮤직비디오는 노래와 내 사진으로 영화를 기획해요. 립싱크는 사용 권한이 있는 오디오 트랙에 맞춰 오리지널 캐릭터를 움직여요(오디오).
캐릭터 학습이미지 15장에서 500장으로 나만의 오리지널 캐릭터와 스타일을 학습해요. 캐릭터 학습을 보세요.

엔진

헤더의 엔진 전환 스위치에서 어떤 모델로 렌더링할지 고르세요. LTX 또는 Hailuo H3예요. 둘은 강점이 서로 다른 별개의 엔진이고, 하나가 좋은 쪽이고 다른 하나가 예비인 관계가 아니에요.

  • LTX: 모든 영상 모드, LoRA, 학습한 캐릭터.
  • Hailuo H3: 영상, 대사, 사운드를 함께 만들어요. 텍스트, 이미지, 시작 & 끝 프레임, 키프레임, 연장, 사운드 추가, 립싱크를 지원해요. 약 75GB의 별도 설치이며 메모리 16GB가 필요해요. Hailuo H3를 보세요.

폼은 엔진에 따라 바뀌어요. 한 엔진이 쓰지 않는 컨트롤은 숨겨지고, 품질과 길이 칩에는 그 엔진 고유의 크기가 표시돼요. 이 Mac이 엔진을 둘 이상 실행할 수 있을 때만 스위치가 나타나요. 비교해 보기.

대기열

생성한 모든 것은 하나의 대기열에 들어가고 한 번에 작업 하나씩 렌더링돼요. 아래 패널에는 탭이 네 개 있어요.

  • 현재: 진행 중인 렌더링과 샷이 만들어지는 실시간 미리보기. 미리보기의 일찍 중지는 먼저 확인한 뒤 멈춰요. *“nothing is saved”*라고 알려 주고 대기열은 다음 작업으로 넘어가요.
  • 대기열: 기다리는 작업들. 카드의 ×를 누르면 제거돼요.
  • 최근: 끝난 작업을 전체 / 영상 / 사진 / 오디오로 거를 수 있어요.
  • 로그: 렌더링 로그. 로그 읽기를 보세요.

생성 버튼 아래에는 이런 버튼이 있어요. ⊞ 일괄 생성은 프롬프트를 한꺼번에 붙여 넣고 모두 대기열에 추가해요. 대기열 일시정지는 대기열을 멈춰요(그러면 버튼이 대기열 다시 시작으로 바뀌어요). 지우기는 기다리는 작업을 모두 제거해요. 실행 중인 작업은 계속돼요.

갤러리

오른쪽 갤러리에는 지금까지 만든 것이 보여요. 카드를 클릭하면 플레이어에 올라가요.

  • 전체 / 영상 / 사진 / 오디오로 거를 수 있고, 검색창에서는 프롬프트 단어, 모델, LoRA, 크기, 시드로 결과물을 찾아요(⌘F를 누르면 검색창으로 이동해요).
  • 모두 보기는 최신 60개보다 오래된 렌더링을 불러와요.
  • ← →로 갤러리를 넘기고, Space로 재생과 일시정지를 하고, F로 플레이어를 전체 화면으로 확대해요.
  • 플레이어 위의 동작 줄에서는 그 클립으로 다음에 할 수 있는 일을 고를 수 있어요. 연장하기, 업스케일 & 얼굴 보정 실행, 영화에 추가로 보내기, 스틸 이미지를 움직이기, 파라미터 보기가 있어요.
  • 사운드가 없는 클립은 갤러리 카드에 소리 없음 · 소리 추가 알약이 붙어요(플레이어에도 같은 표시가 나와요). 한 번 클릭하면 그 클립이 플레이어에 올라가고 Hailuo H3의 사운드 추가가 그 클립을 선택한 채로 열려요.
  • 공유(클립의 더 보기 메뉴와 전체 화면 뷰어에 있어요)는 Phosphene 링크가 들어간 한 줄짜리 캡션을 복사하고 Finder에서 파일을 보여 줘서 바로 첨부할 수 있어요. 아무것도 업로드되지 않아요.
  • 눈 아이콘은 클립을 갤러리에서 숨겨요(지금은 UI에서 다시 꺼낼 방법이 없어요. 수동으로 복원하는 방법은 영상을 보세요). 카드의 휴지통 버튼은 확인한 뒤 파일을 macOS 휴지통으로 옮겨요. 마음이 바뀌면 Finder에서 복원하세요. 선택한 결과물에서는 ⌘⌫가 같은 일을 해요.

파일이 저장되는 곳

Pinokio에서

항목위치
렌더링 결과Phosphene 설치 폴더 안의 mlx_outputs 폴더예요. 갤러리 헤더의 폴더 버튼을 누르면 Finder에서 열려요. Pinokio의 Outputs 항목도 이 폴더를 열어요.
학습한 캐릭터와 다운로드한 LoRAmlx_models/loras/
설정panel_settings.json

Mac 앱에서

항목위치
렌더링 결과~/Library/Application Support/Phosphene/outputs예요. 갤러리 헤더의 폴더 버튼이나 Studio → 갤러리 폴더 열기로 열 수 있어요
학습한 캐릭터와 다운로드한 LoRA~/Library/Application Support/Phosphene/models/loras/
설정~/Library/Application Support/Phosphene/state/panel_settings.json

렌더링마다 설정이 담긴 작은 사이드카 파일이 결과물 옆에 함께 저장돼요. 파라미터가 읽는 파일이고, 갤러리에서 LoRA나 시드로 검색할 수 있는 것도 이 파일 덕분이에요.

처음 시작할 때

Pinokio에서

런타임이 준비되면 시작이 나타나요. 앱이 열리기 전에는 어떤 모델도 다운로드하지 않아요. 설정에는 약 18GB의 여유 공간이 필요하고, 그중 15GB는 작업용으로 비워 둬요.

영상을 만들려면 영상 모델 다운로드를 클릭하세요. 기본은 LTX-2.5 Q4이고, 프롬프트 인코더를 포함해 약 27.5GB예요. 더 큰 Q8 팩 없이도 첫 텍스트 영상이나 이미지 영상을 만들 수 있어요. 두 부분이 차례로 다운로드되고 패널에 진행 상황이 표시돼요. 다운로드 중지를 누르면 받던 파일이 남고, 다운로드 버튼을 다시 누르면 이어서 받아요.

이미지나 오디오를 선택할 수도 있어요. 이 둘은 자기 모델을 따로 쓰고 영상 다운로드가 필요 없어요. 향상, 스토리보드 플래너, 선택 어댑터는 처음 쓸 때 다운로드를 안내해요. 앱을 열었다는 이유만으로 다른 것이 다운로드되지는 않아요.

Mac 앱에서

기본 세트는 약 28GB예요. LTX-2.5 엔진, 텍스트 인코더, 미리보기 디코더가 들어 있어요. 다운로드가 시작되기 전에 앱이 모든 항목과 크기, 필요한 공간, 남은 공간을 보여 줘요. 스튜디오는 들어가는데 모델이 안 들어간다면 스튜디오를 먼저 설정하고 나중에 안에서 모델을 받을 수 있어요.

설정에서는 모델을 둘 위치도 물어봐요. 이 Mac 또는 외장 드라이브예요. 모델을 외장 드라이브에 보관하기를 보세요.

앱의 모델 다운로드가 중단되면 스튜디오가 영상 모델을 직접 가져오고, 첫 클립은 내 Mac에 맞는 크기로 만들어져요. 설정이 끝나지 않았다면 스튜디오에 설정 마무리 버튼이 나타나요.

Gemma 3(향상과 스토리보드 플래너가 쓰는 모델)와 업스케일 & 얼굴 보정, 컨트롤, 재료, 컬러화용 어댑터는 기능이 처음 필요할 때 다운로드돼요. 기능이 그 사실을 알려 주고 지금 다운로드를 제안해요.

기존 설치를 업데이트할 때는 아무것도 다운로드하거나 삭제하지 않아요.

업데이트

Pinokio에서

  • 헤더의 버전 알약에서 현재 상태를 알 수 있어요. 최신 버전이거나 더 새로운 버전으로 업데이트하라고 나와요. 새 버전이 나오면 배너가 지금 업데이트 / 나중에를 제안해요.
  • Pinokio에서는 Phosphene 사이드바의 Update 항목이 Python 의존성까지 모든 것을 업데이트해요. 업데이트해도 대기열, 설정, 모델은 유지돼요. 업데이트가 중간에 멈추면 설치가 멈출 때를 보세요.
  • 앱 안에서 업데이트한 뒤 배너에 *“Updated to … restart to finish”*라고 나오면 Pinokio에서 Stop을 누른 다음 Start를 누르세요. 업데이트가 의존성에 영향을 줬다면 대신 Pinokio의 Update를 쓰라고 안내해요.
  • 아주 오래된 버전에서 시작한 업데이트가 패널만 움직이는 것처럼 보이면 Update를 한 번 더 누르세요. 오래된 버전은 업데이터부터 업데이트해요.
  • Pinokio의 Update가 시작하자마자 멈춘다면(4.19.6 이하에서 그럴 수 있어요) 대신 Phosphene 자체 배너나 버전 알약의 지금 업데이트를 쓰고 다시 시작하세요. 4.19.7부터는 Pinokio의 버튼이 다시 작동해요. 문제 해결을 보세요.

Mac 앱에서

  • 버전 알약에 내 버전과 커밋이 표시돼요. 클릭하면 버그 신고에 쓸 빌드 정보가 복사돼요.
  • 업데이트는 Phosphene → 업데이트 확인…에서만 가능해요. 대기열, 설정, 모델, 완성된 작업은 그대로 유지돼요.
  • 음악 엔진을 복구하려면 오디오 → 작곡을 열고 음악 엔진 복구를 클릭하세요. Hailuo H3를 다운로드하거나 마무리하려면 카드의 Download Hailuo H3나 다시 시작을 쓰세요(Hailuo H3 참고).

감사 카드

다섯 번째 렌더링이 끝난 뒤 30초 동안 Phosphene을 만지지 않으면, 모서리의 작은 카드가 GitHub 별표를 부탁해요. 클립을 가리는 일은 없고, 닫으면(× 또는 Escape) 다시는 나타나지 않아요.

  • 한 번에 GitHub 별표: 이 Mac이 gh 명령으로 GitHub에 로그인되어 있다면 GitHub에서 Star 누르기가 그 자리에서 Phosphene에 별표를 누르고 카드가 감사 인사를 해요. Phosphene은 클릭했을 때만 gh에 요청하고, GitHub 로그인 정보를 읽거나 저장하지 않아요.
  • 그렇지 않으면 버튼이 브라우저에서 Phosphene의 GitHub 페이지를 열어요.
  • 이미 별표를 눌렀다면(헤더의 별, 업데이트 배너, 또는 gh가 확인하는 GitHub 자체에서) 카드가 나타나지 않아요.

팁 어디서든 ?를 누르면 이 문서가 단축키 페이지로 열려요. 왼쪽의 검색창에 버튼에 적힌 단어를 입력하면 어떤 버튼이든 찾을 수 있어요.

출처: webapp/docs/getting-started.md (공개 저장소). 공개 전에 이 웹사이트용으로 검토했어요. 영어 원문에서 번역했어요. 수정 제안하기.