* 🧵🐈 Threadcat
  /A radically simple, low feature, message board for shared *nix systems/

Why? Because its just 4 small shell scripts and some easy-to-do
directory config. 

** Basic Idea 

 You post to threadcat using =cat= or =echo=.  Here is an example:
#+begin_src shell 

cat <<EOF | threadcat write SomeThread
   
Here is a message! 
It can be multiline!
 
EOF 
#+end_src


The above would append the follwing message to a thread called =SomeThread=

#+begin_src

colin -- Mon Aug 15 08:23:10 AM CDT 2022

Here is a message!
It can be multiline!

#+end_src

You can post a short message with =echo=:

#+begin_src shell
echo Just saying Hey | threadcat write SomeOtherThread 
#+end_src

For very long messages, you can of course use a text editor of choice
to compose it. Just save it as a file, then post it like so:

#+begin_src shell

cat my-long-post.txt | threadcat write SomeThread

#+end_src

You can the list and search for threads with

#+begin_src shell
threadcat list                     # just lists all the threads, newest first
threadcat list | grep -i emacs     # lists threads whose names mention emacs
#+end_src

And you can read a particular thread by doing:

#+begin_src shell
threadcat read SomeThread 
#+end_src

This prints to the standard output. You can pipe it to =less= or
=head= or =tail= if you want to.

#+begin_src shell

threacat read SomeThread | less         # read the whole thread 
threacat read SomeThread | tail -n 50   # read last 50 lines
threacat read SomeThread | head -n 30   # readd first 30 lines  
#+end_src

See this [[https://asciinema.org/a/dyRz4AnQWKGsZe0A96oAnUP3O][screencast]] for basic use. (Also, let me know if the video
isn't there any more, I just posted it to asciinema and have no idea
how long those videos remain.)

** Install the client 

Assuming that =~/.local/bin= is in your =PATH=, just put the threadcat scripts there:

#+begin_src shell

git clone https://cicadas.surf/cgit/colin/threadcat.git threadcat 
cd threadcat 
cp *.sh ~/.local/bin 
cp threadcat ~/.local/bin 

#+end_src

That's all!  Type =threadcat= at the command line to get started!

** Server Setup 

#+begin_src shell

ssh you@yourhost.com 
sudo su

#make a group
groupadd threadcat 

# add your users, group available on next login
usermod -a -G threadcat <user1>
usermod -a -G threadcat <user2>

# make the threadcat directory
mkdir /opt/threadcat 

#and make it and its contents writable by threadcat group
chown root:threadcat /opt/threadcat
chmod g+rwxs /opt/threadcat

#+end_src

Thats it!