Lesson 02 / Setup

macOS Setup & Audio I/O Done Right

REW on Mac uses Java drivers only. No ASIO. No WASAPI exclusive. Get this wrong and every measurement is suspect.

Purpose

Valid measurements require correct sample rate, bit depth, device selection, permissions, and levels before you press Measure. On macOS, Audio MIDI Setup is the master — REW follows it.

Numbered Workflow

  1. Install: Download macOS REW (includes private JRE). No separate Java needed. Do NOT install headless JRE. Requires macOS 10.15+, 1024×768 min, 4GB RAM recommended.
  2. Connect first: Plug in USB mic/interface BEFORE launching REW. REW enumerates devices at startup.
  3. Fix permissions proactively: If mic fails, in Terminal before starting REW: tccutil reset Microphone → restart REW → approve prompt. Also check System Settings → Privacy & Security → Microphone.
  4. Audio MIDI Setup (critical): Open /Applications/Utilities/Audio MIDI Setup → select interface → set Sample Rate 44.1 or 48kHz and 24-bit. REW volume controls are disabled on macOS — set levels here or on hardware mixer.
  5. REW Preferences → Soundcard: Select explicit input/output devices (never "Default Device"). Choose correct input channel, output channel, and timing reference channel if using loopback.
  6. Sample rate match: In REW, select 44.1/48kHz. Must match Audio MIDI Setup. Changing rate requires recalibration. V5.30+ allows up to 1536kHz on Mac, but >192kHz is hardware-dependent and pointless for acoustics.
  7. Buffers: If glitches/dropouts, increase buffer in Preferences → Soundcard. Java drivers allow input/output on different devices.
  8. Multichannel: If device exposes many channels, use Output Channel Mapping — physical connector order may not match REW labels.
  9. MIDI warning: MIDI port selection is DISABLED by default on macOS (can crash JRE). Only enable in Preferences → Comms if you accept risk. RS232/TAG McLaren serial = Windows 32-bit only.
  10. Verify: Bottom of REW window shows rate/bit depth. Level Meters show RMS/peak. Captured graph shows sweep vs recorded signal.

✅ Do

  • Set rate in Audio MIDI Setup first
  • Use explicit device names
  • Use 44.1/48kHz for acoustics
  • Keep logs at ~/Library/Logs/REW

❌ Don't

  • Leave as Default Device
  • Expect ASIO on Mac
  • Enable MIDI blindly
  • Change rate without recalibrating

Outputs & What They Mean

  • Status bar: Confirms actual rate/bit depth in use. If it doesn't match Audio MIDI Setup, quit and fix AMS first.
  • Level Meters: Input RMS -30 to -12 dBFS healthy. Headroom green 6–40dB. Red = clipping = corrupt measurement.
  • Captured graph: Shows generated sweep vs uncorrected capture. Use to diagnose latency, polarity inversion, or missing signal.
Deeper Detail — Drivers, Logs & API

Drivers: macOS = Java drivers only, 24/32-bit if interface offers it. No exclusive mode. Input/output can be different devices (unlike WASAPI exclusive).

Preferences location: ~/Library/Preferences/com.apple.java.util.prefs.plist (not registry).

Logs: ~/Library/Logs/REW plus /temp subfolder with 7 days of temp measurement copies.

API: open -a REW.app --args -api (default port 4735, localhost only). Custom port: -api -port 4567. GET available; PUT/POST and automated sweeps require Pro upgrade.

UI: Use Command/Option for shortcuts. "Use macOS file dialogs" exists but lacks preview and occasionally fails to appear — fall back to Java chooser.

Check Your Understanding

Client's Mac shows REW at 48kHz but Audio MIDI Setup is at 44.1kHz. Measurements sound glitchy. Fix?