2024-04-14 00:42:14 +00:00
|
|
|
# bunkchat 🏰
|
|
|
|
|
|
2024-04-17 02:55:32 +00:00
|
|
|
**bunkchat** is ultra-simple, local-only group chat for tilde servers written in posix sh
|
2024-04-14 00:42:14 +00:00
|
|
|
|
|
|
|
|
## install
|
|
|
|
|
```
|
|
|
|
|
git clone https://git.bunk.computer/bunk/bunkchat.git && \
|
|
|
|
|
cd ./bunkchat && \
|
|
|
|
|
sudo ./install.sh
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## usage
|
|
|
|
|
bunkchat is comprised of three separate programs
|
|
|
|
|
1. **proclaim** - post in chat
|
|
|
|
|
1. **heed** - read current chat
|
|
|
|
|
1. **scry** - read old chat
|
|
|
|
|
|
|
|
|
|
run `proclaim` and `heed` in adjacent terminals for best ux
|
|
|
|
|
|
|
|
|
|
## security
|
|
|
|
|
hopefully!
|
|
|
|
|
|
|
|
|
|
- the chat log is append only, but anyone can append anything to it
|
|
|
|
|
- `proclaim` only accepts user input with `read -r`, which does not expand variables, and appends to the chat log with `echo "$userinput" >> $chatlog`
|
|
|
|
|
- `heed` only does `tail -f` on the chat log
|
|
|
|
|
- `scry` only opens the chat log with `less`
|
|
|
|
|
- no one has execute permissions on the chat log
|
|
|
|
|
|
|
|
|
|
if you find a security issue, please [contact us](mailto:contact@bunk.computer)
|
|
|
|
|
|
|
|
|
|
## notes
|
2024-04-17 02:55:32 +00:00
|
|
|
bunkchat is one large group chat that every user on the server is part of
|
|
|
|
|
|
2024-04-14 00:42:14 +00:00
|
|
|
if your file system does not support setting append only permissions with `chattr +a`, install.sh will fail
|
|
|
|
|
|
2024-04-14 01:06:24 +00:00
|
|
|
bunkchat should work on all standard linuces. not tested on bsd
|
2024-04-14 00:42:14 +00:00
|
|
|
|
