Support

Help with setting up and using Sipper. If the answer isn't here, open a GitHub issue.

Get in touch

Open a GitHub issue. To get to an answer quickly, include:

• your macOS version and Sipper version (Sipper › About Sipper)
• what you expected to happen, and what happened instead
• for problems registering or making calls, a log: reproduce the problem, then choose Save in Settings › Diagnostics

GitHub issues are public. Logs can include account names, server addresses, phone numbers and authentication details. Remove those before attaching a log; never post passwords or account exports. Bug reports and feature requests are also welcome as GitHub issues.

Requirements

Mac

Apple silicon (M1 or later)

macOS

14 Sonoma or later

Phone service

A SIP account from a phone provider or your organisation's phone system (PBX)

Installing and updating

1. Download Sipper from sipper.dev/download.
2. Open the disk image and drag Sipper into the Applications folder.
3. Open Sipper from Applications. The first time, macOS asks you to confirm opening an app downloaded from the internet.

To update, download the latest version and replace the copy in Applications. Your accounts, contacts and history are kept. Every version is listed on GitHub.

Adding your SIP account

Your provider or IT team gives you these details. They go by different names, so alternatives are in brackets.

Username

Often your extension number (SIP user, extension). If you're also given an authentication username, enter that too.

Password

Your SIP password (secret), not the password for your provider's website.

Domain

The part after the @ in your SIP address (SIP domain, realm).

Server

Only needed if it's different from the domain (registrar, proxy, outbound proxy).

Port and transport

UDP on port 5060 unless you're told otherwise. TLS normally uses port 5061.

1. Click + at the bottom of Sipper's sidebar and choose Add Account.
2. Enter the details and save the account.
3. The sidebar shows whether the account has registered. Once it has, you can make and receive calls.

Troubleshooting

My account won't register

• Check the username, password, domain and server character by character. The domain and server are easy to mix up.
• Make sure the transport and port match what your provider expects.
• If your phone system uses TLS with a self-signed certificate, turn off Verify TLS certificates in Settings › Network. Only do this for a server you trust.
• After changing anything, Control-click the account in the sidebar and choose Re-register.
• Settings › Diagnostics shows the messages exchanged with the server. A 403 response, or a 401 that repeats after Sipper sends your password, usually means the credentials are wrong.

There's no audio, or only one person can hear the other

• Check that Sipper is allowed to use the microphone in System Settings › Privacy & Security › Microphone.
• Check the microphone and speaker selected in Settings › Audio.
• One-way audio is usually caused by a router or firewall. Edit the account and turn on Use ICE, or enter a STUN server your provider recommends. Switching the transport to TCP or TLS can also help.

Incoming calls don't show a notification

Notifications may be turned off for Sipper. Settings › General shows whether macOS allows them and can send a test. To turn them on, go to System Settings › Notifications › Sipper. The floating call alert and ringtone work either way.

Callers get a busy signal

Do Not Disturb turns incoming calls away as busy. Turn it off in the Call menu (⌘⇧DCommand Shift D) or from Sipper's menu bar icon.

Clicking a phone number opens a different app

Sipper can open tel:, sip: and sips: links. When macOS asks which app should open one, choose Sipper.

Where are my recordings?

In the folder chosen in Settings › Recording. In History, recorded calls have Play Recording and Show Recording in Finder actions.

The FusionPBX browser extension

The extension adds FusionPBX extensions to Sipper without retyping them. It works in Chrome, Edge, Brave, Vivaldi, Arc and Helium, and is installed from Sipper's source code for now.

1. Download the source code and open chrome://extensions (or your browser's extensions page).
2. Turn on Developer mode, choose Load unpacked and select the extension folder.
3. In FusionPBX, open Accounts › Extensions, open an extension and click the Sipper button in the browser toolbar.
4. Check the details and click Add to Sipper. On the extensions list you can tick several and add them together.

The browser asks once whether it may open Sipper. Your FusionPBX user needs permission to see extension passwords; without it, the extension asks you to type the password.

Building from source

Sipper's source code is on GitHub, with build instructions in its README. You'll need Xcode 16 or later, XcodeGen and Homebrew. Sign your build with an Apple Development certificate, even a free one: otherwise macOS asks for Keychain access to your SIP passwords after every rebuild.