Files
voice_copy/voice-changer
EJClaw c24cd1f9c0 voice-changer: allow installing under user-owned folders (Desktop); move admin-run parts to Program Files
The installer refused folders whose parent is user-owned (Desktop, Documents) because a user could swap
the whole install folder and get the elevated/audiodg-run parts replaced. Instead of refusing, the parts
that run with admin rights or inside audiodg now live in {commonpf}\VoiceChanger, which only admins can
change; the chosen folder keeps the app, Python, engine, models and data.

- VoiceChanger.iss: SysDir = {commonpf}\VoiceChanger holds apo\ (VoiceChangerAPO.dll), scripts\mic-apo.ps1
  and the uninstaller (UninstallFilesDir). CheckParent removed. Upgrade detection also matches the previous
  install dir from the uninstall registry (PrevAppDir) since uninstall\ is no longer inside the app folder.
  Stop the audio service when either the new or the v1.0.1-layout APO exists. Ask before installing into
  a OneDrive-synced folder.
- secure-dir.ps1: drop CheckParent; Prepare takes -Upgrade.
- mic-apo.ps1: -From <previous app folder> migrates a v1.0.1 apo\ or 21b4278 config\ backup (validated as
  before) into the Program Files apo\, removing the emptied old apo\.
- app: admin_root() finds Program Files\VoiceChanger (falls back to the app folder for the zip layout);
  hooked-mic list, mic-apo log and the reconnect button use it.

Windows 11 VM (Inno 6.7.4 build, AppVersion 1.0.2): v1.0.1 at C:\VoiceChanger -> upgrade: backup moved
byte-equal, APO re-pointed to Program Files, old apo\ scripts\mic-apo.ps1 uninstall\ gone; fresh install to
C:\Users\ci\Desktop\VoiceChanger (owner WIN-CI\ci) with full engine download: exit 0, audiodg loads
C:\Program Files\VoiceChanger\apo\VoiceChangerAPO.dll, 440 Hz APO test + Communications stream PASS;
basic-user token can rename the Desktop folder but every Program Files write/rename is ERROR_ACCESS_DENIED;
reinstall over the same folder keeps user files; uninstall restores FxProperties (only the endpoint
timestamp properties differ, same as v1.0.1) and removes both folders.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 22:09:39 +09:00
..

실시간 음성 변환기 (Windows 게임PC)

마이크로 말하면 고른 목소리 모델로 바꿔서 바로 내보냅니다. 디스코드나 게임에서 그 목소리로 말할 수 있습니다. 목소리 모델은 consent-recorder 로 동의받아 모은 녹음으로 이 PC 에서 직접 학습합니다 (RVC v2).

  • 엔진: Applio (MIT, RVC 학습 · 실시간 변환). scripts/install.ps1 에 커밋을 고정해 둠
  • 기준 PC: RTX 5070 Ti 16GB (Blackwell) · DDR5 128GB · Ryzen 9 9950X3D · Windows 11
    • torch 2.11 + CUDA 12.8 (RTX 50 시리즈 지원). NVIDIA 드라이버 580 이상
    • 디스크: 설치 약 8GB(Python · torch · 엔진 기본 모델) + 모델마다 약 80MB + 학습 중간 파일. 예시 모델까지 만들면 15GB 정도 여유를 두세요

설치 — VoiceChangerSetup.exe 하나만

  1. VoiceChangerSetup.exe 를 실행합니다 (관리자 권한 확인 창이 뜹니다).
  2. 설치할 폴더를 고릅니다. 기본값은 C:\VoiceChanger 이고, 다른 드라이브(D:\...)나 한글 · 띄어쓰기가 들어간 경로도 됩니다. 비어 있는 폴더나 새 폴더만 됩니다 (다른 파일이 든 폴더는 거절합니다). 바탕 화면 · 문서 아래(예: 바탕 화면\VoiceChanger)도 됩니다. OneDrive 로 동기화되는 폴더를 고르면 한 번 더 묻습니다. Python · 엔진 · torch · 목소리 모델 · 설정 · 학습 파일 · 캐시 · 임시 파일이 모두 이 폴더 안에만 저장됩니다. 설치하면서 약 8GB 를 내려받고 모델을 만들수록 늘어나므로 15GB 이상 비어 있는 드라이브를 고르세요.
  3. 설치 프로그램이 마이크마다 변환 모듈을 붙이고(윈도우 소리가 12초 끊김), 검은 창에서 Python 3.12 · 엔진(Applio) · torch(CUDA 12.8) · 엔진 기본 모델(rmvpe · contentvec · 사전학습 가중치 · ffmpeg)을 그 폴더로 내려받습니다. 1020분 걸립니다. 마지막에 GPU 확인: NVIDIA GeForce RTX 5070 Ti (sm_120) 가 나오면 정상입니다.
  4. 시작 메뉴의 음성 변환기로 실행합니다.

가상 오디오 장치(VB-CABLE 등)는 필요 없습니다. 변환기가 내 마이크에서 나가는 소리를 직접 바꿔 주므로, 디스코드 · 게임의 입력 장치는 평소 쓰던 마이크 그대로 두면 됩니다.

  • 내려받다가 끊기면 설치 폴더의 install.bat 을 실행합니다. 받은 곳부터 이어서 받습니다.
  • 권한: 관리자 권한 · 오디오 서비스가 실행하는 마이크 모듈(apo\) · mic-apo.ps1 · 제거 프로그램은 고른 폴더가 아니라 C:\Program Files\VoiceChanger 에 설치합니다 (고른 폴더의 상위가 사용자 소유여도 폴더를 바꿔쳐 관리자 권한을 얻지 못하게). 설치 프로그램은 고른 폴더의 소유자도 Administrators 로 바꾸고 잠근 뒤 확인합니다(installer\secure-dir.ps1, 실패하면 설치 중단). 설치 폴더와 실행 파일 · app\ · scripts\ 는 관리자만 고칠 수 있습니다. 일반 사용자는 models · training · datasets · config · cache · env · engine · tools 에만 씁니다. 엔진 내려받기(install.ps1)는 관리자 권한 없이 돕니다.
  • 폴더 밖에 남는 것은 윈도우가 관리하는 항목뿐입니다: 시작 메뉴 바로 가기, 프로그램 제거 목록, 마이크 모듈 등록(레지스트리). 사용자 폴더(%APPDATA% · %LOCALAPPDATA% · %TEMP% · .cache)에는 아무것도 쓰지 않습니다.
  • 제거: 설정 → 앱 → 음성 변환기 → 제거. 마이크 설정을 원래대로 되돌리고, 만든 모델 · 녹음 · 설정까지 지울지 묻습니다.

마이크 모듈은 어떻게 동작하나

윈도우는 마이크 소리를 앱에 넘기기 전에 오디오 처리 모듈(APO, Equalizer APO 와 같은 방식)을 거칩니다. 설치 프로그램이 C:\Program Files\VoiceChanger\apo\VoiceChangerAPO.dll 을 각 마이크의 처리 단계에 붙입니다 (scripts\mic-apo.ps1, 바꾼 값의 원래 값은 같은 곳의 apo\mic-apo-backup.json, 이전 버전이 앱 폴더의 apo\ · config\ 에 둔 백업은 값을 검증한 뒤 옮김). 통화 앱(디스코드 등)이 여는 통화(Communications) 모드 스트림에도 붙도록 기본 · 통화 · 음성 · 미디어 모드로 등록합니다. 드라이버가 이미 모드 목록을 갖고 있으면 그 목록을 그대로 둡니다.

  • 변환기가 꺼져 있으면 아무것도 하지 않습니다. 원래 목소리가 그대로 나갑니다
  • 변환을 켜면 고른 마이크의 소리를 변환기로 넘기고, 바뀐 목소리를 대신 내보냅니다. 바뀐 소리가 아직 없을 때는 무음이라 원래 목소리가 새지 않습니다
  • 변환기가 꺼지거나 멈추면 1.5초 안에 원래 목소리로 돌아갑니다
  • 그 마이크를 쓰는 모든 앱(디스코드 · 게임 · 녹음기)에 바뀐 목소리가 갑니다
  • 윈도우 소리 설정에서 마이크의 오디오 향상을 끄면 모듈이 빠집니다. 설치할 때 켜 두지만, 직접 끄면 변환이 안 됩니다
  • 새로 꽂은 마이크나 드라이버를 업데이트한 마이크는 변환기 화면의 마이크 다시 연결을 누릅니다

변환하기 — 음성 변환기

  1. 목소리 모델을 고릅니다. 직접 학습한 모델이 위에, 예시 모델이 아래에 나옵니다.
  2. 내 목소리 성별을 고르면 성별이 다른 모델은 음높이를 ±12반음(한 옥타브)으로 자동으로 맞춥니다. 슬라이더로 더 맞출 수 있고, 켜 둔 채로 바꿔도 바로 적용됩니다.
  3. 마이크에서 내 마이크를 고릅니다. 디스코드 입력 장치도 같은 마이크로 둡니다.
  4. 내 귀로 확인하려면 내 귀로 듣기를 켜고 헤드셋을 고릅니다.
  5. ▶ 변환 시작. 처음에는 모델을 불러오느라 몇 초 걸립니다. 아래에 처리 시간(ms)이 나옵니다.
  • 지연: 보통(0.25초)이 기본입니다. RTX 5070 Ti 는 낮음(0.13초)도 됩니다. 소리가 끊기면 한 단계 올리세요.
  • 잡음 무시: 이 크기(dB)보다 작은 소리는 변환하지 않습니다. 키보드 소리가 들어가면 올리세요.
  • 설정은 config\settings.json 에 저장돼 다음에 그대로 열립니다.

녹음할 서버 정하기 — 녹음 서버

녹음 봇(동의 사이트 https://vc.tkrmagid.kr)이 어느 디스코드 서버에서 녹음할지 앱에서 켜고 끕니다.

  1. 동의 사이트에 운영자 디스코드 계정으로 로그인해서 앱 연결 키 만들기를 누르고 키를 복사합니다 (한 번만 보입니다. 새로 만들면 예전 키는 못 씁니다).
  2. 앱의 녹음 서버… 버튼 → 사이트 주소(기본값 그대로)와 앱 연결 키를 넣고 불러오기.
  3. 녹음할 서버만 체크하고 저장. 끈 서버에서는 봇이 바로 나가고 더는 따라 들어가지 않습니다.
  • 켠 서버에서도 녹음에 동의하고 그 서버를 녹음할 서버로 고른 사람의 목소리만 녹음합니다 (각자 사이트에서 고름).
  • 사이트 주소와 키는 config\record-servers.json 에 저장됩니다.

목소리 모델 학습 — train.bat

동의 사이트 서버에서 학습 데이터를 꺼냅니다 (동의 중인 사람만 꺼내짐):

cd consent-recorder
npm run cli -- export <디스코드 아이디> ./dataset_<이름>   # 48kHz 모노 wav, -18 LUFS + 리미터

그 폴더를 게임PC 로 옮기고:

train.bat D:\dataset_승한 "승한" male
train.bat D:\dataset_지원 "지원" female --epochs 300
  • 순서: 자르기 → 음높이(rmvpe) · 특징(contentvec) 뽑기 → 학습(기본 200 epoch, batch 8) → 검색 인덱스 → models\<아이디>\ 에 넣기
  • 녹음은 최소 10분, 좋게는 20~30분. 10분보다 짧으면 경고하고, 1분보다 짧으면 학습하지 않습니다
  • export 결과가 아닌 녹음이면 --normalize 를 붙입니다. javis_bot · 겜녹이와 같은 기준(-18 LUFS + 리미터)으로 맞춥니다
  • 학습 중간 파일은 training\, 평준화한 녹음은 datasets\ 에 남습니다. 다 끝나면 지워도 됩니다

동의를 철회한 사람의 모델은 models\<아이디> 폴더와 training\<아이디> 폴더를 지웁니다. 녹음 서버의 녹음은 철회할 때 자동으로 지워지지만, 이 PC 에 옮긴 녹음 폴더와 모델은 직접 지워야 합니다.

한국어 예시 모델 — examples.bat

공개 데이터셋으로 예시 모델 4개를 이 PC 에서 학습합니다. RTX 5070 Ti 기준 몇 시간 걸리니 한 번만 돌리면 됩니다.

모델 데이터 라이선스
예시 여성 1 (KSS) KSS Dataset, 성우 1명, 44.1kHz → 48kHz 모델 CC BY-NC-SA 4.0 (비상업)
예시 남성 1 · 남성 2 · 여성 2 (Zeroth 화자 번호) Zeroth-Korean (OpenSLR 40), 16kHz → 32kHz 모델 CC BY 4.0
  • 화자마다 녹음 20분을 씁니다. KSS 는 약 540MB, Zeroth 는 10GB 압축 파일을 흘려 읽다가 필요한 화자가 모이면 멈춥니다
  • Zeroth 원본이 16kHz 라 Zeroth 예시는 KSS 예시보다 고음이 덜 또렷합니다
  • 실존 인물(연예인 등) 목소리 모델은 넣지 않았습니다. 예시도 데이터셋 라이선스 범위(비상업, 출처 표기) 안에서만 쓰세요

폴더

VoiceChanger.exe    실행기 (env\Scripts\pythonw.exe app\voice_changer.py 를 띄움, 소스 launcher\launcher.c)
install.bat         엔진 내려받기 · 이어 받기 (scripts\install.ps1, 설치 프로그램도 이것을 실행)
train.bat           학습 (app\train.py)
examples.bat        예시 모델 (app\examples.py)
app\                화면 · 학습 · 모델 목록 · 마이크 모듈 연결(mic_bridge.py) · 녹음 서버(record_servers.py) 코드
apo\                마이크 모듈 VoiceChangerAPO.dll 과 소스 (vcapo.cpp, 주고받는 규약 vccore.h) *
scripts\mic-apo.ps1 마이크 모듈 붙이기 · 떼기 (관리자) *
models\<아이디>\    model.pth · model.index · info.json(이름 · 성별 · 출처 · 라이선스)
config\             설정 · 마이크 모듈 백업
cache\              임시 파일 · torch · huggingface · matplotlib 등 라이브러리 캐시 (지워도 됨)
engine\ env\ tools\  설치하면 생기는 폴더 (엔진 · Python · uv)
uninstall\          제거 프로그램 *

* 표시는 설치 프로그램으로 설치하면 고른 폴더가 아니라 C:\Program Files\VoiceChanger 에 들어갑니다 (zip 으로 풀어 쓰면 같은 폴더).

배포 파일 만들기

voice-changer/scripts/build-release.sh   # 리눅스 mingw: VoiceChanger.exe · VoiceChangerAPO.dll 빌드 → dist/payload, dist/voice-changer-win.zip
powershell -ExecutionPolicy Bypass -File installer\build.ps1   # Windows + Inno Setup 6: dist\payload → dist\VoiceChangerSetup.exe

Inno Setup 은 리눅스 wine 에서 돌지 않아(32비트 프로그램이 wine wow64 에서 죽음) Windows 에서 빌드합니다.

테스트

python -m unittest discover -s voice-changer/tests   # 마이크 모듈 C 코드를 gcc 로 컴파일해 파이썬 쪽과 맞물려 봄 (soxr · numpy 필요)