- name
- protoss-voice
- description
- Generate Protoss-style (StarCraft) voice effects using SoX and FFmpeg.
- metadata
- {"clawdbot":{"emoji":"🔮","requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}}
# Protoss Voice Effect
Applies a "Khala" psionic transformation chain to audio files using the V9 "Massive Void" engine.
## Usage
Run the script on any audio file:
```bash
python3 skills/protoss-voice/protoss_fx.py <path_to_audio_file>
```
**Example:**
```bash
python3 skills/protoss-voice/protoss_fx.py recordings/my_voice.mp3
```
Files are saved as `*_psionic.mp3` in the source directory.
## Algorithm
The current architecture prioritizes a massive, distinctive spatial presence.
1. **Shadow Generation:** Pitch shift (-2 semitones) + Time stretch (0.9x).
2. **Void Layer:** Reverse -> Dense Reverb -> Reverse (creates "pre-verb" suction).
3. **Mastering:** Original voice is discarded. Bass boosted (+5dB), Subsonics cut (<100Hz).
## Integration Workflows
### ElevenLabs Post-Processing
This skill is designed to be used as a post-processing step for TTS generation.
When generating voice content to mimic "Selendis" or other Protoss personas:
1. **Generate:** Create raw speech using ElevenLabs.
2. **Process:** Pass the output file immediately through `protoss_fx.py`.
3. **Result:** Use the resulting `_psionic.mp3` file as the final asset.
## Requirements
Requires `ffmpeg` and `sox` (Sound eXchange).
```bash
brew install ffmpeg sox
```
## Agent Protocol
When a user requests audio or voice interaction involving a Protoss persona:
1. **Generate Raw Audio:** Use the `tts` tool to generate the base speech file.
2. **Silence:** Do NOT present the output path from the `tts` tool to the user yet.
3. **Process:** Execute the python script on the raw file:
`python3 skills/protoss-voice/protoss_fx.py <path_from_tts>`
4. **Deliver:** Use the `message` tool to send the file explicitly (more reliable than text echo):
`message(action="send", filePath="<path_from_script>", asVoice=true)`
GitHubで見る