about summary refs log tree commit diff
path: root/README.md
blob: fdf3425b5eabbf3c8f0a9ba8e246fe2fb5db8057 (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
# edward -- ed(1) over IRC

edward is a script to pipe the output of ed(1) or any other command over IRC.
It can be used to create a small pair-programming environment or to maintain
shared information for a channel.

edward runs a separate instance of ed in each channel. The whole instance is
shared between every user in the channel.

## installing and running edward

edward requires
Lua 5.4,
[cqueues](https://github.com/wahern/cqueues),
[luaposix](https://github.com/luaposix/luaposix),
and an implementation of `red`, ed in restricted mode.

Copy `config.example.lua` to `config.whatever.lua`
and edit to taste.
Then run:

```
lua bot.lua config.whatever.lua
```

## security

Don't.

edward runs in restricted mode by default,
preventing stray file access and shell commands,
but otherwise doesn't do anything to prevent users from
writing huge files,
spamming the output of whatever channel you put it in,
etc.

## bugs

see `TODO`.

## copyright

edward is licensed under the GIRLFRIEND PUBLIC LICENSE.
see `LICENSE`.