시작하기

macOS에 설치

파일을 다운로드해서 앱이 컴퓨터 소리를 듣기까지 몇 분이면 충분합니다. 앱은 서명 및 공증을 마쳤기 때문에 macOS에서 보안 경고 없이 열립니다.

출시 예정

MiuWave는 아직 출시되지 않았습니다. 아래 단계는 출시 예정인 설치 파일을 기준으로 설명합니다.

요구 사항

macOS 13 이상, Apple Silicon 또는 Intel. Local MLX 엔진은 Apple Silicon(M1 이상)과 약 5 GB의 디스크 공간이 필요합니다.
사용 가능한 엔진이 하나 이상 있어야 합니다. 가장 일반적인 것은 Soniox입니다(API 키 필요, 시간당 ~$0.12). 키 없이 쓰고 싶다면 Local MLX(Apple Silicon) 또는 SenseVoice(모든 Mac, 약 163 MB 모델 1회 다운로드)를 선택하세요. 엔진 선택을 참고하세요.

설치 단계

.dmg 파일 다운로드 릴리스 페이지에서 Apple Silicon(M1/M2/M3/M4)은 MiuWave_<ver>_aarch64.dmg, Intel Mac은 MiuWave_<ver>_x64.dmg를 선택합니다.
응용 프로그램으로 드래그 .dmg 파일을 열고 MiuWave를 응용 프로그램 폴더로 드래그한 다음 DMG를 꺼냅니다.
처음으로 앱 열기 응용 프로그램에서 MiuWave를 엽니다. 처음 실행하면 번역 모드를 고르라는 화면이 나오고, 이어서 짧은 앱 내 둘러보기가 주요 버튼을 안내합니다.
macOS 권한 허용 아래 필요한 권한의 항목을 켭니다. 시스템 오디오를 들으려면 화면 녹음 권한이 반드시 필요합니다.
API 키 입력 후 시작 Cài đặt(설정, ⌘ ,) → Engine dịch(번역 엔진)을 열고 키를 붙여 넣은 뒤 Test를 클릭합니다. API 키 발급을 참고한 다음 빠른 시작을 따라 하세요.

필요한 권한

macOS 권한	용도	필요한 경우
화면 및 시스템 오디오 녹음	시스템 오디오(YouTube, Zoom, 팟캐스트…) 캡처 및 화면 캡처 번역(`F3`)	Hệ thống(시스템) 또는 Cả hai(둘 다) 소스를 들을 때 필수
마이크	마이크로 들어오는 음성 듣기	Mic 또는 Cả hai(둘 다) 소스를 선택할 때
손쉬운 사용	Quick Translate(`F2`)가 선택한 텍스트를 복사	선택한 텍스트에 Quick Translate를 쓸 때만

화면 및 시스템 오디오 녹음

macOS가 물으면 시스템 설정 열기를 클릭합니다.
목록에서 MiuWave를 찾아 스위치를 켭니다.
macOS가 종료 후 다시 열기를 요청하면 클릭해 앱을 다시 엽니다.

권한을 허용하기 전에 F3를 쓰면 macOS가 처음 한 번 묻고, 앱에 “Cần quyền Ghi màn hình…”(화면 녹음 권한이 필요합니다) 메시지와 Mở cài đặt(설정 열기) 버튼이 표시됩니다. MiuWave를 켠 다음 앱을 다시 여세요.

마이크

Mic 또는 Cả hai(둘 다) 소스로 듣기 시작하면 macOS가 마이크 접근을 요청합니다. 허용을 선택하세요. Mac mini에는 내장 마이크가 없으므로 외장 마이크(USB, 헤드셋, AirPods)를 연결하세요.

Quick Translate를 위한 손쉬운 사용 권한

Quick Translate는 맨 앞에 있는 앱에 복사 단축키를 보내 선택한 텍스트를 복사하므로 손쉬운 사용 권한이 필요합니다. 권한이 없으면 Quick Translate 창에 “Cho phép MiuWave sao chép chữ đang bôi đen: bật MiuWave trong Trợ năng (Accessibility)”(MiuWave가 선택한 텍스트를 복사하도록 허용하세요: 손쉬운 사용에서 MiuWave를 켜세요)가 표시되고, 대신 클립보드 내용을 번역합니다.

Mở cài đặt(설정 열기)를 클릭하거나 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용으로 이동해 MiuWave를 켜세요. 클립보드는 복사할 때마다 원래대로 복원됩니다.

API 키 발급

사용할 엔진의 키만 있으면 됩니다. 키는 macOS 키체인에 저장됩니다.

Soniox(추천)

console.soniox.com에 접속해 계정을 만듭니다.
Billing을 선택하고 결제 수단을 추가한 뒤 충전합니다(최소 $10, 시간당 ~$0.12 기준 약 80시간).
API Keys → Create API Key를 선택하고 키를 복사합니다.
MiuWave에서 Cài đặt(설정) → Engine dịch(번역 엔진) → Soniox API Key 필드에 키를 붙여 넣고 Test를 클릭합니다.

OpenAI(선택)

platform.openai.com에 접속해 계정을 만듭니다.
Settings → Billing: 결제 수단을 추가하고 크레딧을 구매합니다($10 ≈ OpenAI Realtime 2.5시간).
API keys → Create new secret key를 선택하고 키를 복사합니다(sk-로 시작).

비용

OpenAI Realtime은 시간당 약 $4로 Soniox보다 약 34배 비쌉니다. 중요한 회의에 적합하며, 일상적인 용도에는 여전히 Soniox가 더 낫습니다.

Qwen LiveTranslate Flash(선택, 무료 프리뷰)

bailian.console.alibabacloud.com(Alibaba Cloud Model Studio)을 엽니다.
로그인하기 전에 오른쪽 위에서 싱가포르 리전을 선택합니다. 다른 리전에서 만든 키는 거부되며 앱에 WebSocket error가 표시됩니다.
안내가 나오면 Model Studio(DashScope)를 활성화한 뒤 API Keys → Create API Key로 이동합니다.
키는 한 번만 전체가 표시되므로 바로 복사해 Qwen (DashScope) API Key 필드에 붙여 넣습니다.

키 없이 사용하기

Local MLX(Apple Silicon)는 처음 선택할 때 실행 환경과 모델(~5 GB)을 설치합니다. SenseVoice는 ~163 MB 모델을 한 번 다운로드합니다. 엔진 선택을 참고하세요.

macOS 단축키

키	동작
`⌘` `↩`	시작 / 중지
`⌘` `,`	설정 열기
`Esc`	설정 닫기
`⌘` `1` / `2` / `3`	오디오 소스 시스템 / 마이크 / 둘 다
`⌘` `T`	번역 읽어 주기(TTS) 켜기/끄기
`⌘` `P`	창을 다른 창 위에 고정
`⌘` `⇧` `L`	클릭 통과 끄기
`F2` · `F3`	Quick Translate · 화면 캡처 번역(설정 → Quick Translate에서 변경)

업데이트

MiuWave는 새 버전을 자동으로 확인합니다. 새 버전이 있으면 Cài đặt(설정) 버튼에 점이 표시됩니다. Cài đặt(설정) → Giới thiệu(정보)를 열고 Download & Install을 클릭하세요. 앱이 새 버전으로 다시 시작되며, DMG를 다시 다운로드할 필요가 없습니다.