[PoC] SIP client in mainUI for (door) intercom

Hi there!

I’ve started working on something which I had thought of ever I’ve put a openHAB (3) tablet on the wall:
a SIP client integration.
Mainly for my SIP based door intercom, to be able to see who is there, answer and open the door without the need to switch to another app on the tablet.

Actually, I thought this is highly complex. But it turned out to be relatively easy and is already fairly working. Here is what I did and how it works:

I created a new “SIP client widget”, which lazy loads the JavaScript SIP client library jssip. The widget can be configured as usual and allows setting the required SIP credentials.
To use it, you simply put it on the main page that is usually shown on your tablet. Currently it shows a door icon and a dot indicating the SIP status (red=disconnected, orange=connected but unregistered, green=registered).

When a call comes in, a (fullscreen) popup is opened showing an image - which is meant to be a “live” mjpeg image from the front door - and the tablet rings. After accepting the “call” you can send a DTMF sequence to open the door lock.
See some screenshots below.

SIP Settings:

Incoming call from front door (with fake image):


  • no SIP video yet (I’m currently using a mjpeg stream from my front door camera to see the video upfront (couldn’t get early media to work))
  • Framework7 keeps previous pages loaded in background which keeps the SIP client active


  • only works when the page with the SIP widget is shown and with the tablet being awake, but I think this is ok for many/most tablet installations
  • requires a webrtc capable PBX, e.g. asterisk (popular german FritzBox alone won’t do). Setup is not very complicated, but requires HTTPS to be set up
  • since it requires JS it needs to be shipped with OH (TMK)
  • with multiple tablets this could also be used as intercom. Though, in order to use different registrations for each device, the credentials need to be stored somehow in local browser storage
  • for this (and others) SIP video could also be added

The current code can be found on github.

Let me know what you think.
Also, I’m curious who else might be interested in this. If there’s enough votes, perhaps it gets included.



Great to see someone playing with this. Check out this github request here as it should be possible and it may be what you have already have working, to use a widget to side load a webRTC connection to play a RTSP stream.

Simple RTSP support via Video Widget · Issue #10591 · openhab/openhab-addons (github.com)

There are webrtc javascript players for both RTSP and also HLS streams. Should be simple if you know how to side load the javascript players that people embed into websites.

I noticed if you use oh-webframe instead of oh-image to show camera’s mjpeg stream then the connection closes if you set url to "". When using oh-image the connection stays open even the src is set to "".
Maybe this helps a little bit.

I am no developer and started looking for an intercom solution. If you finished that widget that would be fantastic!

Did you open a Pull Request for this ???
If not, please do so.

1 Like

No, I didn’t. I’m still testing and fixing a few things. Once I’m done I surely will.

1 Like

So, I extended and finished the first version of this SIP widget.
It can now be used as intercom (i.e. outgoing calls).

I think I found a neat way to solve this: To set the individual credentials for a device you just long-touch the widget on that device and it will open a configuration popup, whose values will be saved to local browser storage (I (ab)used the WidgetConfigPopup for this). Since F7 doesn’t cover this for long mouse presses, the same popup will be shown when you click the widget in edit mode.
The local config also allows you to individually define call destinations for up to 4 (quick) dial buttons

I was able to fix this by using F7’s pageBeforeOut event, instead of Vue’s lifecycle hooks.


  • video support
  • “announcement” mode: make announcement to another or all stations (technically an auto-answer on the announcement clients). Could be used to speak to other rooms or floors, e.g. to announce “lunch is ready!”

I think it’s ready in its first version, so I’ll open a pull request soon.

1 Like

This is really interesting for me. Asterisk already in use, so… why not use it inside ΟΗ !

You have a SIP door camera/ringbell ?