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
🔧 サポートパラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
speed |
float | 話速 (1.0=標準, >1.0=速い) → edge-tts rate に自動変換 |
volume |
float | 音量倍率 → edge-tts volume に自動変換 |
model |
str | 音声名 (例: ja-JP-KeitaNeural) → edge-tts voice にマッピング |
extra.pitch |
str | ピッチ (例: +5Hz, -10Hz) |
extra.rate |
str | 話速の直接指定 (例: +50%, -20%)。speed変換より優先 |
extra.volume |
str | 音量の直接指定 (例: +100%)。volume変換より優先 |
extra.voice |
str | 音声名の直接指定。modelより優先 |
extra.proxy |
str | プロキシURL |
🗣️ 主な音声一覧
| 音声名 | 性別 | 言語 |
|---|---|---|
ja-JP-NanamiNeural |
女性 | 日本語 (デフォルト) |
ja-JP-KeitaNeural |
男性 | 日本語 |
en-US-EmmaMultilingualNeural |
女性 | 英語 (多言語対応) |
en-US-AndrewNeural |
男性 | 英語 |
全音声一覧: 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-bridgeCLI 後方互換維持- 全ユニットテスト 22件 パス
📜 ライセンス
MIT License
Metadata
Release files for tts-plugin-edgetts 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tts_plugin_edgetts-0.1.0.tar.gz | 116.5 kB | Without provenance | Details for tts_plugin_edgetts-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tts_plugin_edgetts-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for tts_plugin_edgetts-0.1.0-py3-none-any.whl |
Total release size: 122.2 kB
Release files / tts_plugin_edgetts-0.1.0.tar.gz
| Download URL | tts_plugin_edgetts-0.1.0.tar.gz |
|---|---|
| Size | 116.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a91916b4b5147d1db3a34990b20dcff68ad7a8b96b2e702460c4ddf3f3f0c2d
|
|
BLAKE2b-256 checksum How to use checksums |
f1d34be6a23f28d55fe7a7cd9097193d1be049b3d9fb0fc062c5b4a55761999a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Release files / tts_plugin_edgetts-0.1.0-py3-none-any.whl
| Download URL | tts_plugin_edgetts-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3a3bf393dc4fac3028339598a17802103cfd4d2967c82f1c6451b9a22f72892a
|
|
BLAKE2b-256 checksum How to use checksums |
37e98857e49521c7b2cb98ef5f9c0b2f9b13e4da0cecf441abe633a4b129bef7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Security for tts-plugin-edgetts 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.