MacWhisper CLI: mw 설치, 터미널에서 받아쓰기, 모든 옵션
글쓴이 Ryleigh Newman · 게시일
MacWhisper에는 mw라는 명령줄 도구가 함께 들어 있습니다. 터미널에서 앱을 제어하는 도구로, 파일과 폴더 전체를 받아쓰고, 화자를 구분하고, 자막이나 JSON을 만들고, 모델을 확인하거나 바꿀 수 있습니다. 실행 중인 MacWhisper 앱과 로컬 소켓으로 통신하므로 이미 설정해 둔 엔진, 모델, 설정을 그대로 쓰고, 앱이 열려 있지 않으면 앱을 실행합니다.
저는 받아쓰기와 파일 받아쓰기를 위한 다른 Mac 앱인 YapToText를 만들고 있으니, MacWhisper에 관한 제 설명은 그 점을 감안하고 읽어 주세요. 여기에 적은 MacWhisper의 사실은 모두 2026년 10월 10일에 읽은 도움말 문서 MacWhisper Command-Line Tool에서 가져왔습니다.
무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.
다른 언어로 읽기: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
mw 설치하기
- MacWhisper를 열고 Settings(설정), Advanced(고급) 순서로 엽니다.
- Command-Line Tool(명령줄 도구) 아래의 Install(설치)을 클릭합니다.
- macOS에서 요청하면 Mac 암호를 입력합니다. /usr/local/bin에 쓰려면 필요합니다.
- 새 터미널 창을 열고 mw version을 실행합니다.
도구는 /usr/local/bin/mw에 설치되고, 끝나면 설정 창에 녹색 체크 표시가 나타납니다. mw version이 버전 번호를 출력하면 정상입니다. 지우려면 같은 창으로 돌아가 Uninstall(제거)을 클릭합니다.
파일 하나 받아쓰기
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopy실행 결과: 받아쓴 글이 표준 출력으로 나옵니다. 진행 상황은 표준 오류로 나가므로, 파일로 리디렉션하면 파일에는 받아쓴 글만 들어갑니다.
기본값에서는 명령줄로 받아쓴 내용이 저장되지 않습니다. 출력하고 버리며, --persist를 붙여야만 MacWhisper의 기록에 남습니다. Ctrl+C로 실행을 멈출 수 있습니다. 이미 있는 출력 파일은 --overwrite를 붙이지 않으면 덮어쓰지 않습니다.
명령 목록
MacWhisper 도움말 문서에서 가져왔고, 2026년 10월 10일에 읽었습니다. 명령 뒤에 --help를 붙이면 그 명령의 옵션이 나옵니다.
| 명령 | 하는 일 |
|---|---|
| mw | 상태 개요를 보여 줍니다. 앱에 연결되는지, 선택된 모델, 내려받은 모델, 사용 예가 나옵니다 |
| mw version | MacWhisper 버전을 출력합니다. 연결 확인에 쓸 수 있습니다 |
| mw models list | 설치된 받아쓰기 모델을 ID와 함께 나열합니다 |
| mw models select | 사용 중인 모델을 바꿉니다. 명령줄 도구와 앱 모두에 적용됩니다 |
| mw transcribe | 오디오나 비디오 파일 또는 폴더 전체를 받아쓰고 글을 출력합니다 |
mw transcribe의 옵션
같은 문서에서 가져왔습니다. 선택한 모델이 받아쓸 수 없는 언어를 지정하면 오류가 납니다.
| 옵션 | 하는 일 |
|---|---|
| --speakers, --no-speakers | 이번 실행에서 화자 감지를 켜거나 끕니다. 켜면 받아쓴 글이 화자별로 묶입니다 |
| --format | 기본값은 txt이고, srt, vtt, json, csv, md, html, avid도 고를 수 있습니다 |
| --style | transcript, subtitles, segments 중 하나이며, 앱의 내보내기 패널과 같은 스타일입니다 |
| --model | 앱에서 선택한 모델은 바꾸지 않고 이번 실행에만 해당 모델을 씁니다 |
| --language | en이나 de 같은 ISO 코드, 또는 auto, multilingual |
| --output, -o | 받아쓴 글을 파일로 저장합니다 |
| --output-dir | 일괄 처리용입니다. 입력마다 받아쓴 글 하나를 폴더에 저장합니다 |
| --recursive | 폴더를 지정했을 때 하위 폴더까지 포함합니다 |
| --stream | 세그먼트가 끝나는 대로 출력합니다. 로컬 엔진에서만 됩니다 |
| --persist | 받아쓴 내용을 MacWhisper의 기록에 남깁니다 |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | 레이아웃을 세밀하게 조정합니다 |
형식, 그리고 Pro가 필요한 형식
같은 문서에서 가져왔습니다. Pro의 가격은 MacWhisper 가격 페이지에서 설명합니다.
| 형식 | 결과물 | 라이선스 |
|---|---|---|
| txt | 일반 텍스트 | 모든 사용자 |
| srt | SubRip 자막 | 모든 사용자 |
| vtt | WebVTT 자막 | 모든 사용자 |
| csv | 시작, 끝, 받아쓴 글의 행이며, 화자를 감지했다면 화자도 들어 있습니다 | 모든 사용자 |
| json | 밀리초 단위 타임스탬프, 세그먼트별 화자, 단어별 타이밍 | Pro |
| md | 타임스탬프가 붙은 블록과 화자 제목이 있는 Markdown | Pro |
| html | 독립된 HTML 문서 | Pro |
| avid | SMPTE 타임코드가 붙은 Avid 자막 텍스트 | Pro |
폴더 전체 받아쓰기
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txt실행 결과: 입력마다 그 이름을 딴 파일이 하나씩 생기고, 폴더 구조도 그대로 만들어집니다. 실패한 파일은 보고하고 건너뛰며, 나머지는 계속 처리합니다.
화자 감지를 쓰려면 이를 지원하는 모델이 필요합니다. 앱의 이 기능은 화자 인식 페이지에서 설명합니다.
작동하지 않을 때
- mw: command not found. 새 터미널 창을 열거나 /usr/local/bin을 PATH에 추가합니다.
- 멈춘 것처럼 보일 때. MacWhisper를 종료했다가 다시 열고 mw version을 시도합니다.
- 모델 ID를 인식하지 못할 때. mw models list로 정확한 ID를 확인하고, 먼저 앱에서 모델을 내려받습니다.
- 형식에서 Pro 오류가 날 때. json, md, html, avid는 Pro 라이선스가 필요합니다.
- 샌드박스 오류. 일부 AI 코딩 도구를 포함해 샌드박스에서 실행되는 프로그램은 MacWhisper의 소켓에 접근하지 못할 수 있습니다. mw는 터미널에서 직접 실행하세요.
앱 자체의 문제는 MacWhisper 문제 해결 페이지에서 설명합니다.
터미널에서 무료로 쓰는 방법
YapToText에는 명령줄 도구가 없습니다. 끌어다 놓은 파일을 한 번에 하나씩 일반 텍스트로 받아쓰며, 무료입니다. 터미널을 쓰고 싶지만 따로 구입하고 싶지 않다면, whisper.cpp는 오픈 소스이고 YapToText가 바탕으로 삼은 엔진입니다. 명령은 로컬 Whisper 가이드에 있고, 무료 도구 네 가지는 오픈 소스 받아쓰기 페이지에서 비교합니다.
무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.
요약
- 설치. Settings, Advanced, Command-Line Tool, Install 순서입니다.
- 실행. mw transcribe 뒤에 파일이나 폴더를 적습니다.
- 무료 형식. txt, srt, vtt, csv입니다.
- Pro 형식. json, md, html, avid입니다.
- 기록. --persist를 붙이지 않으면 아무것도 저장되지 않습니다.
MacWhisper가 도구를 바꿔서 이 페이지가 뒤처지면 GitHub에 이슈를 남겨 주세요. 모두 읽습니다.
무료로 다운로드할 수 있습니다. 계정이 필요 없고 잠긴 기능도 없습니다. Apple Silicon이 탑재된 Mac과 macOS 14 이상이 필요합니다. 소스 코드는 GitHub에 있습니다.
가이드
다른 가이드(영어)
출처
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (확인일 2026년 10월 10일)
- https://github.com/ryleighnewman/YapToText (확인일 2026년 10월 10일)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (확인일 2026년 10월 10일)
자주 묻는 질문
MacWhisper에 명령줄 도구가 있나요?
네. 이름은 mw이고, MacWhisper의 Settings, Advanced, Command-Line Tool에서 설치합니다.
터미널에서 MacWhisper로 파일을 받아쓰려면 어떻게 하나요?
mw transcribe 뒤에 파일 경로를 적어 실행합니다. 받아쓴 글이 표준 출력으로 나오고, -o를 쓰면 파일로 저장됩니다.
MacWhisper CLI는 무료인가요?
도움말 문서에 따르면 txt, srt, vtt, csv 출력은 모든 사용자가 쓸 수 있고, json, md, html, avid는 Pro 라이선스가 필요합니다.
MacWhisper CLI로 폴더 전체를 받아쓸 수 있나요?
네. mw transcribe에 폴더를 지정하고, 하위 폴더까지 포함하려면 --recursive를, 파일마다 받아쓴 글을 따로 저장하려면 --output-dir을 붙입니다.
mw를 쓰려면 MacWhisper가 열려 있어야 하나요?
실행 중인 앱과 통신하며, 앱이 열려 있지 않으면 MacWhisper를 자동으로 실행합니다.