cryptalk/README.md

108 lines
2.8 KiB
Markdown
Raw Normal View History

2014-09-19 13:59:10 -04:00
![cryptalk](/docs/screenshot.png)
2014-10-20 14:57:50 -04:00
![Build](https://travis-ci.org/Hexagon/cryptalk.svg)
2015-12-29 18:38:05 -05:00
[![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)
2014-10-20 14:57:50 -04:00
2015-12-29 18:38:05 -05:00
Latest release is 1.0.0, available at npm using ```npm install telldus```
2014-10-20 14:37:55 -04:00
Cyptalk is a HTML5/Node.js based, client side (E2EE) encrypted instant chat
2014-09-19 13:59:10 -04:00
Features
2014-09-18 03:24:21 -04:00
========
2014-09-19 14:01:28 -04:00
* 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.
2014-09-19 13:59:10 -04:00
* Optional nicknames
* Quick-links (not recommended!) using http://server/#Room:Passphrase
2014-09-19 13:59:10 -04:00
* Super simple setup
2014-09-20 09:26:43 -04:00
* Notification sounds (mutable)
2014-09-23 14:19:00 -04:00
* Native popup notifications
* Configurable page title
2014-10-20 14:37:55 -04:00
* Heroku support
2014-10-20 14:57:50 -04:00
2014-10-20 14:37:55 -04:00
Heroku setup
========
[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy?template=https://github.com/hexagon/cryptalk)
2014-09-18 13:48:17 -04:00
2014-09-25 04:51:21 -04:00
Regular setup
========
Install node.js, exact procedure is dependant on platform and distribution.
2014-09-25 10:29:04 -04:00
Install the app from npm
2014-09-25 04:51:21 -04:00
```bash
2014-09-25 10:29:04 -04:00
npm install cryptalk -g
2014-09-25 04:51:21 -04:00
````
2014-09-25 10:29:04 -04:00
Then issue the following to start the app
2014-09-25 07:08:11 -04:00
```bash
2014-09-25 10:29:04 -04:00
cryptalk
2014-09-25 07:08:11 -04:00
```
2014-09-25 04:51:21 -04:00
Browse to ```http://localhost:8080```
Done!
2014-10-20 14:37:55 -04:00
2014-09-25 04:51:21 -04:00
Developer setup
2014-09-18 13:48:17 -04:00
========
2014-09-18 17:13:10 -04:00
Install node.js, exact procedure is dependant on platform and distribution.
2014-09-18 13:54:45 -04:00
2014-09-18 13:48:17 -04:00
Clone this repo
2014-09-18 13:54:45 -04:00
```bash
git clone https://github.com/Hexagon/cryptalk.git
cd cryptalk
```
2014-09-18 13:48:17 -04:00
2014-09-24 06:28:55 -04:00
Pull dependencies from npm
2014-09-18 13:54:45 -04:00
```bash
2014-09-24 06:28:55 -04:00
npm install
2014-09-18 13:54:45 -04:00
```
2014-09-18 13:48:17 -04:00
2014-09-18 13:54:45 -04:00
Start server
```bash
node server.js
```
2014-09-18 13:48:17 -04:00
2014-09-19 13:59:10 -04:00
Browse to ```http://localhost:8080```
2014-09-19 14:05:30 -04:00
Usage
========
```
2014-09-23 14:19:00 -04:00
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
2014-09-25 17:46:15 -04:00
Room:
2014-09-23 14:19:00 -04:00
/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.
2014-09-21 08:20:25 -04:00
2014-09-19 14:05:30 -04:00
```