텍스트 음성 변환 (Reader + Editor)

Social Archiver는 타임라인 Reader Mode와 일반 Markdown 편집기에서 모두 사용할 수 있는 내장 TTS(Text-to-Speech)를 제공합니다.

개요

TTS는 두 곳에서 사용할 수 있습니다:

1. Reader Mode TTS: 타임라인 Reader Mode에서 아카이브된 포스트를 읽어주기
2. Editor TTS: Markdown 문서 전체 또는 선택 영역 읽어주기

요구사항

• TTS는 한 번에 하나의 Provider를 사용합니다: Azure Cloud 또는 Supertonic(온디바이스)
• Azure Cloud는 Social Archiver 계정 로그인 필요
• Supertonic은 데스크톱 전용이며 먼저 설치해야 함

기본 동작

Supertonic을 선택했지만 설치되지 않은 경우, 로그인 상태라면 Social Archiver가 자동으로 Azure로 fallback합니다.

Provider 옵션

Azure Cloud

• Social Archiver 백엔드 + Azure Speech 사용
• 로컬 모델 설치 불필요
• 로그인 필요
• 언어/보이스 범위가 넓음

Supertonic (온디바이스)

• 사용자 로컬 머신에서 직접 실행 (데스크톱 전용)
• 플러그인 설정 내 설치기(Installer) 제공
• 클라우드 음성 처리 없이 로컬 합성을 선호할 때 적합
• 지원 언어: en, ko, es, pt, fr

Supertonic Installer 가이드

설정 → Social Archiver → Text-to-Speech로 이동해 Provider를 Supertonic으로 바꾸세요.

Supertonic이 설치되지 않은 경우 설치 패널이 표시됩니다:

1. Install 클릭
2. 진행 메시지 확인 (runtime → models → voices → verify)
3. 완료 후 Reader 또는 Editor TTS에서 재생 시작

Installer가 수행하는 작업:

• 런타임 의존성 자동 설치
• ONNX 모델 및 voice style 파일 다운로드
• 설치 무결성 검증
• 설치 경로: ~/.social-archiver/tts/

사전 요구사항

Supertonic installer는 PATH에서 node와 npm을 확인합니다. 둘 중 하나라도 없으면 설치가 실패합니다.

설치 후에는 설정에서 다음 항목을 사용할 수 있습니다:

• Uninstall 버튼
• Synthesis quality (fast, balanced, high)
• 현재 설치 경로 표시

Reader Mode TTS

타임라인 Reader Mode에서 헤더의 스피커 버튼으로 읽기를 시작할 수 있습니다.

미니 컨트롤러 기능:

• 재생/일시정지
• 이전/다음 문장
• 속도 변경
• 정지
• 진행 상태 표시

키보드 단축키:

단축키	동작
P	재생 / 일시정지
Shift + Left	이전 문장
Shift + Right	다음 문장
[	속도 감소
]	속도 증가
Esc	읽기 중지

Editor TTS

명령 팔레트에서 다음 명령을 사용할 수 있습니다:

• Read document aloud (TTS)
• Read selection aloud (TTS)
• Pause / Resume reading (TTS)
• Stop reading (TTS)

편집기 컨텍스트 메뉴에도 다음 항목이 있습니다:

• Read selection aloud

TTS 설정

설정 → Social Archiver → Text-to-Speech에서 구성합니다:

설정	설명
TTS Provider	Azure Cloud 또는 Supertonic 선택
Speech speed	0.5x ~ 2.0x
Highlight current sentence	Reader Mode에서 현재 문장 하이라이트
Auto-scroll to sentence	읽는 동안 현재 문장을 자동으로 화면에 유지
Language	자동 감지 또는 언어 고정
Synthesis quality	Supertonic 전용 품질/속도 설정

언어 동작

• Supertonic은 제한된 언어 집합(en/ko/es/pt/fr)만 지원합니다
• Azure는 더 넓은 보이스 카탈로그를 지원합니다
• Supertonic이 기본 Provider일 때 Azure가 사용 가능하면, 미지원 언어는 Azure로 fallback할 수 있습니다

문제 해결

TTS가 시작되지 않음

• 설정에서 Provider 구성이 올바른지 확인
• Azure 사용 시 로그인 상태 확인
• Supertonic 사용 시 설치 완료 상태 확인

Supertonic 설치 실패

• node --version, npm --version 확인
• 설정에서 설치 재시도
• Windows에서 런타임 로드 오류가 나면 Microsoft Visual C++ Redistributable 설치

Reader 버튼은 보이는데 소리가 안 남

• Provider를 바꿔서 테스트 (Supertonic ↔ Azure)
• Language override를 auto-detect로 되돌림
• 읽기를 정지한 뒤 다시 시작

프라이버시

• Supertonic: 음성 합성이 로컬 머신에서 실행됩니다
• Azure: 인증된 Social Archiver 백엔드 세션을 통해 음성 합성을 요청합니다