Audio Tools Suite

Professional macOS audio capture, routing, and processing tools built with Go.

🎯 Features

• Audio Jacking: Intercept and record audio from any macOS application
• Multi-Format Recording: WAV, MP3, AAC, FLAC, OGG support
• Real-time Audio Routing: Route audio between applications
• Audio Playback: Generate and play audio through system outputs
• CLI Interface: Powerful command-line tools for automation
• Audio Recovery: Recover corrupted audio files (proven in production)

🚀 Quick Start

# List available audio devices
./audio-tools list-devices

# Record audio from Zoom (or any app)
./audio-tools record --app "Zoom" --format wav --output zoom-call.wav

# Record system audio
./audio-tools record --device "BlackHole" --format mp3 --bitrate 320k

# Route audio from Safari to VLC
./audio-tools route --from "Safari" --to "VLC"

# Play test tone
./audio-tools play --frequency 440 --duration 5s

# Recover corrupted audio file
./audio-tools recover --input broken.m4a --output fixed.wav

📁 Project Structure

audio-tools/
├── src/                    # Core audio processing modules
│   ├── capture/           # Audio capture from apps/devices
│   ├── routing/           # Audio routing between sources
│   ├── formats/           # Audio format conversion
│   ├── recovery/          # Corrupted file recovery
│   └── playback/          # Audio generation/playback
├── cmd/                   # CLI commands
├── config/                # Configuration files
├── docs/                  # Documentation
├── tests/                 # Test suite
└── examples/              # Usage examples

🎛️ Audio Sources

Application Audio

• Zoom, Microsoft Teams, Discord
• Safari, Chrome, Firefox
• VLC, QuickTime, Spotify
• Any macOS application with audio output

System Audio Devices

• Built-in microphone
• External USB microphones
• Virtual audio devices (BlackHole, SoundFlower)
• Bluetooth audio devices

🔧 Technical Architecture

• Language: Go (Golang)
• Audio Framework: Core Audio (macOS)
• Formats: WAV, MP3, AAC, FLAC, OGG
• Real-time Processing: Low-latency audio capture
• Memory Efficient: Streaming audio processing

📊 Audio Quality

• Sample Rates: 8kHz - 192kHz
• Bit Depths: 16-bit, 24-bit, 32-bit
• Channels: Mono, Stereo, Multi-channel
• Compression: Lossless (WAV, FLAC) and Lossy (MP3, AAC, OGG)

🛠️ Installation

# Clone and build
git clone <repo-url>
cd audio-tools
go build -o audio-tools cmd/audio-tools/main.go

# Or install directly
go install github.com/yourusername/audio-tools@latest

📖 Examples

See the examples/ directory for detailed usage scenarios:

• Recording Zoom calls
• Creating audio loops
• Setting up audio routing
• Recovering corrupted files
• Batch audio processing

⚡ Performance

• Low CPU Usage: <5% for typical recording scenarios
• Memory Efficient: Streaming processing with minimal buffering
• Real-time: Sub-millisecond latency for routing operations
• Scalable: Handle multiple simultaneous audio streams

🔒 Privacy & Security

• All audio processing happens locally
• No network connections required
• No audio data sent to external services
• Full control over audio data and storage

🤝 Contributing

1. Fork the repository
2. Create feature branch
3. Add tests for new functionality
4. Submit pull request

📄 License

MIT License - see LICENSE file for details

---

Built with ❤️ for audio professionals and developers