Pywayne TTS

Text-to-speech (TTS) tool that converts text to audio files (opus or mp3 format).

Functions

text_to_speech_output_opus - Convert text to Opus format

from pywayne.tts import text_to_speech_output_opus

# Output: test.opus
text_to_speech_output_opus("你好，世界", "test.opus")

Parameters:

• •text - Text to convert
• •opus_filename - Output .opus filename
• •use_say - If True, use macOS 'say' command; otherwise use gTTS (default True)

Behavior:

• •On macOS, prefers native 'say' command when use_say=True
• •On other platforms, uses Google TTS (gTTS) service
• •Uses ffmpeg to convert audio to opus format (16kHz, mono channel)
• •Automatically cleans up temporary files

text_to_speech_output_mp3 - Convert text to MP3 format

from pywayne.tts import text_to_speech_output_mp3

# Output: test.mp3
text_to_speech_output_mp3("你好，世界", "test.mp3")

Parameters:

• •text - Text to convert
• •mp3_filename - Output .mp3 filename
• •use_say - If True, use macOS 'say' command; otherwise use gTTS (default True)

Behavior:

• •On macOS, prefers native 'say' command when use_say=True
• •On other platforms, uses Google TTS (gTTS) service
• •Uses ffmpeg to convert audio to mp3 format
• •Automatically cleans up temporary files

Quick Start

# Convert text to Opus format (default: macOS uses 'say')
text_to_speech_output_opus "你好，世界" "test.opus"

# Convert text to MP3 format
text_to_speech_output_mp3 "你好，世界" "test.mp3"

# Force use gTTS instead of macOS 'say'
text_to_speech_output_mp3 "你好，世界" "test.mp3" use_say=False

Requirements

• •ffmpeg: Required for audio conversion
  • •macOS: brew install ffmpeg
  • •Windows: Download from https://ffmpeg.org and add to PATH
  • •Linux: sudo apt install ffmpeg or package manager
• •gtts: Python library for Google TTS service

Platform Detection

Module automatically detects platform and prompts for ffmpeg installation if missing.

Audio Formats

• •Opus: Better quality, smaller file size, suitable for voice calls
• •MP3: Better compatibility, suitable for multimedia playback

Notes

• •Requires network connection for gTTS service
• •Temporary files are automatically cleaned up
• •Ensure output directory has write permissions