Skip to content

HadrienBoyer/LaCrypte

Repository files navigation

LaCrypte

Node.js CI npm version License Codacy Badge

LaCrypte

LaCrypte is a HTML5/Node.js based, client side (E2EE) encrypted instant chat

Features

  • Client side AES-256-CBC encryption/decryption (the server is just a messenger)
  • 256 bit key derived from your passphrase using PBKDF2
  • Messages torched after a configurable delay, default is 600s.
  • Simple setup using npm, Docker or Heroku
  • Notification sounds (mutable)
  • Native popup notifications
  • Configurable page title
  • Nicknames, optional.
  • Quick-links using http://server/#Room:Passphrase, optional and insecure

Installing

Docker setup

To run latest LaCrypte with docker, exposed on host port 80, simply run the following command to pull it from docker hub

sudo docker run -d --restart=always -p 80:8080 HadrienBoyer/LaCrypte

Heroku setup

Click the button below

Deploy

Docker setup without using docker hub

Clone this repo, enter the new directory.

Build image

docker build . --tag="HadrienBoyer/LaCrypte"

Run container, enable start on boot, expose to port 80 at host

sudo docker run -d --restart=always -p 80:8080 HadrienBoyer/LaCrypte

Browse to http://<ip-of-server>/

Done!

npm setup

Install node.js, exact procedure is dependant on platform and distribution.

Install the app from npm

npm install LaCrypte -g

Then issue the following to start the app

LaCrypte

Browse to http://localhost:8080

Done!

Usage


Available commands:

\\ Client:
	/key		<your-strong-passphrase>	Sets encryption key
	/nick		<your-pseudo>				Sets an nickname (optional)
	/title									Set your local page title
	/mute  									Audio off
	/unmute  								Audio on
	/clear									Clear on-screen buffer
	/help									You are here :)
	/torch		<after-x-seconds>			Console messages are torched
											after this amount of seconds
											(default 600).

\\ Room:
	/join		<room-id>					Join a room
	/count									Count participants
	/leave									Leave the room

\\ Host:
	/connect						Connect to host
	/disconnect						Disconnect from host

You can select any of the five last commands/messages with up/down key.

Due to security reasons, /key command is not saved, and command
history is  automatically cleared after one minute of inactivity.

It is highly recommended to use incognito mode while chatting,
to prevent browsers from keeping history or cache.


Development

Install node.js (development require >=12.0), exact procedure is dependant on platform and distribution.

Clone this repo

git clone https://github.com/HadrienBoyer/LaCrypte.git
cd LaCrypte

Pull dependencies from npm

npm install

Start server

npm run start

Browse to http://localhost:8080

To work on the JavaScript, edit the code in client/source/. To test the changes, first run npm run build to lint, build and minify the code. Then restart the server.