opencord 0.2.1

Open-source ephemeral chat servers with automatic shutdown
Documentation 
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

# opencord

Ephemeral chat servers that shut themselves down. Spin one up, share the invite link, chat, and it disappears.

## Install

```
cargo install opencord
```

Or build from source:

```
git clone https://github.com/mcncl/opencord.git
cd opencord
cargo build --release
```

## Usage

### Start a server

```
cargo run --bin server -- --lifetime 2h
```

Output:

```
Listening on 127.0.0.1:8080 (lifetime: 120 minute(s))
Access code: XK7N4P
Invite link: ws://127.0.0.1:8080/?code=XK7N4P
```

### Connect

Share the invite link. Each person connects with:

```
cargo run --bin client -- <name> <invite_link>
```

```
cargo run --bin client -- Alice ws://127.0.0.1:8080/?code=XK7N4P
```

### Commands

| Command | Description |
|---------|-------------|
| `/extend <duration>` | Extend server lifetime (host only). e.g. `/extend 30m`, `/extend 1h` |
| `/help` | Show available commands |

## How it works

- The first person to join is the **host**
- The server shuts down when: the lifetime expires, the host disconnects, or all clients leave
- Warnings are broadcast as the deadline approaches (10m, 5m, 1m, 30s)
- The host can extend the lifetime with `/extend`
- Access codes prevent uninvited connections

## License

[GPL-3.0](LICENSE)