여기서 시작하세요
TTS가 처음이라면 다음을 따르세요: 음성 읽기 설정 가이드. 5단계면 됩니다. 이 페이지는 전체 참조 문서입니다.
SSN은 텍스트로 캡처한 채팅을 읽습니다. 플랫폼 자체 TTS는 필요 없습니다. TTS가 켜진 Dock이나 오버레이가 자체 필터에 따라 읽습니다.
가장 간단한 링크는 시스템 음성으로 TTS를 켭니다:
dock.html?session=YOUR_SESSION&speech=en-US
OBS에는 페이지를 통해 재생하는 무료 음성을 추가하세요:
dock.html?session=YOUR_SESSION&speech=en-US&ttsprovider=piper
페이지를 열고 연결한 상태로 유지하세요. 한 페이지만 읽어야 합니다.
System TTS와 무료 TTS는 같은 것이 아닙니다. 시스템 음성은 브라우저와 컴퓨터에서 옵니다. Chrome에서 되어도 OBS에는 없는 경우가 많습니다. Kokoro, Piper, Kitten, eSpeak는 무료이며 자체 오디오를 만들어 OBS에서 작동합니다. OBS TTS에 돈을 낼 필요는 없습니다.
TTS는 다음에도 있습니다: CAPTION.Ninja에도 있으며 자막, 받아쓰기, 번역에 사용합니다. 둘 다 무료와 유료 음성을 제공합니다.
제공자
다음으로 제공자를 설정하세요: &ttsprovider=. 샘플을 듣고 비교하려면 다음을 보세요: 설정 가이드.
| 제공업체 | 링크 값 | 비용 | 참고 |
|---|---|---|---|
| 시스템 음성 읽기 | (기본값) | 무료 | 브라우저 음성. OBS에서는 무음인 경우가 많음. |
| Kokoro | kokoro | 무료 | 브라우저에서 실행. 최고의 무료 품질과 수십 가지 음성. |
| Piper | piper | 무료 | 브라우저에서 실행. 빠르고 CPU 부담이 적음. |
| Kitten | kitten | 무료 | 브라우저에서 실행. 작은 모델. |
| eSpeak-NG | espeak | 무료 | 고전적인 기계음. 모든 컴퓨터에서 작동합니다. |
| OpenAI | openai | API 비용 | 고품질. |
| 내 서버 | customtts 또는 localtts | 무료 | 모든 OpenAI 호환 서버. 참조: 로컬 TTS 가이드. |
| Google Cloud | google | API 비용 | 다국어. |
| Gemini | gemini | API 비용 | 읽는 방식에 대한 스타일 지시. |
| ElevenLabs | elevenlabs | 무료 등급 제공 | 자연스러운 음성, 사용자 음성 학습. |
| Speechify | speechify | API 비용 | 다국어. |
| Fish Audio | fish | 무료 모델 제공 | OBS에는 로컬 브리지가 필요합니다. |
System TTS를 제외한 모든 제공자는 페이지를 통해 오디오를 재생합니다. OBS에서는 다음만 켜세요: OBS를 통해 오디오 제어(Control audio via OBS).
링크 설정
Dock이나 오버레이 링크 끝에 추가하세요.
| 설정 | 역할 | 예시 |
|---|---|---|
&speech | 언어 코드와 함께 TTS를 켭니다. | &speech=en-US |
&ttsprovider | 제공자를 선택합니다(위 참조). | &ttsprovider=kokoro |
&volume | 음량, 0.0~1.0. | &volume=0.8 |
&rate | 읽기 속도, 0.1~10.0. | &rate=1.5 |
&pitch | 음높이, 0.1~2.0. | &pitch=1.2 |
&voice | 이름 일부로 시스템 음성을 선택합니다. | &voice=google |
&simpletts | 'says'나 'someone says'를 읽지 않습니다. | &simpletts |
&simpletts2 | 이름을 전혀 읽지 않습니다. | &simpletts2 |
&ttscommand | 명령으로 시작하는 메시지만 읽습니다(기본값 !say). | &ttscommand=!say |
&readevents | 구독과 후원 같은 이벤트도 읽습니다. | &readevents |
&skipmessages | N번째 메시지만 읽습니다. | &skipmessages=3 |
&ttsquick | 지정한 글자 수 이후 음성을 자릅니다. 메시지가 잘리면 제거하세요. | &ttsquick=100 |
제공자 설정
다음 뒤에 추가하세요: &ttsprovider=. 팝업에서 제공자를 고르면 같은 설정이 나옵니다.
| 제공업체 | 설정 |
|---|---|
| Kokoro | 음성 &voicekokoro=af_bella · 속도 &kokorospeed=1.2. 스페인어: ef_dora. 브라질 포르투갈어: pf_dora. 백그라운드 생성 옵션. |
| Piper | 음성 &pipervoice=en_US-hfc_female-medium · 속도 &piperspeed=1.0. 포르투갈어: pt_BR-faber-medium, pt_BR-edresson-low. 스페인어: es_ES-davefx-medium, es_MX-ald-medium. |
| Kitten | 음성 &kittenvoice=expr-voice-4-f. |
| eSpeak-NG | 음성 &espeakvoice=en · 속도 &espeakspeed=175. |
| OpenAI / 자체 서버 | 음성 &voiceopenai=nova · 속도 &openaispeed=1.0 · 서버 &openaiendpoint=http://localhost:8880/v1/audio/speech. 로컬 서버에는 키가 필요 없습니다. 모든 로컬 서버 설정. |
| Google Cloud | 키 &ttskey=YOUR_API_KEY · 음성 &voicegoogle=en-GB-Standard-A · 언어 &googlelang=en-US. |
| Gemini | 키 &geminikey=YOUR_API_KEY · 모델 &geminimodel=gemini-2.5-flash-preview-tts · 음성 &voicegemini=Kore · 언어 &geminilang=th-TH · 스타일 &geministyle=Read aloud in a warm tone. |
| ElevenLabs | 키 &elevenlabskey=YOUR_API_KEY · 음성 ID &voice11=YOUR_VOICE_ID · 모델 &elevenlabsmodel=eleven_multilingual_v2. 안정성, 유사성, 스타일도 조절할 수 있습니다. |
| Speechify | 키 &speechifykey=YOUR_API_KEY · 음성 &voicespeechify=henry · 모델 &speechifymodel=simba-3.0 (기본값) 또는 simba-3.2 은 영어 · 속도 &speechifyspeed=1.2 (0.5~3.0). Speechify 가이드. |
| Fish Audio | API 키와 선택적 음성 ID. 기본 모델 s2.1-pro-free. 설정과 OBS 브리지. |
언어에 맞는 음성을 고르세요. 변경해도:
&speech= 만으로 음성은 바뀌지 않습니다. 기존 영어 음성 ID도 계속 작동합니다.스페인어 및 포르투갈어 완성 링크
| 언어 | 최고 무료 품질(테스트됨) | 가장 빠른 대체 수단(테스트됨) |
|---|---|---|
| 포르투갈어 | &speech=pt-BR&ttsprovider=piper&pipervoice=pt_BR-faber-medium | &speech=pt-BR&ttsprovider=espeak&espeakvoice=pt-br |
| 스페인어 | &speech=es-ES&ttsprovider=piper&pipervoice=es_ES-davefx-medium | &speech=es-ES&ttsprovider=espeak&espeakvoice=es |
Kokoro도 작동합니다: &voicekokoro=ef_dora (스페인어) 또는 pf_dora (브라질 포르투갈어). 클라우드 음성은 Google Cloud, ElevenLabs, Speechify, Gemini 또는 OpenAI 호환 로컬 서버에서 언어를 지원하는 음성을 고르세요.
시스템 음성
System TTS는 브라우저와 컴퓨터의 음성을 사용합니다. 아래는 일반적인 예이며 보장되지는 않습니다.
| 브라우저 | 시스템 음성 |
|---|---|
| Chrome | 가능. Google 음성과 시스템 음성. |
| Edge | 가능. Microsoft 음성과 Windows 언어 팩. |
| Firefox | 제한적. 로컬 시스템 음성만 지원. |
| Opera | 제한적. 설치 환경에 따라 다름. |
| Safari | 오디오 재생 전에 클릭이 필요합니다. |
| OBS | 자체 브라우저입니다. Chrome이나 Edge의 음성을 받지 않습니다. SSN 앱 테스트는 OBS 테스트가 아닙니다. |
이 브라우저의 시스템 음성 확인. 연 브라우저의 System TTS 음성만 나열합니다. OBS나 Kokoro 같은 제공자는 테스트하지 않습니다. 목록이 비어도 다른 제공자가 작동하지 않는다는 뜻은 아닙니다.
Windows에 음성 추가
- 열기 시작 > 설정 > 시간 및 언어 > 음성.
- 다음 항목 아래에서: 음성 관리에서 다음을 클릭하세요: 음성 추가.
- 언어를 고르고 다음을 클릭하세요: 추가:.
- 브라우저를 재시작하세요.
Windows 11 설명입니다. Windows 10은 다음을 보세요: Microsoft 가이드. 일부 타사 음성은 브라우저에 나타나지 않습니다. Firefox는 Chrome 계열보다 더 많은 시스템 음성을 표시하는 경우가 있습니다.
System TTS를 OBS로 보내기
다른 제공자를 쓴다면 이 과정은 필요 없습니다. 다음을 켜세요: OBS를 통해 오디오 제어(Control audio via OBS) 을 브라우저 소스에서 켜세요. 가상 케이블은 필요 없습니다.
- 먼저 System TTS가 실제로 말하는지 확인하세요. OBS에는 사용 가능한 음성이 없을 수 있습니다. 소리가 생성되지 않으면 라우팅으로 해결할 수 없으므로 다른 제공자를 쓰세요.
- 다른 브라우저에서 소리가 나면 OBS 앱 오디오나 데스크톱 오디오 캡처로 해당 브라우저를 캡처하세요.
- 해결되지 않으면 아래의 가상 오디오 케이블로 브라우저를 연결하세요.
가상 케이블로 오디오 보내기(Windows)
다운로드: VB-Audio Virtual Cable (무료) · Voicemeeter · Audio Router (레거시)
| 방식 | 할 작업 |
|---|---|
| PC 전체 | 설정: CABLE Input 을 Windows 기본 출력으로 설정하세요(소리 설정 > 출력). |
| 앱 하나, Windows 11 | 설정 > 시스템 > 소리 > 볼륨 믹서. 브라우저 출력을 다음으로 설정하세요: CABLE Input. |
| 앱 하나, Windows 10 | 소리 설정 > 앱 볼륨 및 장치 기본 설정. 브라우저 출력을 다음으로 설정하세요: CABLE Input. |
| Audio Router | 오래된 소프트웨어입니다. 브라우저를 다음으로 보내세요: CABLE Input. |
| Voicemeeter | Windows 기본 출력으로 설정하세요. 하드웨어 출력은 스피커로, 가상 출력은 OBS로 보내세요. |
그다음 OBS에서 추가하세요: 오디오 입력 캡처에서 다음을 고르세요: CABLE Output (또는 Voicemeeter 출력)을 고르고 모니터링을 다음으로 설정하세요: 모니터링 및 출력. 사용: 모니터링만 을 다른 소스가 이미 방송에 보내고 있을 때 설정하세요.
TTS를 재생하고 OBS 미터와 실제 소리를 확인한 뒤 음량을 조절하세요.
문제 해결
| 문제 | 시도할 방법 |
|---|---|
| 소리가 나지 않습니다. | TTS가 켜져 있고 읽는 페이지가 열려 있으며 브라우저 소스가 음소거되지 않았는지 확인하세요. 일반 브라우저에서는 페이지를 한 번 클릭하세요. |
| OBS에서 무음 | 전혀 말하지 않으면 제공자부터 확인하세요. 소리가 나면 다음을 확인하세요: OBS를 통해 오디오 제어(Control audio via OBS), 믹서 음소거, 출력 트랙을 확인하세요. 또는 읽고 있는 브라우저를 캡처하세요. |
| 클라우드 음성이 작동하지 않음 | API 키와 제공자 이름을 확인하세요. 키가 없으면 SSN은 System TTS로 돌아가며 OBS에서는 무음일 수 있습니다. |
| 로컬 서버가 앱에서는 되지만 OBS에서는 안 됨 | OBS는 별도 브라우저입니다. OBS 컴퓨터에서 서버를 확인하세요. 특히 다음을 쓸 때: 127.0.0.1. 참고: localhost 규칙. |
| 첫 글자나 단어만 읽음 | 제거 ttsquick 을 OBS 링크에서 제거하세요. |
| 새 음성이 나타나지 않음 | 언어 팩을 추가한 뒤 브라우저를 재시작하세요. |
| Safari가 읽지 않음 | Safari는 자동 TTS가 제한적입니다. 페이지를 한 번 클릭해 오디오를 허용하세요. |
사용 습관
- 페이지에서 재생하는 제공자를 쓰세요. 가장 쉬운 OBS 설정이며 무료 선택지도 있습니다.
- 방송 전에 짧은 메시지로 시험하세요.
- 시청자는 무엇이든 입력할 수 있습니다. TTS를 빠르게 끌 수 있게 준비하세요.