Home

Awesome

Friends

P2P chat powered by the Web.

travis david javascript style guide

screenshot

This project is alpha quality. You probably only want to use this if you like to send pull requests fixing things :)

How it works

See our site or the gh-pages branch.

Install

Prerequisites

You'll need Node.js (>= 4) and npm (>= 2.8.3).

Build

Clone the source locally:

$ git clone https://github.com/moose-team/friends
$ cd friends

Install project dependencies:

$ npm install

Compile leveldown for electron:

$ npm run rebuild-leveldb

If you are not on 64-bit architecture, you will have to modify the command in package.json:

"rebuild-leveldb": "cd node_modules/leveldown && set HOME=~/.electron-gyp && node-gyp rebuild --target=$(../../version.js) --arch=x64 --dist-url=https://atom.io/download/atom-shell"

to use --arch=ia32.

Usage

GitHub Login

Friends currently uses your git and github configuration for authentication.

If you don't already have a public key on GitHub and corresponding private key on your machine, you'll need to set that up first. Make sure your github username is also set, using git config --global github.user yourusername.

If you're having trouble getting this part to work, do this to get debug information:

$ npm i github-current-user -g
$ DEBUG=* github-current-user

and then report an issue.

Note: DSA keys are not supported. You should switch to RSA anyway for security reasons.

If it can't verify you, try doing ssh-add ~/.ssh/id_rsa. Your key should show up when you run ssh-add -l.

Run

To run from the command line, execute npm start.

To create a distributable app, run npm run package.

Contributing

Contributions welcome! Please read the contributing guidelines before getting started.

License

MIT