cryptalk/README.md

102 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2014-09-19 13:59:10 -04:00
![cryptalk](/docs/screenshot.png)
Cyptalk is a HTML5/Node.js based encrypted instant chat
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
2014-09-19 13:59:10 -04:00
* Optional nicknames
* Random (UUID v4) channel name generation för less guessability
* Quick-links (not recommended) using http://server/#Room:Passphrase
* 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-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.
Create a now folder, browse to it, and install the app from npm
```bash
npm install cryptalk
````
2014-09-25 07:08:11 -04:00
Then, from the same folder, issue the following to start the app
```bash
npm start cryptalk
```
2014-09-25 04:51:21 -04:00
Browse to ```http://localhost:8080```
Done!
2014-09-25 07:08:11 -04:00
If you want to install it globally, you'll have to append ```-g``` to both the install line, and the start line.
```bash
npm install cryptalk -g
npm start cryptalk -g
```
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
Room:
/generate Generate random 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.
2014-09-21 08:20:25 -04:00
2014-09-19 14:05:30 -04:00
```