whisper-windows-mcp 2.2.2 → 2.3.0

package/README.ko.md

@@ -17,6 +17,7 @@ Windows 전용 네이티브 MCP(Model Context Protocol) 서버입니다. [whispe
 - *"이 폴더의 배치 전사를 시작해줘"*
 - *"이 파일들을 전사하는 데 얼마나 걸려?"*
 - *"GPU 가속이 작동 중인지 확인해줘"*
+- *"이 파일을 개인 정보 모드로 전사해줘"*
 
 ---
 
@@ -163,12 +164,13 @@ GPU가 감지되고 Vulkan 가속이 활성화되었는지 확인합니다.
 |---|---|
 | `file_path` | 파일의 절대 경로 (필수) |
 | `language` | 언어 코드(`en`, `ko`, `ja` 등) 또는 자동 감지를 위한 `auto`. 기본값: `en` |
-| `output_format` | `text`(기본값), `timestamps`, `json`, `srt` |
+| `output_format` | `timestamps`(기본값), `text`, `json`, `srt`, `vtt`, `lrc`, `csv` |
 | `save_to_file` | 소스 파일 옆에 .txt로 저장 |
 | `background` | 분리된 작업으로 실행 — 즉시 작업 ID 반환. `check_progress`로 모니터링. 10분 이상의 파일에 권장. |
+| `privacy_mode` | 이 호출에 대해 개인 정보 모드를 재정의합니다. `true` = 메타데이터만, 전사 텍스트 미전송. `false` = `WHISPER_PRIVACY_MODE=true`가 전역으로 설정되어도 텍스트 반환. 전역 설정을 사용하려면 생략. |
 | `threads` | CPU 스레드 수 재정의 |
-| `temperature` | 샘플링 온도 0.0–1.0. 기본값 0.0(결정적). 높은 값은 잡음이 많은 음성에서 환각을 줄입니다. |
-| `prompt` | 사전 컨텍스트 문자열 — 도메인별 어휘나 화자 이름의 정확도를 향상시킵니다. 예: `"이름: Keemstar, DramaAlert"` |
+| `temperature` | 샘플링 온도 0.0–1.0. 기본값 0.0(결정적). |
+| `prompt` | 사전 컨텍스트 문자열 — 도메인별 어휘나 화자 이름의 정확도를 향상시킵니다. 예: `"이름: Keemstar, DramaAlert."` |
 | `condition_on_prev_text` | 세그먼트 간 컨텍스트 조건화 재활성화. 기본값 false. |
 | `beam_size` | 빔 탐색 너비. 높을수록 정확도 향상, 속도 저하. 기본값 5. |
 | `best_of` | 평가할 후보 시퀀스 수. 기본값 5. |
@@ -191,6 +193,7 @@ GPU가 감지되고 Vulkan 가속이 활성화되었는지 확인합니다.
 | 파라미터 | 설명 |
 |---|---|
 | `job_id` | `transcribe_audio`가 반환한 작업 ID |
+| `privacy_mode` | 이 호출에 대해 개인 정보 모드를 재정의합니다. |
 
 ---
 
@@ -201,6 +204,8 @@ GPU가 감지되고 Vulkan 가속이 활성화되었는지 확인합니다.
 |---|---|
 | `folder_path` | 폴더 경로 (필수) |
 | `language` | 언어 코드. 기본값: `en` |
+| `output_format` | `timestamps`(기본값), `text`, `srt`, `vtt`, `lrc`, `csv` |
+| `privacy_mode` | 이 배치에 대해 개인 정보 모드를 재정의합니다. |
 | `threads` | CPU 스레드 수 재정의 |
 
 ---
@@ -227,20 +232,22 @@ GPU가 감지되고 Vulkan 가속이 활성화되었는지 확인합니다.
 ---
 
 ### `generate_subtitles`
-SRT 자막 파일을 생성합니다. 자동 언어 감지 및 영어 번역 출력을 지원합니다.
+자막 파일을 생성합니다. 자동 언어 감지 및 영어 번역 출력을 지원합니다.
 
 | 파라미터 | 설명 |
 |---|---|
 | `file_path` | 파일 경로 (필수) |
 | `language` | 언어 코드 또는 자동 감지를 위한 `auto`. 기본값: `en` |
-| `translate_to_english` | 영어 번역 `.en.srt`도 생성. 소스가 영어가 아닌 경우에만 적용. |
+| `output_format` | `srt`(기본값) 또는 `vtt` |
+| `translate_to_english` | 영어 번역 자막 파일도 생성. 소스가 영어가 아닌 경우에만 적용. |
+| `background` | 분리된 백그라운드 작업으로 실행. `check_progress`용 작업 ID를 반환. |
 | `threads` | CPU 스레드 수 재정의 |
 
 두 가지를 모두 요청하면 소스 파일 옆에 두 개의 파일이 저장됩니다:
 - `파일명.ko.srt` — 원본 언어
 - `파일명.en.srt` — 영어 번역
 
-> Whisper의 내장 번역은 **영어로만** 번역합니다. 다른 대상 언어로의 번역은 .srt 파일 내용을 별도로 처리하세요.
+> Whisper의 내장 번역은 **영어로만** 번역합니다. 다른 대상 언어로의 번역은 자막 파일 내용을 별도로 처리하세요.
 
 ---
 
@@ -265,7 +272,7 @@ whisper-cli.exe, 모델 파일, FFmpeg가 모두 접근 가능한지 확인합
 ---
 
 ### `download_model`
-Hugging Face에서 모델 파일을 모델 디렉터리로 직접 다운로드합니다. 모델 이름(예: `large-v3-turbo`, `medium.en-q5_0`)을 받아 다운로드를 자동으로 처리합니다. 신뢰할 수 있는 Hugging Face 네임스페이스에서만 다운로드합니다. 다운로드 후 `switch_model`을 사용하여 활성화하세요.
+Hugging Face에서 모델 파일을 모델 디렉터리로 직접 다운로드합니다. 신뢰할 수 있는 Hugging Face 네임스페이스에서만 다운로드합니다. 다운로드 후 `switch_model`을 사용하여 활성화하세요.
 
 | 파라미터 | 설명 |
 |---|---|
@@ -301,14 +308,16 @@ GPU 하드웨어를 감지하고 Vulkan 가속 사용 가능 여부를 확인합
 
 사전 빌드된 Vulkan 릴리스는 GPU 가속을 자동으로 활성화합니다. AMD Radeon RX Vega 56(GCN 5세대)에서 테스트되었습니다. Vulkan 1.0+ 지원 GPU라면 NVIDIA 및 Intel Arc를 포함하여 모두 작동해야 합니다.
 
-**성능 비교 (medium.en 모델, 약 5분 음성 파일):**
+**성능 비교 (large-v3 모델, 약 14분 음성 파일):**
 
 | 하드웨어 | 시간 |
 |---|---|
-| CPU만 사용 (Ryzen 7 2700x, 8 스레드) | 8–12분 |
-| GPU (Vega 56 via Vulkan) | 20–40초 |
+| CPU만 사용 (Ryzen 7 2700x, 8 스레드) | ~22분 (추정) |
+| GPU (Vega 56 via Vulkan) | ~3분 22초 |
 
-전사 중 GPU 사용률은 일반적으로 15–20%이며, 파일 사이에는 유휴 상태로 돌아갑니다. CPU는 약 15%를 유지합니다.
+전사 중 GPU 사용률은 일반적으로 15–20%이며, 파일 사이에는 유휴 상태로 돌아갑니다.
+
+Windows 10 및 Windows 11을 지원합니다. Windows 11 전용 설정은 필요하지 않습니다 — 이 도구는 Win32 API를 직접 호출하지 않으며 두 운영 체제 모두에서 실행됩니다.
 
 ---
 
@@ -320,9 +329,25 @@ Whisper는 음성 언어를 자동으로 감지하고 해당 언어로 전사할
 
 **예시 — 자막이 있는 외국어 동영상:**
 1. `language=auto`와 `translate_to_english=true`로 자막 생성 요청
-2. Whisper가 언어를 감지하고 원본 언어 SRT 생성
-3. 두 번째 패스에서 영어 번역 SRT 생성
-4. VLC에서 자막 → 자막 파일 추가로 파일 로드
+2. Whisper가 언어를 감지하고 원본 언어 SRT 또는 VTT 생성
+3. 두 번째 패스에서 영어 번역 생성
+4. VLC에서 자막 → 자막 파일 추가로 SRT 파일을 로드하거나 웹 플레이어에서 VTT를 사용
+
+---
+
+## 개인 정보 및 컴플라이언스
+
+whisper-windows-mcp에는 민감하고 규제 대상인 콘텐츠를 위한 내장 개인 정보 아키텍처가 포함되어 있습니다.
+
+**음성 및 동영상은 절대 머신을 떠나지 않습니다.** 이 보장은 무조건적입니다.
+
+**전사 텍스트**는 다릅니다 — 도구 응답에 인라인으로 반환될 때 Claude의 API에서 처리됩니다. 대부분의 사용자에게는 예상된 동작입니다. 규제 대상 콘텐츠(의료, 법률, 재정, 기업)의 경우 개인 정보 모드가 이를 방지합니다.
+
+**개인 정보 모드**는 모든 도구 응답을 메타데이터만(파일명, 단어 수, 저장 경로)으로 제한합니다. 어떤 상황에서도 전사 텍스트가 Claude의 API에 전송되지 않습니다. 전사 도구에서 `privacy_mode=true`로 호출별로 활성화하거나 설정에서 `WHISPER_PRIVACY_MODE=true`로 전역으로 활성화하세요.
+
+**동의 게이트** — 기본 모드에서 세션당 첫 사용 시 전사 텍스트가 반환되기 전에 전체 개인 정보 공개가 표시됩니다. 진행하기 전에 명시적으로 확인해야 합니다. 민감하지 않은 콘텐츠에 대해 이를 건너뛰려면 설정에서 `WHISPER_CONSENT_ACKNOWLEDGED=true`를 설정하세요.
+
+전체 컴플라이언스 안내(HIPAA, GDPR, 변호사-의뢰인 특권, FERPA, SOX, PCI-DSS)는 [PRIVACY.md](PRIVACY.md)를 참고하세요.
 
 ---
 
@@ -340,43 +365,44 @@ Whisper는 음성 언어를 자동으로 감지하고 해당 언어로 전사할
 | `WHISPER_MODEL` | 모델 .bin 파일 경로 (필수) |
 | `WHISPER_THREADS` | CPU 스레드 수 재정의 |
 | `FFMPEG_PATH` | ffmpeg가 시스템 PATH에 없을 경우 경로 |
-| `WHISPER_PRIVACY_MODE` | **계획 중.** `true`로 설정하면 도구 응답에서 전사 텍스트 없이 메타데이터만 반환됩니다. 규제 대상 또는 기밀 콘텐츠에 사용합니다. [PRIVACY.md](PRIVACY.md) 참고. |
+| `WHISPER_PRIVACY_MODE` | `true`로 설정하면 모든 도구 응답에서 전사 텍스트 없이 메타데이터만 반환됩니다. 규제 대상 또는 기밀 콘텐츠에 사용합니다. 호출별 `privacy_mode` 파라미터로 재정의 가능합니다. [PRIVACY.md](PRIVACY.md) 참고. |
+| `WHISPER_CONSENT_ACKNOWLEDGED` | `true`로 설정하면 전사 텍스트 반환 전 표시되는 일회성 세션 동의 공개를 건너뜁니다. 개인 정보 경계를 이해하고 더 이상 알림이 필요하지 않을 때 설정하세요. 개인 정보 모드가 활성화된 경우 효과 없음. |
 
 ---
 
-## 문제 해결
-
-자세한 해결 방법은 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)를 참고하세요. 규제 대상 콘텐츠를 처리하는 경우 [PRIVACY.md](PRIVACY.md)도 참고하세요.
+## 보안
 
-빠른 체크리스트:
-- 설정의 경로에 **백슬래시 두 개** 사용 (`C:\\whisper\\...`)
-- `whisper-cli.exe`가 설정된 경로에 존재
-- 모델 `.bin` 파일이 설정된 경로에 존재
-- FFmpeg가 설치되어 PATH에 있음 (`ffmpeg -version` 작동)
-- 설정 편집 후 Claude Desktop 완전히 재시작
-- 설정 → 개발자에서 whisper가 **실행 중** (초록색 배지)으로 표시
+**바이너리 검증.** 사전 빌드된 릴리스의 whisper-cli.exe 바이너리 무결성을 확인하려면 PowerShell에서 SHA256 해시를 확인하세요:
 
----
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
 
-## 보안 및 개인 정보
+예상 해시는 [릴리스 페이지](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0)에 문서화되어 있습니다.
 
-whisper-windows-mcp는 보안을 핵심 원칙으로 설계되었습니다.
+**입력 검증.** 모든 파일 경로는 사용 전에 검증됩니다 — UNC 경로(`\\server\share`) 및 디렉터리 탐색 시퀀스(`..`)는 거부됩니다. 10 GB를 초과하는 파일은 리소스 고갈을 방지하기 위해 거부됩니다.
 
-**음성은 머신을 떠나지 않습니다.** 음성 또는 동영상 파일, 파일 경로, 텔레메트리가 어떤 서버에도 전송되지 않습니다. 핵심 기능에 클라우드 API가 필요하지 않습니다.
+**전사 인젝션 인식.** 음성 파일에는 전사 시 지시처럼 보이는 발화 내용이 포함될 수 있습니다. Claude의 내장 방어 기능이 이를 처리하지만, MCP 서버 자체도 전사 내용을 데이터로만 처리하며 지시로 해석하지 않는다는 점을 알아두는 것이 좋습니다.
 
-**전사 텍스트와 API 경계.** 도구 응답에 전사 텍스트가 포함되면 해당 텍스트는 Claude의 API에서 처리됩니다 — 로컬 머신을 떠납니다. 대부분의 사용자(공개 콘텐츠, 팟캐스트, 스트리밍 녹화 등)에게는 이것이 예상된 동작입니다. 의료, 법률, 재정 또는 기타 규제 대상 녹음을 처리하는 경우 컴플라이언스 안내와 설정 옵션을 위해 [PRIVACY.md](PRIVACY.md)를 참고하세요.
+**모델 다운로드는 제한됩니다.** `download_model` 도구는 두 개의 신뢰할 수 있는 Hugging Face 네임스페이스(`ggerganov/whisper.cpp` 및 `ggml-org`)에서만 다운로드합니다. 임의의 URL은 거부됩니다. 리다이렉트는 허용 목록에 대해 검증된 후 따릅니다.
 
-`WHISPER_PRIVACY_MODE` 환경 변수가 계획 중입니다. 활성화 시 모든 도구 응답을 메타데이터만(파일명, 재생 시간, 단어 수)으로 제한하며 전사 텍스트가 Claude에 반환되지 않습니다. 이는 규제 대상 또는 기밀 콘텐츠의 올바른 설정입니다.
+**모델 전환은 샌드박스화됩니다.** `switch_model`은 설정된 모델 디렉터리 내의 `.bin` 파일만 허용합니다. 해당 디렉터리 외부의 경로는 거부됩니다.
 
-**입력 검증.** 모든 파일 경로는 사용 전에 검증됩니다 — UNC 경로(`\\server\share`) 및 디렉터리 탐색 시퀀스(`..`)는 거부됩니다. 10 GB를 초과하는 파일은 리소스 고갈을 방지하기 위해 거부됩니다.
+전체 보안 정책은 [SECURITY.md](SECURITY.md)를 참고하세요.
 
-**전사 인젝션 인식.** 음성 파일에는 전사 시 지시처럼 보이는 발화 내용이 포함될 수 있습니다. Claude의 내장 방어 기능이 이를 처리하지만, MCP 서버 자체도 전사 내용을 데이터로 처리하며 지시로 해석하지 않는다는 점을 알아두는 것이 좋습니다.
+---
 
-**모델 다운로드는 제한됩니다.** `download_model` 도구는 두 개의 신뢰할 수 있는 Hugging Face 네임스페이스(`ggerganov/whisper.cpp` 및 `ggml-org`)에서만 다운로드합니다. 임의의 URL은 거부됩니다. 리다이렉트는 허용 목록에 대해 검증된 후 따릅니다.
+## 문제 해결
 
-**모델 전환은 샌드박스화됩니다.** `switch_model`은 설정된 모델 디렉터리 내의 `.bin` 파일만 허용합니다. 해당 디렉터리 외부의 경로는 거부됩니다.
+자세한 해결 방법은 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)를 참고하세요. 규제 대상 콘텐츠를 처리하는 경우 [PRIVACY.md](PRIVACY.md)도 참고하세요.
 
-**새로운 네트워크 의존성 없음.** 모델 다운로드는 Node.js 내장 `https`를 사용 — 외부 HTTP 라이브러리가 패키지에 추가되지 않습니다.
+빠른 체크리스트:
+- 설정의 경로에 **백슬래시 두 개** 사용 (`C:\\whisper\\...`)
+- `whisper-cli.exe`가 설정된 경로에 존재
+- 모델 `.bin` 파일이 설정된 경로에 존재
+- FFmpeg가 설치되어 PATH에 있음 (`ffmpeg -version` 작동)
+- 설정 편집 후 Claude Desktop 완전히 재시작
+- 설정 → 개발자에서 whisper가 **실행 중** (초록색 배지)으로 표시
 
 ---
 
@@ -384,7 +410,7 @@ whisper-windows-mcp는 보안을 핵심 원칙으로 설계되었습니다.
 
 **비상업적 사용:** MIT — 개인, 교육, 비상업적 목적의 사용은 무료입니다. [LICENSE](LICENSE)를 참조하세요.
 
-**상업적 사용:** 비즈니스, 전문적 또는 수익 창출 목적의 사용에는 별도의 상업용 라이선스가 필요합니다. 조건 및 연락처는 [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md)를 참조하세요.
+**상업적 사용:** 비즈니스, 전문적 또는 수익 창출 목적의 사용에는 별도의 상업용 라이선스가 필요합니다. 조건 및 연락처는 [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md)를 참조하세요.
 
 ## 기여
 

package/README.md

@@ -17,6 +17,7 @@ Once installed, you can say things like this directly in Claude Desktop:
 - *"Start a batch transcription of everything in this folder"*
 - *"How long will it take to transcribe these files?"*
 - *"Check if GPU acceleration is working"*
+- *"Transcribe this file in privacy mode"*
 
 ---
 
@@ -163,11 +164,12 @@ Transcribe a single file. Supports blocking (default) or background mode for lon
 |---|---|
 | `file_path` | Absolute path to the file (required) |
 | `language` | Language code (`en`, `ja`, `es`, etc.) or `auto` to detect. Default: `en` |
-| `output_format` | `text` (default), `timestamps`, `json`, or `srt` |
+| `output_format` | `timestamps` (default), `text`, `json`, `srt`, `vtt`, `lrc`, or `csv` |
 | `save_to_file` | Save transcript as .txt next to the source file |
 | `background` | Run as detached job — returns a job ID immediately. Use `check_progress` to monitor. Recommended for files over 10 minutes. |
+| `privacy_mode` | Override privacy mode for this call. `true` = metadata only, no transcript text transmitted. `false` = return text even if `WHISPER_PRIVACY_MODE=true` globally. Omit to use global setting. |
 | `threads` | CPU thread override |
-| `temperature` | Sampling temperature 0.0–1.0. Default 0.0 (deterministic). Higher values reduce hallucination on noisy audio. |
+| `temperature` | Sampling temperature 0.0–1.0. Default 0.0 (deterministic). |
 | `prompt` | Prior context string — improves accuracy for domain-specific vocabulary or speaker names. Example: `"Names: Keemstar, DramaAlert."` |
 | `condition_on_prev_text` | Re-enable context conditioning between segments. Default false. |
 | `beam_size` | Beam search width. Higher = more accurate, slower. Default 5. |
@@ -181,32 +183,44 @@ Transcribe a single file. Supports blocking (default) or background mode for lon
 | `offset_t` | Start offset in milliseconds. |
 | `duration` | Process duration in milliseconds from offset. |
 
+**Output formats:**
+- `timestamps` — timestamped segments, e.g. `[00:00:01.230 --> 00:00:04.560]  Hello world` (default)
+- `text` — plain text, no time codes
+- `json` — structured JSON (blocking mode only)
+- `srt` — SubRip subtitle file saved next to source
+- `vtt` — WebVTT subtitle file saved next to source
+- `lrc` — LRC lyrics/karaoke format saved next to source
+- `csv` — CSV with timestamps saved next to source
+
 ---
 
 ### `check_progress`
 Monitor a background transcription job started with `transcribe_audio` (background=true).
 
-Returns elapsed time, last processed timestamp, percentage, and the full transcript when complete.
+Returns elapsed time, last processed timestamp, and the full transcript when complete.
 
 | Parameter | Description |
 |---|---|
 | `job_id` | Job ID returned by `transcribe_audio` |
+| `privacy_mode` | Override privacy mode for this check. `true` = metadata only, regardless of how the job was started. |
 
 ---
 
 ### `start_batch`
-Automated sequential batch transcription of all untranscribed files in a folder. Sorts by duration (shortest first), processes one at a time as background jobs, validates each output.
+Automated sequential batch transcription of all untranscribed files in a folder. Sorts by duration (shortest first), processes one at a time as background jobs, validates each output. Batch self-advances when each file finishes — no polling required.
 
 | Parameter | Description |
 |---|---|
 | `folder_path` | Path to folder (required) |
 | `language` | Language code. Default: `en` |
 | `threads` | CPU thread override |
+| `output_format` | `timestamps` (default) or `text` |
+| `privacy_mode` | Override privacy mode. One confirmation required before batch start; all files then process unattended. No transcript text returned. |
 
 ---
 
 ### `check_batch_progress`
-Monitor a running batch. Automatically advances to the next file when the current one finishes. Returns overall progress, current file with timestamp, ETA, and any failed files.
+Monitor a running batch. Automatically advances to the next file when the current one finishes. Returns overall progress, current file with timestamp, and any failed files.
 
 | Parameter | Description |
 |---|---|
@@ -223,24 +237,28 @@ Process files one at a time with a preview and confirmation before each. Useful
 | `file_index` | Which file to process (1-based). Omit to list files first. |
 | `language` | Language code. Default: `en` |
 | `recursive` | Include subfolders |
+| `output_format` | `timestamps` (default) or `text` |
+| `privacy_mode` | Override privacy mode. Confirmation required before each file; metadata only returned. |
 
 ---
 
 ### `generate_subtitles`
-Generate SRT subtitle files. Supports automatic language detection and English translation output.
+Generate subtitle files. Supports automatic language detection and English translation output. Outputs SRT (widest compatibility) or WebVTT (web and HTML5 video).
 
 | Parameter | Description |
 |---|---|
 | `file_path` | Path to file (required) |
 | `language` | Language code or `auto` to detect. Default: `en` |
-| `translate_to_english` | Also generate an English translation `.en.srt`. Only applies when source is not English. |
+| `output_format` | `srt` (default) or `vtt` |
+| `translate_to_english` | Also generate an English translation subtitle file. Only applies when source is not English. |
+| `background` | Run as detached background job. Returns a job ID for `check_progress`. |
 | `threads` | CPU thread override |
 
 When both native and translation are requested, two files are saved next to the source:
 - `filename.ja.srt` — original language
 - `filename.en.srt` — English translation
 
-> Whisper's built-in translation only translates **to English**. For other target languages, translate the .srt file contents separately.
+> Whisper's built-in translation only translates **to English**. For other target languages, translate the subtitle file contents separately.
 
 ---
 
@@ -265,7 +283,7 @@ List all Whisper model files installed in your models directory. Shows filename,
 ---
 
 ### `download_model`
-Download a Whisper model directly from Hugging Face into your models directory. Accepts a model name (e.g. `large-v3-turbo`, `medium.en-q5_0`) and handles the download automatically. Only downloads from trusted Hugging Face namespaces. After downloading, use `switch_model` to activate it.
+Download a Whisper model directly from Hugging Face into your models directory. Only downloads from trusted Hugging Face namespaces. After downloading, use `switch_model` to activate it.
 
 | Parameter | Description |
 |---|---|
@@ -301,14 +319,16 @@ Detect GPU hardware and verify Vulkan acceleration is available. Reports GPU nam
 
 The pre-built Vulkan release enables GPU acceleration automatically. Tested on AMD Radeon RX Vega 56 (GCN 5th gen). Any GPU with Vulkan 1.0+ support should work, including NVIDIA and Intel Arc.
 
-**Performance comparison (medium.en model, ~5 minute audio file):**
+**Performance comparison (large-v3 model, ~14 minute audio file):**
 
 | Hardware | Time |
 |---|---|
-| CPU only (Ryzen 7 2700x, 8 threads) | 8–12 minutes |
-| GPU (Vega 56 via Vulkan) | 20–40 seconds |
+| CPU only (Ryzen 7 2700x, 8 threads) | ~22 minutes (estimated) |
+| GPU (Vega 56 via Vulkan) | ~3m 22s |
+
+GPU utilization during transcription is typically 15–20%, dropping back to idle between files.
 
-GPU utilization during transcription is typically 15–20%, dropping back to idle between files. CPU stays around 15%.
+Supports Windows 10 and Windows 11. No Windows 11-specific configuration is required — the tool makes no Win32 API calls and runs on either OS.
 
 ---
 
@@ -320,9 +340,25 @@ For best multilingual accuracy, use the `large-v3` model. English-specific model
 
 **Example — foreign language video with subtitles:**
 1. Ask Claude to generate subtitles with `language=auto` and `translate_to_english=true`
-2. Whisper detects the language and generates a native-language SRT
-3. A second pass generates an English translation SRT
-4. Load either file in VLC via Subtitle → Add Subtitle File
+2. Whisper detects the language and generates a native-language SRT or VTT
+3. A second pass generates an English translation
+4. Load the SRT in VLC via Subtitle → Add Subtitle File, or use the VTT in any web player
+
+---
+
+## Privacy and compliance
+
+whisper-windows-mcp includes a built-in privacy architecture for sensitive and regulated content.
+
+**Audio and video never leave your machine.** This guarantee is unconditional.
+
+**Transcript text** is different — when returned inline in a tool response, it is processed by Claude's API. For most users this is expected behavior. For regulated content (medical, legal, financial, corporate), privacy mode prevents this.
+
+**Privacy mode** restricts all tool responses to metadata only (filename, word count, save path). No transcript text is transmitted to Claude's API under any circumstances. Enable per-call with `privacy_mode=true` on any transcription tool, or globally via `WHISPER_PRIVACY_MODE=true` in your config.
+
+**Consent gate** — on first use per session in standard mode, a full privacy disclosure is shown before any transcript text is returned. You must explicitly confirm before proceeding. Set `WHISPER_CONSENT_ACKNOWLEDGED=true` in your config to skip this for non-sensitive content.
+
+See [PRIVACY.md](PRIVACY.md) for full compliance guidance (HIPAA, GDPR, attorney-client privilege, FERPA, SOX, PCI-DSS).
 
 ---
 
@@ -340,33 +376,20 @@ This tool is built to minimize Claude API interactions. The entire transcription
 | `WHISPER_MODEL` | Path to model .bin file (required) |
 | `WHISPER_THREADS` | CPU thread count override |
 | `FFMPEG_PATH` | Path to ffmpeg if not in system PATH |
-| `WHISPER_PRIVACY_MODE` | **Planned.** When set to `true`, tool responses return metadata only — no transcript text is returned to Claude's API. For regulated or confidential content. See [PRIVACY.md](PRIVACY.md). |
+| `WHISPER_PRIVACY_MODE` | When `true`, all tool responses return metadata only — no transcript text transmitted to Claude's API. For regulated or confidential content. Can be overridden per-call with the `privacy_mode` parameter. See [PRIVACY.md](PRIVACY.md). |
+| `WHISPER_CONSENT_ACKNOWLEDGED` | When `true`, skips the one-time session consent disclosure shown before transcript text is returned. Set after you understand the privacy boundary and no longer need the reminder. Has no effect when privacy mode is active. |
 
 ---
 
-## Troubleshooting
-
-See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for detailed solutions. See [PRIVACY.md](PRIVACY.md) for compliance guidance if you handle regulated content.
+## Security
 
-Quick checklist:
-- Paths in config use **double backslashes** (`C:\\whisper\\...`)
-- `whisper-cli.exe` exists at the configured path
-- Model `.bin` file exists at the configured path
-- FFmpeg is installed and in PATH (`ffmpeg -version` works)
-- Claude Desktop was fully restarted after editing config
-- Whisper shows **running** in Settings → Developer
+**Binary verification.** To verify the integrity of the whisper-cli.exe binary in the pre-built release, check its SHA256 hash in PowerShell:
 
----
-
-## Security and Privacy
-
-whisper-windows-mcp is designed with security as a core principle.
-
-**Audio never leaves your machine.** No audio or video files, no file paths, and no telemetry are ever transmitted to any server. No cloud APIs are required for core functionality.
-
-**Transcript text and the API boundary.** When a tool response includes transcript text, that text is processed by Claude's API — it leaves your local machine. For most users (public content, podcasts, streaming recordings) this is expected behavior. If you handle medical, legal, financial, or other regulated recordings, see [PRIVACY.md](PRIVACY.md) for compliance guidance and configuration options.
+```powershell
+Get-FileHash "C:\whisper\Release\whisper-cli.exe" -Algorithm SHA256
+```
 
-A `WHISPER_PRIVACY_MODE` environment variable is planned that will restrict all tool responses to metadata only (filename, duration, word count) — no transcript text will be returned to Claude. This is the correct configuration for regulated or confidential content.
+The expected hash for the v1.4.0 release binary is documented in the [releases page](https://github.com/eviscerations/whisper-windows-mcp/releases/tag/v1.4.0).
 
 **Input validation.** All file paths are validated before use — UNC paths (`\\server\share`) and directory traversal sequences (`..`) are rejected. Files over 10 GB are rejected to prevent resource exhaustion.
 
@@ -376,7 +399,21 @@ A `WHISPER_PRIVACY_MODE` environment variable is planned that will restrict all
 
 **Model switching is sandboxed.** `switch_model` only accepts `.bin` files within the configured models directory. Paths outside that directory are rejected.
 
-**No new network dependencies.** Model downloads use Node.js built-in `https` — no external HTTP libraries are added to the package.
+See [SECURITY.md](SECURITY.md) for the full security policy.
+
+---
+
+## Troubleshooting
+
+See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for detailed solutions. See [PRIVACY.md](PRIVACY.md) for compliance guidance if you handle regulated content.
+
+Quick checklist:
+- Paths in config use **double backslashes** (`C:\\whisper\\...`)
+- `whisper-cli.exe` exists at the configured path
+- Model `.bin` file exists at the configured path
+- FFmpeg is installed and in PATH (`ffmpeg -version` works)
+- Claude Desktop was fully restarted after editing config
+- Whisper shows **running** in Settings → Developer
 
 ---
 
@@ -384,7 +421,7 @@ A `WHISPER_PRIVACY_MODE` environment variable is planned that will restrict all
 
 **Non-commercial use:** MIT — free for personal, educational, and non-commercial use. See [LICENSE](LICENSE).
 
-**Commercial use:** A separate commercial license is required for any business, professional, or revenue-generating use. See [LICENSE-COMMERCIAL.md](LICENSE-COMMERCIAL.md) for terms and contact information.
+**Commercial use:** A separate commercial license is required for any business, professional, or revenue-generating use. See [COMMERCIAL-LICENSE.md](COMMERCIAL-LICENSE.md) for terms and contact information.
 
 ## Contributing