Light Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

ryukinix/lisp-chat

Repository files navigation

Lisp Chat

An experimental chat irc-like written in Lisp.

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

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.

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 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 5558.

About

An experimental minimal chat written in Common Lisp

Topics

Resources

Readme

License

MIT license

Stars

Watchers

Forks

Packages

Contributors