tts-plugin-edgetts

Website • Report Bug • Contributing

🚀 Overview

edge-tts (Microsoft Edge TTS) を tts-plugin-bridge で利用するためのプラグインです。 APIキー不要で多言語対応のTTSが利用できます。

📦 インストール

uv add tts-plugin-bridge tts-plugin-edgetts

⚙️ 前提条件

• インターネット接続 (Microsoft Edge TTSサービスにアクセス)
• ローカルサーバー不要
• 再生には ffplay または paplay / aplay がPATHに存在すること
  • ffplay がある場合: ストリーミング再生（受信しながら即時再生）
  • ffplay がない場合: 全取得後に paplay / aplay で再生

🛠 Usage

🧩 Python API

from tts_plugin_bridge import TTSSkill

async with TTSSkill(default_engine="edgetts") as skill:
    # save / synthesize — ファイル保存やBase64取得用
    res = await skill.save(
        text="こんにちは、エッジティーティーエスのテストです。",
        speed=1.2,
        model="ja-JP-KeitaNeural",
    )

    # say / play — 直接再生（ffplayストリーミング → paplay/aplay）
    res = await skill.say(
        text="ストリーミングで即時再生します。",
        speed=1.0,
    )

🎤 CLI（vox4ai 推奨）

# 直接再生（自動ストリーミング）
vox4ai say "こんにちは" -e edgetts

# 男性声で再生
vox4ai say "こんにちは" -e edgetts --model ja-JP-KeitaNeural

# ファイル保存（MP3）
vox4ai save "こんにちは" -e edgetts -o output.mp3

# 環境診断
vox4ai --doctor

⌨️ CLI（tts-plugin-bridge 後方互換）

tts-plugin-bridge synthesize "こんにちは" -e edgetts -o output.mp3
tts-plugin-bridge play "こんにちは" -e edgetts
tts-plugin-bridge play "こんにちは" -e edgetts --model ja-JP-KeitaNeural

🔧 サポートパラメータ

🗣️ 主な音声一覧

全音声一覧: uv run edge-tts --list-voices

📁 出力フォーマット

MP3 (24kHz, 48kbps, mono)

🔍 検証環境

• OS: Windows 11 + WSL2 (Ubuntu)
• 確認日: 2026-05-09
• 依存: edge-tts v7.2.8, bridge / vox4ai CLI
• 確認内容:
  • vox4ai say によるストリーミング再生（ffplay 経由）
  • vox4ai save による MP3 ファイル保存
  • vox4ai --doctor 環境診断
  • tts-plugin-bridge CLI 後方互換維持
  • 全ユニットテスト 22件 パス

📜 ライセンス

MIT License