# PeerJS: Simple peer-to-peer with WebRTC # [![Backers on Open Collective](https://opencollective.com/peer/backers/badge.svg)](#backers) [![Sponsors on Open Collective](https://opencollective.com/peer/sponsors/badge.svg)](#sponsors) PeerJS provides a complete, configurable, and easy-to-use peer-to-peer API built on top of WebRTC, supporting both data channels and media streams. ### [http://peerjs.com](http://peerjs.com) ## Setup **Include the library** with modules: `npm install peerjs` or `yarn add peerjs` and the usage: ```js import Peer from 'peerjs'; ``` **Create a Peer** Get a [free API key](http://peerjs.com/peerserver). Your id only needs to be unique to the namespace of your API key. ```javascript var peer = new Peer('pick-an-id', {key: 'myapikey'}); // You can pick your own id or omit the id if you want to get a random one from the server. ``` ## Data connections **Connect** ```javascript var conn = peer.connect('another-peers-id'); conn.on('open', function(){ conn.send('hi!'); }); ``` **Receive** ```javascript peer.on('connection', function(conn) { conn.on('data', function(data){ // Will print 'hi!' console.log(data); }); }); ``` ## Media calls **Call** ```javascript navigator.getUserMedia = navigator.getUserMedia || navigator.webkitGetUserMedia || navigator.mozGetUserMedia; navigator.getUserMedia({video: true, audio: true}, function(stream) { var call = peer.call('another-peers-id', stream); call.on('stream', function(remoteStream) { // Show stream in some