Mobile Softphone for Android

A WebRTC softphone that pairs to a Frappe Extension by scanning a QR code generated from the desk. Backed by Twilio Voice, FCM push for inbound call wake, and the OrbWeaver PBX backend at orbweaver_pbx.api.mobile.

Download latest APK

Direct link to the GitHub Release asset. See all releases for prior versions.

How to install

  1. Allow installs from unknown sources on the target device: Settings → Apps → Special app access → Install unknown apps → your browser → Allow.
  2. Open the APK link above on the Android device, tap the download, then tap the downloaded file to install.
  3. Launch OrbWeaver Softphone. The app asks for camera + microphone permission on first launch.

How to pair

  1. In the Frappe desk, open the user's Extension (Path: /app/extension).
  2. Click the Generate Mobile QR button. A 10-minute QR code appears.
  3. Scan the QR with the softphone app. The app exchanges the OTP for a Twilio Voice JWT and a device-bound refresh token, then registers with the PBX. No manual config.
  4. Re-pair anytime by tapping Sign out in Settings and scanning a fresh QR.

Inbound call wake-up

For the device to ring when backgrounded, the PBX site must have a Twilio Push Credential SID configured at PBX Settings → Push Credential SID (FCM) and the APK must be built with a real google-services.json for the same Firebase project that owns the FCM Server Key.

Source

Repos: orbweaver_pbx_android (app) and orbweaver_pbx (backend).