# i-p-tel/sipdroid architecture

> Architecture diagram of the GitHub repository i-p-tel/sipdroid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/i-p-tel/sipdroid
- Repository: https://github.com/i-p-tel/sipdroid

## Overview

Sipdroid is an Android SIP softphone. The main workflow runs from the dialer UI through Android event handling and the SIP engine to registration or call setup; UserAgent negotiates media, which is carried as RTP and encoded with selectable codecs. The README also describes hold, mute, DTMF, and network handoff. The graph keeps those documented capabilities visible, but their implementation paths and connections are not verified in the sampled excerpts; several internal stack and media links are therefore omitted or marked unverified.

Main entry points: [`app/src/main/java/org/sipdroid/sipua/UserAgent.java`](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/UserAgent.java) (Call control), [`app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java`](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java) (SIP engine), [`app/src/main/java/org/zoolu/sip/provider/SipProvider.java`](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/provider/SipProvider.java) (SIP provider), [`app/src/main/java/org/sipdroid/sipua/ui/Receiver.java`](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/Receiver.java) (Android events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android app"]
  node_dialer["Dialer UI<br/>[Sipdroid.java]"]
  node_settings["Call settings<br/>[Settings.java]"]
  node_receiver["Android events<br/>[Receiver.java]"]
  node_service["Registration service"]
  node_phone["Call integration<br/>[Phone.java]"]
  node_features["Call features<br/>[UserAgent.java]"]
end

subgraph group_sip["SIP signaling"]
  node_engine["SIP engine"]
  node_registration["SIP registration<br/>[RegisterAgent.java]"]
  node_useragent["Call control<br/>[UserAgent.java]"]
  node_provider["SIP provider<br/>[SipProvider.java]"]
  node_transaction["SIP transactions"]
end

subgraph group_media["Call media"]
  node_media["Media launcher<br/>[MediaLauncher.java]"]
  node_rtp["RTP audio"]
  node_codecs["Audio codecs<br/>[Codecs.java]"]
end

subgraph group_protocol["Protocol foundation"]
  node_sdp["SDP negotiation"]
  node_parser["SIP message parsing<br/>[SipParser.java]"]
  node_transport["Network transport<br/>[Transport.java]"]
end

node_user(("Phone user"))
node_sipserver(("SIP peer"))
node_audio(("Audio device"))

node_user -->|"enters number"| node_dialer
node_dialer -.->|"starts calls"| node_engine
node_service -->|"registers events"| node_receiver
node_receiver -->|"starts engine"| node_engine
node_engine -->|"creates agent"| node_registration
node_engine -->|"creates agent"| node_useragent
node_engine -->|"updates status"| node_receiver
node_engine -.->|"registers"| node_sipserver
node_useragent -->|"builds sessions"| node_sdp
node_useragent -.->|"starts media"| node_media
node_useragent -->|"uses receiver"| node_rtp
node_useragent -->|"selects codecs"| node_codecs
node_useragent -.->|"places calls"| node_sipserver
node_transaction -->|"sends messages"| node_provider
node_provider -.->|"sends signaling"| node_sipserver
node_provider -.->|"sends packets"| node_transport
node_parser -.->|"parses messages"| node_sdp
node_rtp -.->|"plays audio"| node_audio
node_features -.->|"supports call actions"| node_useragent
node_settings -.->|"configures calls"| node_engine

click node_dialer "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/Sipdroid.java"
click node_settings "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/Settings.java"
click node_receiver "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/Receiver.java"
click node_service "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/RegisterService.java"
click node_phone "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/phone/Phone.java"
click node_engine "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java"
click node_registration "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/RegisterAgent.java"
click node_useragent "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/UserAgent.java"
click node_provider "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/provider/SipProvider.java"
click node_transaction "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/transaction/TransactionClient.java"
click node_sdp "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sdp/SessionDescriptor.java"
click node_parser "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/provider/SipParser.java"
click node_transport "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/provider/Transport.java"
click node_media "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/media/MediaLauncher.java"
click node_rtp "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/media/RtpStreamReceiver.java"
click node_codecs "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/codecs/Codecs.java"
click node_features "https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/UserAgent.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dialer,node_settings,node_receiver,node_service,node_phone,node_features,node_user toneBlue
class node_engine,node_registration,node_useragent,node_provider,node_transaction toneAmber
class node_media,node_rtp,node_codecs toneMint
class node_sdp,node_parser,node_transport toneRose
class node_sipserver,node_audio toneIndigo
```

## Components

### Android app

- [Dialer UI](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/Sipdroid.java): `app/src/main/java/org/sipdroid/sipua/ui/Sipdroid.java`
- [Call settings](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/Settings.java): `app/src/main/java/org/sipdroid/sipua/ui/Settings.java`
- [Android events](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/Receiver.java): `app/src/main/java/org/sipdroid/sipua/ui/Receiver.java`
- [Registration service](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/ui/RegisterService.java): `app/src/main/java/org/sipdroid/sipua/ui/RegisterService.java`
- [Call integration](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/phone/Phone.java): `app/src/main/java/org/sipdroid/sipua/phone/Phone.java`
- [Call features](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/UserAgent.java): `app/src/main/java/org/sipdroid/sipua/UserAgent.java`

### SIP signaling

- [SIP engine](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java): `app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java`
- [SIP registration](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/RegisterAgent.java): `app/src/main/java/org/sipdroid/sipua/RegisterAgent.java`
- [Call control](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/sipua/UserAgent.java): `app/src/main/java/org/sipdroid/sipua/UserAgent.java`
- [SIP provider](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/provider/SipProvider.java): `app/src/main/java/org/zoolu/sip/provider/SipProvider.java`
- [SIP transactions](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/transaction/TransactionClient.java): `app/src/main/java/org/zoolu/sip/transaction/TransactionClient.java`

### Call media

- [Media launcher](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/media/MediaLauncher.java): `app/src/main/java/org/sipdroid/media/MediaLauncher.java`
- [RTP audio](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/media/RtpStreamReceiver.java): `app/src/main/java/org/sipdroid/media/RtpStreamReceiver.java`
- [Audio codecs](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/sipdroid/codecs/Codecs.java): `app/src/main/java/org/sipdroid/codecs/Codecs.java`

### Protocol foundation

- [SDP negotiation](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sdp/SessionDescriptor.java): `app/src/main/java/org/zoolu/sdp/SessionDescriptor.java`
- [SIP message parsing](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/provider/SipParser.java): `app/src/main/java/org/zoolu/sip/provider/SipParser.java`
- [Network transport](https://github.com/i-p-tel/sipdroid/blob/master/app/src/main/java/org/zoolu/sip/provider/Transport.java): `app/src/main/java/org/zoolu/sip/provider/Transport.java`

### Other components

- **Phone user**
- **SIP peer**
- **Audio device**

## Connections

- Phone user → Dialer UI: enters number
- Dialer UI → SIP engine: starts calls (evidence: `app/src/main/java/org/sipdroid/sipua/ui/Sipdroid.java`)
- Registration service → Android events: registers events (evidence: `app/src/main/java/org/sipdroid/sipua/ui/RegisterService.java`)
- Android events → SIP engine: starts engine (evidence: `app/src/main/java/org/sipdroid/sipua/ui/Receiver.java`)
- SIP engine → SIP registration: creates agent (evidence: `app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java`)
- SIP engine → Call control: creates agent (evidence: `app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java`)
- SIP engine → Android events: updates status (evidence: `app/src/main/java/org/sipdroid/sipua/SipdroidEngine.java`)
- SIP engine → SIP peer: registers
- Call control → SDP negotiation: builds sessions (evidence: `app/src/main/java/org/sipdroid/sipua/UserAgent.java`)
- Call control → Media launcher: starts media (evidence: `app/src/main/java/org/sipdroid/sipua/UserAgent.java`)
- Call control → RTP audio: uses receiver (evidence: `app/src/main/java/org/sipdroid/sipua/UserAgent.java`)
- Call control → Audio codecs: selects codecs (evidence: `app/src/main/java/org/sipdroid/sipua/UserAgent.java`)
- Call control → SIP peer: places calls
- SIP transactions → SIP provider: sends messages (evidence: `app/src/main/java/org/zoolu/sip/transaction/TransactionClient.java`)
- SIP provider → SIP peer: sends signaling
- SIP provider → Network transport: sends packets (evidence: `app/src/main/java/org/zoolu/sip/provider/SipProvider.java`)
- SIP message parsing → SDP negotiation: parses messages
- RTP audio → Audio device: plays audio
- Call features → Call control: supports call actions (evidence: `app/src/main/java/org/sipdroid/sipua/UserAgent.java`)
- Call settings → SIP engine: configures calls (evidence: `app/src/main/java/org/sipdroid/sipua/ui/Settings.java`)
