← 문서로 돌아가기

macOS 설치 가이드

이 가이드는 macOS 시스템에 Sokuji를 설치하는 방법을 안내합니다. Sokuji는 향상된 오디오 처리 기능을 위한 가상 오디오 드라이버가 포함된 서명되지 않은 .pkg 설치 프로그램으로 제공됩니다.

macOS용 다운로드

시스템 요구 사항

  • macOS 10.15 (Catalina) 이상
  • Apple Silicon (M1/M2/M3/M4) 또는 Intel (x86_64) 프로세서
  • 최소 4GB RAM (8GB 권장)
  • 200MB 사용 가능한 디스크 공간
  • 관리자 권한 (가상 오디오 드라이버 설치에 필요)
  • AI 번역 서비스를 위한 인터넷 연결
  • 마이크와 스피커/헤드폰

설치 단계

단계 1: Sokuji 다운로드

공식 GitHub 릴리스 페이지를 방문하여 macOS용 Sokuji 최신 버전을 다운로드하세요.

PKG 설치 프로그램 다운로드

  • Sokuji-x.x.x-arm64.pkg - Apple Silicon Mac (M1/M2/M3/M4) 용
  • Sokuji-x.x.x-x64.pkg - Intel Mac 용
  • 각 설치 프로그램에는 Sokuji 앱과 가상 오디오 드라이버가 포함되어 있습니다
  • 파일 크기는 약 150-200MB입니다

팁: 어떤 버전을 다운로드해야 할지 모르시겠나요? Apple 메뉴() → "이 Mac에 관하여"를 클릭하여 칩 유형을 확인하세요. "Apple M1/M2/M3/M4"가 표시되면 arm64 버전을, "Intel"이 표시되면 x64 버전을 선택하세요.

PKG 설치 프로그램은 서명되지 않았으므로 설치하려면 특별한 단계가 필요합니다(다음 단계에서 설명합니다).

단계 2: 설치 준비

PKG 설치 프로그램이 서명되지 않았기 때문에 macOS가 기본적으로 차단합니다. 설치하기 전에 격리 속성을 제거해야 합니다.

격리 속성 제거 (필수)

  1. 터미널을 엽니다 (응용 프로그램 → 유틸리티 → 터미널)
  2. 다음 명령을 입력하거나 붙여넣습니다 (x.x.x를 버전 번호로 교체하세요):

    sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg

    Intel Mac의 경우: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg

  3. Enter 키를 누르고 메시지가 표시되면 관리자 비밀번호를 입력합니다
  4. 명령이 조용히 완료됩니다 (출력이 없으면 성공을 의미합니다)

이것은 무엇을 하나요? 이 명령은 macOS가 다운로드한 파일에 추가하는 격리 플래그를 제거합니다. 서명되지 않은 PKG 설치 프로그램에 안전하고 필요합니다.

이 단계는 중요합니다! 격리 속성을 제거하지 않으면 PKG 설치 프로그램이 열리지 않거나 설치에 실패합니다.

단계 3: PKG 설치

이제 설치 프로그램을 준비했으므로 Sokuji와 가상 오디오 드라이버를 설치할 수 있습니다.

설치 과정

  1. 다운로드 폴더에서 다운로드한 .pkg 파일을 찾습니다 (예: Sokuji-x.x.x-arm64.pkg 또는 Sokuji-x.x.x-x64.pkg)
  2. PKG 파일을 더블 클릭하여 설치를 시작합니다
  3. macOS 설치 프로그램이 열립니다 - "계속"을 클릭하여 진행합니다
  4. 설치 세부 정보를 검토하고 "설치"를 클릭합니다
  5. 메시지가 표시되면 관리자 비밀번호를 입력합니다 (드라이버 설치에 필요)
  6. 설치가 완료될 때까지 기다립니다 (보통 1-2분)
  7. 설치가 완료되면 "닫기"를 클릭합니다

설치되는 항목

  • Sokuji.app - /Applications에 설치됩니다
  • SokujiVirtualAudio.driver - /Library/Audio/Plug-Ins/HAL에 설치되는 가상 오디오 드라이버
  • 설치 프로그램이 자동으로 CoreAudio를 재시작하여 드라이버를 로드합니다
설치 프로그램이 시스템 수준 오디오 드라이버를 설치해야 하므로 관리자 비밀번호가 필요합니다. 가상 오디오 드라이버는 고급 오디오 처리 기능을 활성화합니다.

단계 4: 첫 실행

설치 후 App Store 외부에서 다운로드되었기 때문에 Sokuji 실행 권한을 부여해야 할 수 있습니다.

처음으로 Sokuji 열기

  1. 응용 프로그램 폴더로 이동합니다
  2. 목록에서 Sokuji를 찾습니다
  3. Sokuji를 마우스 오른쪽 버튼으로 클릭(또는 Control 클릭)합니다
  4. 컨텍스트 메뉴에서 "열기"를 선택합니다
  5. 보안 대화 상자가 나타나면 "열기"를 클릭하여 확인합니다

참고: 단계 2를 올바르게 완료했다면 보안 경고가 표시되지 않을 수 있습니다.

대체 방법

macOS가 Sokuji를 차단하는 경우:
  1. 시스템 환경설정 → 보안 및 개인 정보 보호를 엽니다
  2. 일반 탭으로 이동합니다
  3. Sokuji가 차단되었다는 메시지가 표시됩니다
  4. "확인 없이 열기"를 클릭합니다
이 보안 경고는 첫 실행 시에만 나타납니다. 그 후에는 Launchpad 또는 응용 프로그램에서 정상적으로 Sokuji를 열 수 있습니다.

단계 5: Sokuji 구성

이제 Sokuji가 실행되고 있으므로 첫 사용을 위해 구성해 보겠습니다:

초기 설정

  1. macOS가 메시지를 표시할 때 마이크 권한을 부여합니다
  2. 선호하는 인터페이스 언어를 선택합니다
  3. AI 공급자(OpenAI, Google Gemini 등)를 선택합니다
  4. 선택한 공급자의 API 키를 입력합니다
  5. 번역을 위한 소스 언어와 대상 언어를 선택합니다
  6. 오디오 장치를 선택합니다 (목록에 "Sokuji Virtual Audio"가 표시되어야 합니다)
  7. 마이크와 스피커 설정을 테스트합니다
축하합니다! 이제 Sokuji를 사용할 준비가 되었습니다. 가상 오디오 드라이버가 설치되었으며 오디오 장치 목록에서 사용할 수 있습니다. 마이크 버튼을 클릭하여 실시간 번역을 시작하세요.

문제 해결

"패키지가 손상되어 열 수 없습니다" 또는 PKG가 설치되지 않음

PKG 파일에서 격리 속성이 제거되지 않은 경우 발생합니다:
  1. 터미널을 엽니다 (응용 프로그램 → 유틸리티 → 터미널)
  2. 실행: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. 메시지가 표시되면 비밀번호를 입력합니다
  4. PKG 설치를 다시 시도합니다
이것은 서명되지 않은 PKG 설치 프로그램에서 가장 일반적인 설치 문제입니다.

"Sokuji는 확인되지 않은 개발자가 배포했기 때문에 열 수 없습니다"

설치하기 전에 xattr 명령을 실행하지 않은 경우 발생합니다:
  1. 응용 프로그램에서 Sokuji 앱을 마우스 오른쪽 버튼으로 클릭합니다
  2. 메뉴에서 "열기"를 선택합니다
  3. 나타나는 대화 상자에서 "열기"를 클릭합니다
이 작업은 한 번만 수행하면 됩니다. 더 나은 방법: 격리 속성을 제거한 후 제거하고 다시 설치합니다.

마이크가 작동하지 않음

Sokuji가 마이크에 액세스할 수 없는 경우:
  1. 시스템 환경설정 → 보안 및 개인 정보 보호 → 개인 정보 보호를 엽니다
  2. 왼쪽 사이드바에서 마이크를 선택합니다
  3. 목록에서 Sokuji가 체크되어 있는지 확인합니다
  4. 목록에 없으면 Sokuji를 다시 시작하고 메시지가 표시되면 권한을 부여합니다

오디오 출력 없음

번역된 오디오가 들리지 않는 경우:
  1. 시스템 환경설정 → 사운드 → 출력을 엽니다
  2. 선호하는 출력 장치를 선택합니다
  3. 출력 볼륨이 음소거되지 않았는지 확인합니다
  4. Sokuji에서 올바른 출력 장치가 선택되었는지 확인합니다

Intel Mac에서 앱 충돌 또는 성능 문제

Mac에 맞는 올바른 설치 프로그램을 다운로드했는지 확인하세요:
  • Apple Silicon (M1/M2/M3/M4): Sokuji-x.x.x-arm64.pkg 사용
  • Intel: Sokuji-x.x.x-x64.pkg 사용
  • 칩 유형 확인: Apple 메뉴() → "이 Mac에 관하여"
  • 잘못된 설치 프로그램을 사용한 경우 릴리스 페이지에서 올바른 버전을 다운로드하세요
  • 올바른 설치 프로그램으로도 충돌이 계속되면 콘솔.app에서 충돌 로그를 확인하고 GitHub에 보고하세요

가상 오디오 드라이버가 표시되지 않음

오디오 장치에 "Sokuji Virtual Audio"가 표시되지 않는 경우:
  1. 드라이버가 설치되었는지 확인합니다: ls /Library/Audio/Plug-Ins/HAL/
  2. 존재하지 않으면 Sokuji를 다시 설치해야 할 수 있습니다
  3. 존재하는 경우 CoreAudio를 재시작해 보세요: sudo killall coreaudiod
  4. 시스템 환경설정 → 사운드에서 장치가 나타나는지 확인합니다

설치에 관리자 비밀번호가 필요함

이것은 정상이고 필요합니다:
  • PKG 설치 프로그램은 시스템 수준 오디오 드라이버를 설치해야 합니다
  • 시스템 오디오 드라이버를 설치하려면 관리자 권한이 필요합니다
  • 메시지가 표시되면 비밀번호를 입력하세요 - 이것은 안전하고 예상되는 동작입니다
  • 관리자 액세스 권한이 없으면 시스템 관리자에게 문의하세요