Text-to-Speech & Audio

Make your Tux Droid talk and play music.

Text-to-Speech

How It Works

  • Windows: Uses built-in PowerShell Speech Synthesis (System.Speech) - no installation needed.
  • Linux: Uses espeak or espeak-ng. Install with: sudo apt install espeak

Basic Usage

bash
java -jar target/ScayTux.jar --say "Hello, I am Tux Droid!"

TTS includes organic lip sync - Tux's mouth moves naturally while speaking.

Available Voices

Voices are used internally by combos to create different character personalities:

VoiceDescription
NORMALDefault voice, standard speed and pitch
WHISPERQuiet and slow, great for secrets
ANGRYDeep pitch, fast and aggressive
CUTEHigh pitch, cheerful
SADDeep and slow, melancholic
ROBOTMonotone, mechanical
ANNOUNCERDeep and authoritarian

Audio Player

Supported Formats

  • MP3 - Primary format, decoded with JLayer
  • WAV / FLAC / M4A / AAC - Played via system audio player

Play Music with Dance

bash
java -jar target/ScayTux.jar --play assets/audio/billie.mp3

Tux automatically dances while the music plays, picking random dance moves.

Audio File Location

Place audio files in assets/audio/. The player searches in this order:

  1. Exact path as given
  2. Current directory
  3. assets/audio/ folder
  4. ../assets/audio/ folder

TuxDroid Audio Hardware (Windows)

On Windows, ScayTux automatically detects the TuxDroid-Audio USB device and routes audio through it. The audio is converted to 8-bit mono for hardware compatibility and maximum volume is set automatically.

If TuxDroid-Audio is not detected, playback falls back to the default system audio device.