Troubleshooting¶

Permission states and grants live on their own page: Permissions.

rex doctor¶

[ok]   Config ~/.config/rex/config.toml
[ok]   Meetings folder ~/Meetings: 12 meeting(s), 168 GB free
[ok]   Speech recognition model parakeet-tdt-0.6b-v2 downloaded (464 MB)
[warn] System Audio Recording: Cannot be checked
     ↳ Cannot be queried; run `rex devices --probe 3` or Settings › Permissions › Run Test
[ok]   Microphone Elgato Wave:3
[ok]   rex:// opens /Applications/Rex.app

rex doctor --probe adds the system-audio tone test. Exit code 1 means something marked [FAIL].

Common problems¶

The system track is silent. System Audio Recording was not granted to this binary (the app and the CLI are separate grants), or nothing was playing. rex devices --probe 5 while audio plays.

My own words appear on the "them" side / the others appear on mine. Echo: increase micDelayMs in steps of 50 (Re-transcribe sheet). Headphones remove the problem entirely.

No meeting prompt appears. Detection needs the app to capture the mic for 8 s; check ~/Library/Logs/Rex/rex.log for [detection] lines. Generic notification sounds never trigger it.

The prompt shows the app name instead of the meeting title. Accessibility is not granted, or useWindowTitles = false, or the app exposes no usable window title.

A workflow "is not found". Use an absolute path or put it in ~/bin, ~/.local/bin, /opt/homebrew/bin or /usr/local/bin; chmod +x it. rex doctor checks every enabled workflow.

Transcription failed. pipeline.log in the meeting folder has the stage and the error; the recording is untouched and Re-transcribe retries.

A recording was interrupted. The next launch recovers the fragmented file, marks the meeting recovered and transcribes it.

Logs¶

~/Library/Logs/Rex/rex.log (rotating, 5 × 5 MB) at [general] logLevel; debug shows every detector poll, bus decision and retention skip.