A native Linux SIP softphone with PipeWire audio. Multiple accounts, five lines each, hold / transfer / join, a real incoming-call window, and call audio you can route into Discord or any other app.
OxideSip registers your SIP extensions with a PBX (FreePBX, Asterisk, 3CX, anything standard) and behaves like a desk phone on your desktop. It is written in Rust, draws its own interface with iced, and talks to PipeWire directly — no PulseAudio layer, no browser engine.
- Multiple accounts, five lines each. Every account registers on its own. Hold, resume, blind transfer, start a second call, and join two lines into a local three-way call.
- Incoming calls you cannot miss. A small always-on-top window with big Answer / Decline buttons (Enter / Esc), plus a desktop notification with the same two actions. Simultaneous calls stack in the same window.
- Caller ID done right. The caller's name and number come from the SIP headers and are matched against your contacts by number, so "+1 555 123 4567" finds the contact you saved as "5551234567".
- Route the call anywhere. Send the other party's voice into another app's live input (Discord's voice engine, OBS, a virtual sink) or mix another app's audio into what the far end hears — per call, with one button.
- Standards you expect. RFC 4733 DTMF with SIP INFO fallback, an ordered codec priority list (G.722 HD voice, G.711 µ-law / A-law), optional SDES-SRTP, UDP / TCP / TLS transports.
- The rest of a phone. Contacts with JSON import/export, call history with filters and missed-call badge, Do Not Disturb, auto-answer, a deny list, WAV call recording, a compact floating call bar, keyboard shortcuts, dark and light themes that follow the desktop.
| Fedora, openSUSE, RHEL family | Download the .rpm from the latest release, then sudo dnf install ./oxidesip-*.rpm |
| Debian, Ubuntu, Mint, Pop!_OS | Download the .deb, then sudo apt install ./oxidesip_*.deb |
| Any Linux | Download oxidesip-x86_64.flatpak, then flatpak install --user ./oxidesip-x86_64.flatpak; or unpack oxidesip-linux-x86_64.tar.gz and run ./oxidesip |
| From source | See Building |
The packages install the app, its launcher and icons, and declare their shared-library
dependencies (PipeWire and friends) from the binary itself. A SHA256SUMS file sits next to
every release asset.
Settings ▸ About ▸ Check for updates asks GitHub for the latest release. If there is one,
Update now downloads the package matching your install (RPM, deb or the standalone binary),
checks it against the release's SHA256SUMS, and installs it — for the RPM and deb through your
system's own password prompt (pkexec), so nothing is installed without your say-so. Then
Restart now starts the new version. OxideSip also checks once at startup and tells you if a
newer version exists; that check can be switched off on the same page, and nothing is ever
downloaded or installed on its own.
The Flatpak cannot replace itself from inside its sandbox, and a build from source is not a release package: for those the button opens the download page instead.
| Sound server | PipeWire 0.3.44 or newer as the session's audio server (the Fedora / KDE / GNOME default) |
| Desktop | Wayland or X11. Any GPU; virtual machines fall back to software rendering |
| Account | A SIP extension on a PBX you can reach — on the LAN, over a VPN, or from behind a home router to a public PBX |
- Start OxideSip from your launcher (or run
oxidesip). The first run opens Settings ▸ Accounts — enter the server, extension and password and press Add account. The pill at the bottom of the sidebar turns green when you are registered. - Phone page: type a number or use the keypad, press Call or Enter. Pick a contact or a history entry to call it directly. Each of the five lines shows who is on it and for how long.
- When a call comes in, the incoming window appears on top of everything. Enter or A answers, Esc or D declines, S silences the ringtone. The desktop notification has the same Answer / Decline buttons.
- During a call: mute, hold, transfer (type a number or SIP URI), open the in-call keypad for DTMF, start another call on a free line with +, and Join two active lines. The shrink button in the top bar (or Ctrl+Shift+C) opens a small always-on-top call bar you can keep over other windows; it closes when the call ends.
| Page | What is there |
|---|---|
| Phone | Dial card, the five lines with live state, the selected line's call card |
| Contacts | Search, sort, call / edit / delete, JSON import and export (also reads MicroSIP-style exports) |
| History | All / Missed / Incoming / Outgoing, grouped by day, call back or add to contacts |
| Settings | Accounts · Audio & codecs · Calls (DND, auto-answer, notifications, deny list, recording, secondary audio) · Appearance · About |
Open Settings ▸ Calls ▸ Secondary audio while you are in the voice channel, press the
refresh button, and pick the app's entry (prefixed App:). Also send the other party's voice
to links the far end straight into that app's live input stream, the same way qpwgraph or
helvum would patch one client into another. Mix into what the other party hears, from
does the reverse, and is switched on per call with the wave button in the Lines card. If the
app is not listed it is not currently listening for audio; a virtual sink of your own works too.
| Shortcut | Action |
|---|---|
Enter |
Call the typed number, or answer a ringing call |
Esc |
Decline a ringing call · press twice to hang up |
0–9 * # |
Dial, or send DTMF during a call |
Backspace |
Delete the last digit |
Ctrl+1 … Ctrl+4 |
Phone, Contacts, History, Settings |
Ctrl+K |
Focus the number field (or the contact search) |
Ctrl+M / Ctrl+H / Ctrl+T |
Mute / hold / transfer the current call |
Ctrl+Shift+C |
Compact call bar |
Ctrl+B |
Collapse the sidebar |
Ctrl+, |
Settings |
Ctrl+Q |
Quit (asks first if a call is up) |
A / D / S |
Answer / Decline / Silence, in the incoming-call window |
oxidesip # the app
oxidesip sip:1001@pbx.lan # start with a number in the dial field (also tel: URIs)
oxidesip --demo # the real UI on a scripted backend: no SIP, no audio, nothing saved
oxidesip --screenshot docs/shots --page all # render the documentation screenshots and exit
oxidesip --helpThe .desktop entry registers OxideSip as a handler for sip: and tel: links, so a phone
number clicked in a browser can open here.
-
The sidebar pill stays "Connecting…". The server or port is wrong, or the PBX is not reachable from this network. "Stopped" means the PBX refused the credentials (403, or repeated 401/407); fix the account and press Save & re-register.
-
TLS does not connect. A CA certificate path is required for TLS; set it in the account file (see Where your stuff is kept). Client certificates are optional.
-
No audio, or the wrong device. Pick the microphone and speaker under Settings ▸ Audio & codecs. Device changes apply to the next call; the ringtone and dial tones follow after a restart.
pw-topshows whether theOxideSipstreams are running. -
No icon, or an old icon, in the task bar. On Wayland the icon comes from the
.desktopentry matched by app id (io.github.zerodaylabz.OxideSip). The app installs its icons into~/.local/share/iconson start, and a launcher entry too when no package provides one. KDE caches rendered icons by name, so after an upgrade the app tells the icon loader to reload; if an old icon still lingers, run the line below (or log out and back in once):dbus-send --session --type=signal /KIconLoader org.kde.KIconLoader.iconChanged int32:0
-
The incoming window does not come to the front. KDE and GNOME may refuse to raise a new window over a full-screen app; the task-bar entry pulses instead and the desktop notification carries Answer / Decline. Make sure Desktop notifications is on under Settings ▸ Calls.
-
Blank or very slow window in a VM. Run with
ICED_BACKEND=tiny-skia oxidesip(software rendering). -
One-way audio or no audio behind NAT. OxideSip keeps its NAT mapping open, sends audio back to wherever the PBX's audio comes from, and advertises the address the PBX sees — which works with a PBX set up for NAT clients (on FreePBX: the extension's Rewrite Contact and RTP Symmetric left at Yes). There is no STUN / ICE, so a PBX that insists on direct media between two phones that are both behind NAT still needs a VPN.
| Accounts | ~/.config/oxidesip/accounts.toml |
| Call-handling settings, theme | ~/.config/oxidesip/settings.toml |
| Audio devices | ~/.config/oxidesip/audio_devices.toml |
| Contacts, call history | ~/.config/oxidesip/contacts.toml, call_history.toml |
| Window size, page, filters | ~/.config/oxidesip/ui_state.toml |
| Recordings | The folder you pick under Settings ▸ Calls ▸ Recording |
Inside the Flatpak the same files live under ~/.var/app/io.github.zerodaylabz.OxideSip/config/oxidesip/.
Settings ▸ About ▸ Open config folder takes you there. Nothing is written in --demo mode.
To seed an account without the UI, copy
softphone-core/config.example.toml into
accounts.toml as an [[accounts]] entry, or set OXIDESIP_* environment variables
(OXIDESIP_SIP_SERVER_HOST, OXIDESIP_SIP_SERVER_PORT, OXIDESIP_TRANSPORT,
OXIDESIP_USERNAME, OXIDESIP_PASSWORD, OXIDESIP_REGISTER_EXPIRES, OXIDESIP_LOCAL_PORT,
OXIDESIP_SRTP, OXIDESIP_CA_CERT_PATH, OXIDESIP_CLIENT_CERT_PATH, OXIDESIP_CLIENT_KEY_PATH,
OXIDESIP_PREFERRED_CODECS) for the first run; they are migrated into accounts.toml.
# Fedora
sudo dnf install pipewire-devel clang-devel pkgconf-pkg-config libxkbcommon-devel wayland-devel
# Debian / Ubuntu
sudo apt install libpipewire-0.3-dev libclang-dev pkg-config libxkbcommon-dev libwayland-dev
# Arch
sudo pacman -S pipewire clang pkgconf libxkbcommon wayland
git clone https://github.com/ZeroDay-Labz/OxideSip && cd OxideSip
cargo run --release -p softphone-uiRust 1.88 or newer. cargo test --workspace runs the SIP, SDP and codec tests;
cargo clippy --workspace --all-targets -- -D warnings and cargo fmt --check must stay
clean (CI enforces both). scripts/render-icons.sh regenerates the icon PNGs from the SVG,
scripts/screenshots.sh regenerates docs/screenshots/ with the app's own --screenshot mode.
See CONTRIBUTING.md.
| Crate | Purpose |
|---|---|
softphone-core |
SIP signalling via rsipstack: registration, dialogs, SDP negotiation, structured caller identity. No UI or audio code. |
softphone-media |
PipeWire capture and playback, RTP send/receive with RFC 4733 events, tones, WAV recording, G.711 and G.722 codecs, SRTP, secondary-stream routing. |
softphone-ui |
The iced desktop app: theme, pages, incoming-call window, notifications, demo and screenshot modes, packaging metadata. |
Tagged pushes (v*) run release.yml, which builds the
tarball, RPM, deb and Flatpak bundle and attaches them to the GitHub release.
- No STUN / ICE. NAT is handled the way SIP phones usually do it (keepalives, symmetric RTP, the registrar-observed address in Contact), which relies on the PBX relaying media.
- Echo cancellation is opt-in (Settings ▸ Calls). It uses PipeWire's echo-cancel module, so it needs that module installed and may be unavailable inside the Flatpak sandbox; a headset needs neither.
- Blind transfer reports "requested", not "completed".
rsipstackexposes whether the REFER was accepted but not the follow-up NOTIFY that would say whether the target answered. - Call forwarding is not implemented (the stack cannot send a SIP 3xx yet); the old toggle has been removed from Settings.
- Keyboard focus reaches text fields and the shortcuts above; buttons and toggles are not Tab-focusable in this version of iced.
Built with iced, rsipstack and PipeWire. UI font: Inter (SIL OFL 1.1). Icons: Lucide (ISC).
MIT. See LICENSE.




