Skip to content

Repository files navigation

lisp-chat

Quicklisp dist MELPA

Lisp Chat

An experimental chat irc-like written in Lisp.

lisp-chat-screenshot

Installation

Install [roswell][ros] and add ~/.roswell/bin/ to the PATH variable.

After that just type:

ros install ryukinix/lisp-chat

Lisp-chat it's on Quicklisp as well, tested on the following implementations:

  • SBCL
  • CCL
  • ECL

Usage

Load the server

$ lisp-chat-server localhost

Create a client

$ lisp-chat localhost

Online version with connection through web sockets instead raw tcp sockets:

$ lisp-chat wss://chat.manoel.dev/ws

Docker usage

docker run -d -t \
    --name lisp-chat \
    --restart unless-stopped \
    --pull always \
    -w /lisp-chat/log \
    -v lisp-chat-log:/lisp-chat/log \
    -e TZ=America/Belem \
    -p 5559:5559 \
    -p 5558:5558 \
    ryukinix/lisp-chat:latest

If you omit -w and -v parameters it will not persist messages between sessions of docker run.

Web Interface

A web interface is now available! You can access the public instance at: https://chat.manoel.dev

When running the server locally, the web interface is accessible at http://localhost:5559.

lisp-chat-web

Admin Tool

A command-line tool for managing the chat history and users is available. You can use it to delete channels, rename users, and see statistics. By default, it operates on messages.sexp, but you can specify a different file using the global --file (or -f) option.

$ ros roswell/lisp-chat-admin.ros --file custom-messages.sexp stats
$ ros roswell/lisp-chat-admin.ros history
$ ros roswell/lisp-chat-admin.ros --help

Alternative clients

To test this with alternative clients, you can use these options:

  • Emacs client: An ERC-like interface with colorized usernames, mentions, and WebSocket/TCP support. See emacs/README.md for details.
  • Terminal readline-based python client
  • Terminal ncurses python client
  • Netcat client (wtf?)
  • Lispinto Chat: a Flutter client that runs on macOS, Android, iOS and web.

On Python client, I wrote in a way only using ths stdlib avoiding pain to handle the dependency hell, so you can just call that:

$ python client.py

So finally... netcat. Yes! You can even just use netcat! An user called Chris in past days just logged in the server with the following message:

|16:30:37| [Chris]: Used netcad
|16:30:41| [Chris]: netcat*
|16:30:50| [Chris]: bye

So you can type netcat <server> 5558 and go on! I tested on my machine and works fine! The main reason is because the communication between server and client just use raw data. For better synchronization with text data from server while you typing, I suggest you to use a readline wrapper like rlwrap calling as rlwrap netcat <server> 5558.

Releases

Packages

Used by

Contributors

Languages