VoiceLink - macOS Installation Guide

System Requirements

• macOS 10.14 or later
• Intel Mac or Apple Silicon (M1/M2/M3)
• 8GB RAM minimum (16GB recommended)
• 500MB available disk space

Download Options

Apple Silicon (M1/M2/M3) - Recommended

1. DMG Installer: VoiceLink-1.0.0-arm64.dmg (349MB)
2. ZIP Archive: VoiceLink-1.0.0-arm64-mac.zip (344MB)

Intel Mac

1. DMG Installer: VoiceLink-1.0.0.dmg (354MB)
2. ZIP Archive: VoiceLink-1.0.0-mac.zip (349MB)

Installation Methods

Method 1: DMG Installer (Recommended)

• Download the appropriate DMG file for your Mac
• Double-click the downloaded DMG file
• Drag VoiceLink to the Applications folder
• Eject the DMG by clicking the eject button in Finder
• Launch VoiceLink from Applications folder

Method 2: ZIP Archive

• Download the appropriate ZIP file for your Mac
• Extract the ZIP file to your desired location
• Move the VoiceLink.app to Applications folder (optional)
• Launch the application

First Launch

Gatekeeper Notice

On first launch, macOS may show a security warning:

• If you see "VoiceLink cannot be opened":

- Go to System Preferences → Security & Privacy

- Click "Open Anyway" next to the VoiceLink message

- Click "Open" in the confirmation dialog

• Alternative method:

- Right-click the app and select "Open"

- Click "Open" in the dialog

Microphone Permissions

VoiceLink requires microphone access:

• Grant permission when prompted
• If missed: Go to System Preferences → Security & Privacy → Privacy → Microphone
• Check the box next to VoiceLink

Audio Configuration

Recommended Audio Settings

• Open Audio MIDI Setup (found in /Applications/Utilities/)
• Select your audio interface
• Set Sample Rate to 48kHz or 44.1kHz
• Set Bit Depth to 24-bit or 16-bit

Professional Audio Interfaces

For best results with professional audio interfaces:

• Install manufacturer drivers before launching VoiceLink
• Configure buffer sizes in your audio interface control panel
• Use aggregate devices for multiple audio interfaces

Troubleshooting

App Won't Launch

• Check macOS version: Requires macOS 10.14 or later
• Verify architecture: Use ARM version for Apple Silicon, Intel version for Intel Macs
• Reset permissions: Try moving app to Trash and reinstalling

Audio Issues

• Check microphone permissions in System Preferences
• Verify audio interface is properly connected and recognized
• Try different sample rates in Audio MIDI Setup
• Restart audio services: sudo launchctl stop com.apple.audio.coreaudiod && sudo launchctl start com.apple.audio.coreaudiod

Performance Issues

• Close other audio applications that might conflict
• Increase buffer sizes in audio settings
• Check Activity Monitor for CPU/memory usage
• Restart the application if audio becomes glitchy

Uninstallation

• Quit VoiceLink completely
• Drag VoiceLink.app to Trash
• Remove preferences (optional):

rm -rf ~/Library/Preferences/com.voicelink.local.*
   rm -rf ~/Library/Application\ Support/VoiceLink\ Local/

Advanced Configuration

Custom Audio Device Configuration

VoiceLink supports advanced audio routing. See the main documentation for details on:

• Multi-channel audio setup
• VST plugin configuration
• 3D spatial audio settings
• Professional audio workflows

Command Line Options

Launch with custom settings:

/Applications/VoiceLink\ Local.app/Contents/MacOS/VoiceLink\ Local --audio-buffer=512 --sample-rate=48000

Support

For macOS-specific issues:

• Check Console.app for error messages
• Verify system requirements
• Review microphone and audio interface setup
• Consult the main troubleshooting guide in README.md