kaiwa/README.md

51 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2015-04-07 10:12:28 -04:00
# Kaiwa
2013-08-20 13:50:41 -04:00
2015-04-09 09:59:44 -04:00
Kaiwa is an open source web client for XMPP.
2015-04-15 04:30:40 -04:00
Kaiwa is a fork of Otalk, a prototype application created by &yet (https://github.com/otalk for more code).
2013-08-20 13:50:41 -04:00
2015-04-09 09:59:44 -04:00
![Screenshot](http://getkaiwa.com/assets/img/header.png)
2013-12-31 14:24:13 -05:00
## Installing
2015-04-07 10:12:28 -04:00
git clone https://github.com/digicoop/kaiwa.git
cd kaiwa
2015-09-09 20:02:03 -04:00
Ubuntu
2015-09-09 19:50:27 -04:00
sudo apt-get install uuid-dev
2015-09-09 20:02:03 -04:00
CentOS
sudo yum install libuuid-devel libicu-devel
2015-09-09 20:02:28 -04:00
Then
2013-12-31 14:24:13 -05:00
npm install
cp dev_config.example.json dev_config.json
2013-12-31 14:24:13 -05:00
node server
2015-04-08 08:44:52 -04:00
You will need an XMPP server to use Kaiwa. We provide one at [Kaiwa server](https://github.com/digicoop/kaiwa-server).
2013-12-31 14:24:13 -05:00
2015-04-07 10:12:28 -04:00
*Note:* If you're running your own XMPP server, and aren't using something like HAProxy to terminate SSL, then you might get errors in certain browsers trying to establish a WebSocket connection because the XMPP server is requesting an optional client certificate which makes the browser terminate the socket. To resolve that, visit the XMPP over Websocket URL directly (eg, example.com:5281/xmpp-websocket for Prosody) so that a client cert choice can be made. After that, the Kaiwa client should connect fine.
2013-12-31 14:24:13 -05:00
2013-10-17 19:17:33 -04:00
## What's included?
2013-08-20 13:50:41 -04:00
2015-04-07 10:12:28 -04:00
Kaiwa comes with support for:
2013-06-03 18:51:30 -04:00
2013-10-17 19:17:33 -04:00
### Message History Syncing
2015-04-08 20:49:14 -04:00
Using Message Archive Management (MAM, [XEP-0313](http://xmpp.org/extensions/xep-0313.html)), your conversations can be archived by your server and pulled down by the Kaiwa client on demand.
2013-10-17 19:17:33 -04:00
### Active Chat Syncing
2015-04-07 10:12:28 -04:00
Ever used multiple IM clients at once, or swapped clients, and end up with disjointed conversations? Using Message Carbons [(XEP-0280)](http://xmpp.org/extensions/xep-0280.html) all of your active conversations will be synced to your Kaiwa client (and vice versa if you other clients support carbons too).
2013-10-17 19:17:33 -04:00
### Reliable Connections
Sometimes you just lose your Internet connection, but with Stream Mangagement [XEP-0198](http://xmpp.org/extensions/xep-0198.html) your current session can be instantly resumed and caught up once you regain connection. Your messages will show as gray until they've been confirmed as received by your server.
### Message Correction
Made a typo in a message? Using Message Correction [XEP-0308](http://xmpp.org/extensions/xep-0308.html) you can just double tap the up arrow to edit and send a corrected version. In other clients that support correction, your last message will be updated in place and marked as edited.
### Timezone Indications
2015-04-07 10:12:28 -04:00
Working with someone in a different timezone? If the other person is using Kaiwa or another client that supports Entity Time ([XEP-0202](http://xmpp.org/extensions/xep-0202.html)) you'll see a reminder that they're 9 hours away where it's 4am and they're not likely to respond.