Getting started

Install

1. baresip

ringo needs baresip ≥ 3.14 in your $PATH (baresip -v to check). See Supported platforms; on most systems:

sudo pacman -S baresip   # Arch
sudo apt install baresip # Debian/Ubuntu (may need >= 3.14 from a PPA/source)
brew install baresip     # macOS

2. ringo

Pre-built binaries for Linux and macOS (x86_64 + arm64) are on the releases page — download, extract and put ringo on your $PATH.

From crates.io:

cargo install ringo-phone

From GitHub (no clone needed):

cargo install --git https://github.com/davidborzek/ringo ringo-phone

Quick start

ringo        # open the profile picker → Ctrl+N to create your first profile

Fill in your SIP credentials in the form, press Enter to save, then select the profile and press Enter to launch. See Profiles for the fields.

Usage

ringo              # open the profile picker (default)
ringo start <name> # launch a specific profile directly
ringo list         # list all profiles
ringo list --plain # one name per line (for scripting)
ringo list --json  # as a JSON array

From here, Using the TUI covers the keybindings, and Remote control covers driving a running session from a script.