blob: 7dfd3305260f27a0dbed3e8b384ee970a7ee455b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
# keks-meet
a web conferencing application
## Features
- Rooms
- Different stream types
- Camera
- Microphone
- Screen capture
- Multiple streams
- Noise suppression (rnnoise)
## Todo-List
- Chat
- Optionally enable video streams
- Settings menu
- Native client
## Usage
For trying it out, a hosted version is available on [my server](https://meet.metamuffin.org/).
For self-hosting, this script should do:
```
git clone https://codeberg.org/metamuffin/keks-meet.git
cd keks-meet
make -C client-web
cd server
cargo run --release
```
## Parameters
For configuration options must be added either
1. in options in the query parameters (e.g. `/myroom?username=alice`)
2. in options in section of URL (e.g. `/myroom#rnnoise=no`).
The page will not automatically reload if the section changes.
Booleans can be either `1`, `true`, `yes` or their opposites.
| Option name | Type | Default | Description |
| ----------------- | ------- | ------- | ---------------------------------------- |
| `?username` | string | "guest" | Sets the username |
| `#rnnoise` | boolean | true | Enables noise suppression with rnnoise |
| `#mic_enabled` | boolean | false | Adds audio track on startup |
| `#camera_enabled` | boolean | false | Adds camera track on startup |
| `#screen_enabled` | boolean | false | Adds screen track on startup (wont work) |
| `#mic_gain` | number | 1 | Amplifies the microphone volume |
## Protocol
The protocol packets are defined in [packets.d.ts](./common/packets.d.ts). Here is an (simplified) example of how the protocol is used.
```
S->C { init: { your_id: 5, version: "..." } }
---- # Your join packet will be the first one.
S->C { client_join: { id: 5, name: "bob" } }
S->C { client_join: { id: 3, name: "alice" } }
---- # Now publish your ICE candidates
C->S { relay: { message: { ice_candiate: <RTCIceCandidateInit> } } }
---- # Whenever you change your streams change:
---- # Send an offer to everybody
C->S { relay: { recipient: 3, offer: <RTCSessionDescriptionInit> } }
---- # Alice answers
S->C { message: { sender: 3, message: { offer: <RTCSessionDescriptionInit> } } }
---- # In case the server uses a reverse-proxy that disconnects inactive connections: Ping every 30s
C->S { ping: null }
```
## Licence
See `LICENCE` file.
|
