92 lines
2.0 KiB
Markdown
92 lines
2.0 KiB
Markdown
# Peer Calls
|
|
|
|
[![Build Status][travis-badge]][travis]
|
|
[![NPM Package][npm-badge]][npm]
|
|
|
|
[travis-badge]: https://travis-ci.org/jeremija/peer-calls.svg?branch=master
|
|
[travis]: https://travis-ci.org/jeremija/peer-calls
|
|
[npm-badge]: https://img.shields.io/npm/v/peer-calls.svg
|
|
[npm]: https://www.npmjs.com/package/peer-calls
|
|
|
|
[peer-calls]: https://peercalls.com
|
|
[config]: https://raw.githubusercontent.com/jeremija/peer-calls/master/config/default.json
|
|
|
|
WebRTC peer to peer calls for everyone. See it live in action at
|
|
[peercalls.com][peer-calls].
|
|
|
|
Work in progress.
|
|
|
|
# Requirements
|
|
- Node.js 8 [https://nodejs.org/en/](https://nodejs.org/en/)
|
|
|
|
# Installation & Running
|
|
|
|
## From npm
|
|
|
|
### Local install
|
|
|
|
```bash
|
|
npm install peer-calls
|
|
mkdir config/
|
|
curl -o config/local.json https://raw.githubusercontent.com/jeremija/peer-calls/master/config/default.json
|
|
./node_modules/.bin/peer-calls
|
|
```
|
|
|
|
create directory `./peer-calls` and copy [config/default.json][config] into it.
|
|
|
|
```bash
|
|
npm install --global peer-calls
|
|
|
|
env NODE_CONFIG_DIR=./peer-calls peercalls
|
|
```
|
|
|
|
> :warning: Using `--global` is not advised in server environments. [*](https://github.com/jeremija/peer-calls/pull/48)
|
|
|
|
## From git source
|
|
|
|
```bash
|
|
git clone https://github.com/jeremija/peer-calls.git
|
|
cd peer-calls
|
|
npm install
|
|
|
|
# for production
|
|
npm run build
|
|
npm start
|
|
|
|
# for development
|
|
npm run start:watch
|
|
```
|
|
|
|
To run a development version, type:
|
|
|
|
If you successfully completed the above steps, your commandline/terminal should
|
|
show that your node server is listening.
|
|
|
|
On your other machine or mobile device open the url: http://<your_ip_or_localhost>:3000
|
|
|
|
# Testing
|
|
|
|
```bash
|
|
npm install
|
|
npm test
|
|
```
|
|
|
|
# Browser Support
|
|
|
|
Tested on Firefox and Chrome, including mobile versions.
|
|
|
|
Does not work on iOS 10, but should work on iOS 11 - would appreciate feedback!
|
|
|
|
For more details, see here:
|
|
|
|
- http://caniuse.com/#feat=rtcpeerconnection
|
|
- http://caniuse.com/#search=getUserMedia
|
|
|
|
# Contributing
|
|
|
|
See [Contributing](CONTRIBUTING.md) section.
|
|
|
|
# License
|
|
|
|
[MIT](LICENSE)
|