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
- 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.
- Connect first: Plug in USB mic/interface BEFORE launching REW. REW enumerates devices at startup.
- 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. - 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. - REW Preferences → Soundcard: Select explicit input/output devices (never "Default Device"). Choose correct input channel, output channel, and timing reference channel if using loopback.
- 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.
- Buffers: If glitches/dropouts, increase buffer in Preferences → Soundcard. Java drivers allow input/output on different devices.
- Multichannel: If device exposes many channels, use Output Channel Mapping — physical connector order may not match REW labels.
- 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.
- 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?