bunk
/
bunkchat
6
2
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ultra-simple, local-only chat for tilde servers written in posix sh
7 Commits 2 Branches 0 Tags 36 KiB
Shell 100%
Go to file
maren 9cfd75232c clarify that it's a group chat 2024-04-16 22:55:32 -04:00
.gitignore take heed, and proclaim that which you hath scried 2024-04-13 20:42:14 -04:00
LICENSE.txt take heed, and proclaim that which you hath scried 2024-04-13 20:42:14 -04:00
README.md clarify that it's a group chat 2024-04-16 22:55:32 -04:00
heed take heed, and proclaim that which you hath scried 2024-04-13 20:42:14 -04:00
install.sh dunno how this got there 2024-04-14 10:18:38 -04:00
proclaim tidy proclaim 2024-04-13 23:00:38 -04:00
scry take heed, and proclaim that which you hath scried 2024-04-13 20:42:14 -04:00

README.md

bunkchat 🏰

bunkchat is ultra-simple, local-only group chat for tilde servers written in posix sh

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
  2. heed - read current chat
  3. 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

notes

bunkchat is one large group chat that every user on the server is part of

if your file system does not support setting append only permissions with chattr +a, install.sh will fail

bunkchat should work on all standard linuces. not tested on bsd