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 or Windows version and your Sipper version (on a Mac, Sipper › About Sipper; on Windows, Settings › About in 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

Windows

10 or 11, 64-bit (x64)

Phone service

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

Installing and updating

On a Mac

1. Download Sipper from sipper.dev/download/mac.
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.

If you use Homebrew, you can install Sipper with it instead:

brew install --cask hybes/tap/sipper

To update, run brew upgrade --cask sipper. brew uninstall --cask sipper removes the app and keeps your accounts, contacts and history.

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 (right-click on Windows) 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 can use the microphone: on a Mac in System Settings › Privacy & Security › Microphone; on Windows on the Microphone page in Settings › Privacy & security, where microphone access for desktop apps must also be on.
• 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. On a Mac, Settings › General shows whether macOS allows them and can send a test; turn them on in System Settings › Notifications › Sipper. On Windows, Settings › General can send a test; turn notifications on in Windows Settings › System › Notifications. The call alert and ringtone work either way.

Callers get a busy signal

Do Not Disturb turns incoming calls away as busy. On a Mac, turn it off in the Call menu (⌘⇧DCommand Shift D) or from Sipper's menu bar icon. On Windows, press CtrlAltD, or use Sipper's icon in the notification area or Settings › General.

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. On Windows, choose Sipper in Settings › Apps › Default apps; Settings › General › Phone links in Sipper opens that page.

Where are my recordings?

In the folder chosen in Settings › Recording. In History, right-click or Control-click a recorded call to play the recording or show it in Finder or File Explorer.

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.

Managed setup

Open Management, create your account and verify your email. Administrators must set up two-factor authentication under Security before creating a workspace. During the pilot, the platform owner grants time-limited licences; no payment is collected.

Create a customer, add its calling accounts, invite people and assign their licences and accounts. A person’s Device setup panel can create a single-use setup link for a compatible pilot app. Users sign in with their own invited email address.

The public desktop downloads are the standalone release. Request the current pilot build before testing managed sign-in. iOS and Android store releases and reliable background ringing have not been released. Device activity records show recent observations; they do not guarantee a phone is reachable.

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.

The Windows version is in the windows folder and builds on Windows with Visual Studio 2022, CMake, Node.js and Python. Its README has the steps.