cryptalk/README.md

108 lines
2.8 KiB
Markdown

![cryptalk](/docs/screenshot.png)
![Build](https://travis-ci.org/Hexagon/cryptalk.svg)
[![npm version](https://badge.fury.io/js/cryptalk.svg)](https://badge.fury.io/js/cryptalk)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
Latest release is 1.0.0, available at npm using ```npm install telldus```
Cyptalk 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
* Message is torched after a configurable delay, default is 600s.
* Optional nicknames
* Quick-links (not recommended!) using http://server/#Room:Passphrase
* Super simple setup
* Notification sounds (mutable)
* Native popup notifications
* Configurable page title
* Heroku support
Heroku setup
========
[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy?template=https://github.com/hexagon/cryptalk)
Regular setup
========
Install node.js, exact procedure is dependant on platform and distribution.
Install the app from npm
```bash
npm install cryptalk -g
````
Then issue the following to start the app
```bash
cryptalk
```
Browse to ```http://localhost:8080```
Done!
Developer setup
========
Install node.js, exact procedure is dependant on platform and distribution.
Clone this repo
```bash
git clone https://github.com/Hexagon/cryptalk.git
cd cryptalk
```
Pull dependencies from npm
```bash
npm install
```
Start server
```bash
node server.js
```
Browse to ```http://localhost:8080```
Usage
========
```
Available commands:
Client:
/key StrongPassphrase Sets encryption key
/nick NickName Sets an optional nick
/mute Audio on
/unmute Audio off
/clear Clear on-screen buffer
/help This
/title Set your local page title
Room:
/join RoomId Join a room
/leave Leave the room
/count Count participants
Host:
/hosts List available hosts
/connect HostIndex Connect to selected 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.
```