descriptionHaskell implementation of the talkat real-time text protocol
homepage URLhttps://mbays.sdf.org/htalkat/
ownermbays+htalkat@sdf.org
last changeSat, 20 Apr 2024 00:00:00 +0000 (20 00:00 +0000)
content tags
add:
README.md

htalkat: Haskell client and server for talkat (Talk Across TLS)

Building from source

Install the haskell package manager cabal, and the ncurses library and headers; e.g. on a debian system:

$ sudo apt-get install cabal-install libncursesw5-dev

Then in the htalkat directory, run:

$ cabal update && cabal install

The resulting binary will be installed by default as ~/.cabal/bin/htalkat.

Compile-time options

Basic usage

# Create your cryptographic identity:
htalkat i
# Connect to a talkat URI:
htalkat c talkat:1fb3034c92e2b5d32f78739995abf31b@example.invalid
# Give it a short name:
htalkat n talkat:1fb3034c92e2b5d32f78739995abf31b@example.invalid bob
htalkat c bob

# Host your own talkat server; by default this will run on port 5518.
htalkat l
# Wait for someone to connect, then answer:
htalkat a

# Get further help
htalkat h

Configuration

After first run, you can edit ~/.htalkat/htalkat.conf for general configuration options, and ~/.htalkat/notify.sh to set how the server notifies you of incoming connections.

Portability

htalkat was written with POSIX systems in mind, and has only been tested on them, but it may also be possible to compile and run it on Windows. Please let me know if you try.

-- mbays@sdf.org

shortlog
7 days ago mbaysbump 0.1.2.5master
7 days ago mbaysbump upper bounds, including to <tls-2.1
2024-01-26 mbaysbump 0.1.2.4
2024-01-26 mbaysbump upper bounds; move from cryptonite to crypton
2023-07-22 mbaysbump 0.1.2.3
2023-07-22 mbaysclarify Makefile
2023-07-22 mbayshlint
2023-07-08 mbaysbump bytestring upper bound
2023-06-18 mbaysfix path to config file in help
2023-06-18 mbaysbump memory upper bound
2022-08-14 mbaysbump 0.1.2.2
2022-08-14 mbayseta reduce
2022-08-14 mbaysfix pkgconfig-depends
2022-06-06 mbaysbump tls upper bound
2022-05-15 mbaysbump 0.1.2.1
2022-05-15 mbaysadd Setup.hs
...
heads
7 days ago master