---
title: Video calls
description: Video calls straight between the people in them, signed with their end-to-end keys, with no media server.
section: Plugins
order: 39
---

# Video calls

Video calls straight between the people in them, signed with their end-to-end keys, with no media server.

The `calls` plugin opens a video call in a window over the page. Each person's browser connects straight to each other person's, so the video and sound never go through your server. To add it:

```sh title="Terminal"
sluurp plugin add calls
```

Features include:

- Calls in a record's room, open to whoever may view the record
- Camera, microphone, screen sharing, raised hands and chat
- Connections signed with each person's end-to-end keys
- A relay built in, for networks that allow no direct connection

## Start a call

A call happens in a record's room: whoever may view the record may join. `people` narrows that to the people expected.

```ts title="app.ts"
import { openCall } from "plugin:calls";

openCall(sluurp, {
  topic: `meetings:${meeting.id}`,
  people: [meeting.host, meeting.guest],
  title: "Weekly check-in",
});
```

People in the call can turn their camera and microphone on and off, share their screen, raise a hand and chat. Chat messages also go straight between them.

## Who is on the other end

Each browser signs its connection's fingerprint with the person's end-to-end keys. The other side checks the signature before it connects, so even someone in control of the server can't listen in by pretending to be one of the people.

- If a person has no keys yet, their tile says "Not verified": the call is still encrypted, but who is on the other end isn't proved.
- If a signature doesn't match, that connection is refused.

## Strict networks

Most calls connect directly. Some networks, such as strict company firewalls and some mobile carriers, allow no direct connection, and those calls need a relay. Sluurp has one built in. To turn it on, set the address browsers reach your server at:

```sh title="Terminal"
SLUURP_TURN_IP=203.0.113.7 sluurp serve
```

Open UDP port 3478 and ports 49160 to 49200 there. The relay only passes on packets that are already encrypted, so it can't see or hear the call, and only people signed in to your app get its short-lived credentials.

## Size

Each person sends their video to each other person, which suits calls of up to five or six people.
