callmac – OpenClaw Skill

---

name: callmac description: Remote voice control for Mac from mobile devices using commands like /callmac or /voice. Broadcast announcements, play alarms, tell stories, wake up kids - all triggered from Telegram/WhatsApp messages. Uses edge-tts with mixed Chinese/English support, local playback, loops, and volume control. | 从移动设备通过 /callmac 或 /voice 命令远程控制 Mac 语音功能。广播公告、播放闹钟、讲故事、叫孩子起床 - 全部通过 Telegram/WhatsApp 消息触发。使用 edge-tts 支持中英文混合、本地播放、循环播放和音量控制。

Callmac Skill

Remote voice control for your Mac from mobile devices. Broadcast announcements, play alarms, tell stories, wake up kids - all triggered from messaging apps like Telegram or WhatsApp. Uses edge-tts with mixed Chinese/English support.

从移动设备远程控制 Mac 语音功能。广播公告、播放闹钟、讲故事、叫孩子起床 - 全部通过 Telegram 或 WhatsApp 触发。使用 edge-tts 支持中英文混合。

Quick Start | 快速开始

快速开始使用语音技能，生成和播放中英文混合的 TTS 音频。

Basic Usage | 基本用法

# Generate and play a simple announcement
python3 scripts/generate_tts.py --text "Hello world" --play

# Generate mixed Chinese/English content
python3 scripts/generate_tts.py --text "Hello 你好" --play

# Save to file
python3 scripts/generate_tts.py --text "Your message" --output announcement.mp3

Voice Selection

Edge TTS provides high-quality neural voices:

• English (US): en-US-JennyNeural (friendly), en-US-AriaNeural (confident)
• Chinese (Mandarin): zh-CN-XiaoxiaoNeural (warm), zh-CN-XiaoyiNeural (lively)
• Other languages: See VOICES.md for complete list

Features

1. Mixed Language Support

Automatically detects language segments and uses appropriate voices:

• English segments → English neural voice
• Chinese segments → Chinese neural voice
• Other languages → Default or specified voice

2. Playback Control

• Local playback on Mac using afplay
• Loop playback support (1-∞ times)
• Volume control (0-100%)
• Background/foreground playback options

3. File Management

• Save as MP3 files
• Concatenate multiple audio segments
• Batch processing support

4. Advanced Features

• Custom voice selection per segment
• Speech rate adjustment
• Pitch modification
• SSML support for advanced control

Workflows

Workflow 1: Simple Announcement Playback

1. User provides text to speak
2. System detects language(s)
3. Generates appropriate TTS audio
4. Plays locally on Mac

Workflow 2: Mixed Language Audio Creation

1. User provides Chinese/English mixed text
2. System splits by language segments
3. Generates separate audio for each language
4. Concatenates into single MP3 file
5. Optionally plays or saves

Workflow 3: Scheduled/Repeated Announcements

1. User provides text and playback schedule
2. System creates cron job or loop
3. Plays at specified intervals
4. Can be stopped on demand

Scripts

scripts/generate_tts.py

Main script for TTS generation and playback.

Usage:

# Basic generation and playback
python3 generate_tts.py --text "Message" --play

# Save to file
python3 generate_tts.py --text "Message" --output file.mp3

# Mixed language with custom voices
python3 generate_tts.py --text "Hello 你好" --voice-en "en-US-AriaNeural" --voice-zh "zh-CN-XiaoyiNeural"

# Loop playback
python3 generate_tts.py --text "Message" --play --loops 5

# Volume control
python3 generate_tts.py --text "Message" --play --volume 80

# SSML support
python3 generate_tts.py --ssml "<speak>Hello <break time='500ms'/> world</speak>"

Parameters:

• --text: Text to convert to speech
• --ssml: SSML markup for advanced control
• --output: Save to MP3 file
• --play: Play immediately after generation
• --voice: Default voice (overrides auto-detection)
• --voice-en: English voice override
• --voice-zh: Chinese voice override
• --loops: Number of times to play (default: 1)
• --volume: Playback volume 0-100 (default: system volume)
• --rate: Speech rate adjustment (+/- %)
• --pitch: Pitch adjustment (+/- Hz)

scripts/play_audio.py

Audio playback control utilities.

Usage:

# Play existing audio file
python3 play_audio.py --file audio.mp3

# Loop playback
python3 play_audio.py --file audio.mp3 --loops 3

# Volume control
python3 play_audio.py --file audio.mp3 --volume 75

# Stop all playback
python3 play_audio.py --stop

scripts/merge_audio.py

Merge multiple audio files.

Usage:

# Merge two files
python3 merge_audio.py --files part1.mp3 part2.mp3 --output combined.mp3

# Create playlist and merge
python3 merge_audio.py --playlist playlist.txt --output combined.mp3

References

VOICES.md

Complete list of available Edge TTS voices with language, gender, and style information.

INSTALLATION.md

Setup instructions for edge-tts and ffmpeg dependencies.

EXAMPLES.md

Example usage patterns and common scenarios.

Dependencies

1. edge-tts: pip3 install edge-tts
2. ffmpeg: brew install ffmpeg (for audio merging)
3. macOS tools: afplay (built-in), osascript (volume control)

Common Patterns

Pattern 1: Welcome Message

python3 scripts/generate_tts.py --text "Welcome to the system. 系统欢迎您。" --play --voice-en "en-US-JennyNeural" --voice-zh "zh-CN-XiaoxiaoNeural"

Pattern 2: Scheduled Reminder

# Create audio file
python3 scripts/generate_tts.py --text "Time for your meeting. 会议时间到了。" --output reminder.mp3

# Schedule playback (using cron)
echo "*/30 * * * * afplay /path/to/reminder.mp3" | crontab -

Pattern 3: Multi-language Announcement

python3 scripts/generate_tts.py --text "Alert: System update in progress. 警报：系统更新进行中。" --play --loops 3 --volume 90

Troubleshooting

No Audio Output

1. Check system volume: osascript -e "output volume of (get volume settings)"
2. Check mute status: osascript -e "output muted of (get volume settings)"
3. Test with simple audio: afplay /System/Library/Sounds/Ping.aiff

edge-tts Not Working

1. Verify installation: python3 -m edge_tts --list-voices
2. Check internet connection (edge-tts requires online access)
3. Update package: pip3 install --upgrade edge-tts

Audio Quality Issues

1. Use neural voices for best quality
2. Adjust speech rate if too fast/slow
3. Consider SSML for precise control

Notes

• Edge TTS requires internet connection for voice synthesis
• Local playback uses macOS built-in afplay command
• Volume control uses osascript to adjust system volume
• For offline use, consider alternative TTS solutions
• Large texts may be split into multiple segments automatically

Callmac Skill | 远程 Mac 语音控制

Remote voice control for your Mac from mobile devices. Broadcast announcements, play alarms, tell stories, wake up kids - all triggered from messaging apps.

从移动设备远程控制 Mac 语音功能。广播公告、播放闹钟、讲故事、叫孩子起床 - 全部通过即时通讯应用触发。

Quick Start | 快速开始

# Install dependencies
pip3 install edge-tts
brew install ffmpeg

# Make scripts executable
chmod +x scripts/*.py

# Test the skill
python3 scripts/generate_tts.py --text "Hello 你好" --play

Features | 功能特性

• 🎯 Mixed Language Support: Auto-detects Chinese/English and uses appropriate voices
• 🎵 High Quality Voices: Uses Microsoft Edge neural TTS voices
• 🔊 Local Playback: Plays directly on Mac using afplay
• 🔁 Loop Playback: Supports repeated playback (1 to infinite loops)
• 📊 Volume Control: Adjust system volume during playback
• 💾 File Export: Save generated audio as MP3 files
• 🔗 Audio Merging: Combine multiple audio segments
• ⏰ Scheduling: Integrate with cron for scheduled announcements

Usage Examples | 使用示例

Basic Announcement

python3 scripts/generate_tts.py --text "System ready" --play

Mixed Language

python3 scripts/generate_tts.py --text "Hello 你好" --play

Custom Voices

python3 scripts/generate_tts.py \
  --text "Welcome 欢迎" \
  --play \
  --voice-en "en-US-AriaNeural" \
  --voice-zh "zh-CN-XiaoyiNeural"

Loop Playback

python3 scripts/generate_tts.py --text "Reminder" --play --loops 3 --volume 80

Save to File

python3 scripts/generate_tts.py --text "Announcement" --output announcement.mp3

Scripts | 脚本说明

• generate_tts.py - Main TTS generation and playback script
• play_audio.py - Audio playback control utilities
• merge_audio.py - Merge multiple audio files

Integration with Clawdbot

This skill can be integrated into Clawdbot workflows:

1. Heartbeat checks: Play audio notifications during periodic checks
2. Event triggers: Play announcements based on system events
3. Scheduled tasks: Use with cron for regular announcements
4. User interactions: Respond to user requests with voice output

Dependencies

• Python 3.8+
• edge-tts Python package
• ffmpeg (for audio merging)
• macOS afplay and osascript commands

Installation

See references/INSTALLATION.md for detailed setup instructions.

Voice Selection

See references/VOICES.md for complete voice list and recommendations.

Examples

See references/EXAMPLES.md for comprehensive usage examples and patterns.

License

MIT License