Troubleshooting on macOS
Periscopes quits right after opening
Section titled “Periscopes quits right after opening”It isn’t in the Applications folder. Periscopes shows an alert and quits when it runs from anywhere else, including straight from the disk image. Drag it into Applications and open it from there.
Setup is stuck waiting for approval
Section titled “Setup is stuck waiting for approval”macOS blocks the network extension until you allow it. Open System Settings → General → Login Items & Extensions → Network Extensions and turn on Periscopes. The setup guide’s Open System Settings button takes you there.
The menu bar says “Proxy unreachable”
Section titled “The menu bar says “Proxy unreachable””The extension is on, but nothing answers at the proxy address. Your connections are going straight out, uninspected. Check that the Periscopes proxy background service is running, and that the address in the Periscopes window matches it (127.0.0.1:8089 by default).
Check the extension’s state
Section titled “Check the extension’s state”systemextensionsctl listLook for io.riptides.workstation.network-extension. A working install shows it as [activated enabled].
Read the logs
Section titled “Read the logs”Periscopes and its extension log to the macOS unified log:
log stream --level debug --predicate 'subsystem BEGINSWITH "io.riptides.workstation"'Each connection gets a tag such as [0042] on all of its log lines, from “Saw flow” to “Closing flow”, so you can follow one connection through.