Install on macOS

Before you begin

• An Apple silicon Mac (M-series) with administrator access.
• The Mac must be on the same network as your scanner (Uniden SDS200 or compatible).
• Your license key — or start without one and use the built-in trial window.

Install

1. Download ToneOut-macos-arm64.pkg with the button above and open it.
2. Follow the installer prompts (you’ll be asked for your administrator password).
3. When installation finishes, ToneOut sets itself up in the background: the first start creates a small virtual machine and downloads the ToneOut server — this takes a few minutes, one time only.
4. Your browser opens http://localhost:6080 automatically when the server is ready. If it doesn’t, open that address yourself.
5. Finish in the browser: create your admin account, enter your scanner’s IP address, and paste your license key under Settings → License.

“Cannot be opened because it is from an unidentified developer”? Right-click the .pkg and choose Open, or allow it under System Settings → Privacy & Security → Open Anyway.

Good to know

• ToneOut starts automatically whenever you log in to this Mac.
• If Docker Desktop is already installed and running, ToneOut uses it; otherwise it uses the lightweight container engine bundled with the installer.
• Recordings are saved to ~/ToneOut/Recordings; logs to ~/Library/Logs/ToneOut.
• Control it from Terminal if you ever need to: /usr/local/toneout/bin/toneout-ctl start|stop|status|update|open.

Updating

/usr/local/toneout/bin/toneout-ctl update

Your settings, database and recordings are kept across updates.

Uninstalling

1. Open Terminal and run:

   sudo /usr/local/toneout/bin/uninstall.sh

2. Enter your administrator password when asked.

This stops the server, removes the login item and deletes the program files. It keeps your recordings (~/ToneOut/Recordings) and your settings and database, and it leaves Podman / Docker installed since other apps may use them.

To erase everything — settings, database (including your license key), recordings and logs — also run:

podman volume rm toneout-config toneout-data
rm -rf ~/ToneOut/Recordings ~/Library/Logs/ToneOut

Using Docker instead of the bundled engine? Swap the first line for docker volume rm toneout-config toneout-data. If Podman says its machine isn’t running, start it first with podman machine start — and if nothing else on this Mac uses Podman, podman machine rm afterwards reclaims the virtual machine’s disk space.