rany2/edge-tts

edge‑tts – Microsoft Edge 클라우드 TTS용 Python 래퍼

정의 – Microsoft Edge 브라우저에서 사용하는 텍스트 음성 변환 서비스를 호출할 수 있는 작은 Python 패키지입니다. 코드에서 라이브러리로 사용하거나 두 가지 명령줄 도구를 통해 사용할 수 있습니다.

• edge-tts – 일반 텍스트에서 오디오(및 선택적 자막 파일)를 생성합니다.
• edge‑playback – mpv 플레이어를 사용하여 음성을 생성하고 즉시 재생합니다(Windows에서는 내장 플레이어 사용).

중요성 – Azure 자격 증명 없이 무료로 고품질 신경망 음성(수백 개 언어/억양)을 제공합니다. 패키지는 HTTP 호출, 음성 선택, 속도, 볼륨, 피치와 같은 선택적 조정을 처리합니다.

설치

# 라이브러리 + CLI
pip install edge-tts
# 또는 CLI 도구만 필요하고 격리를 원하는 경우
pipx install edge-tts

일반적인 명령줄 사용법

# MP3 및 SRT 자막 파일 저장
edge-tts --text "Hello, world!" \
          --write-media hello.mp3 \
          --write-subtitles hello.srt

# 즉시 재생(Linux/macOS에서는 mpv 필요)
edge-playback --text "Hello, world!"

edge-tts --list-voices로 사용 가능한 모든 음성을 나열하고 --voice <voice-id>로 선택할 수 있습니다.

음성 제어 – 서비스는 많은 음성(예: ar-EG-SalmaNeural)을 제공합니다. README에는 음성 이름, 성별, 콘텐츠 범주, 성격 태그 표가 나와 있습니다.

오디오 조정 – CLI에서 직접 음성 특성을 조정합니다.

• --rate <pct> – 속도(예: --rate=-50%).
• --volume <pct> – 볼륨.
• --pitch <Hz> – 피치 이동. 음수 값은 플래그로 구문 분석되지 않도록 --rate=-50%처럼 따옴표로 묶어야 합니다.

진행률 피드백 – 대화형 터미널에서 실행하면 tqdm 스타일 진행률 표시줄이 수신된 오디오 양을 표시합니다. 억제하려면 --no-progress를 사용하세요.

라이브러리로 사용 – Python에서 edge_tts를 가져와 비동기 API를 호출합니다. 리포지토리의 examples/ 폴더와 src/edge_tts/util.py 헬퍼에 예제 진입점이 제공됩니다.

실제 사용 사례 – 이 패키지는 다음에서 사용됩니다.

• Home Assistant의 hass-edge-tts 통합.
• 팟캐스트 내레이션 생성을 위한 Podcastfy 프로젝트.
• 음성 선택용 MP3 샘플 모음인 tts-samples.

결론 – edge‑tts는 Azure 인증을 처리하지 않고 음성 출력이 필요한 스크립트, 봇, 홈 자동화 또는 모든 Python 프로젝트에 유용한 실용적이고 비용이 들지 않는 Microsoft 신경망 TTS 브리지입니다.