https://github.com/dletta/webrtc-mesh
Library to Mesh webRTC clients
https://github.com/dletta/webrtc-mesh
meething mesh p2p-network webrtc
Last synced: 2 months ago
JSON representation
Library to Mesh webRTC clients
- Host: GitHub
- URL: https://github.com/dletta/webrtc-mesh
- Owner: Dletta
- Created: 2020-11-08T04:06:54.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-12-16T06:03:01.000Z (over 4 years ago)
- Last Synced: 2025-03-18T16:45:47.179Z (2 months ago)
- Topics: meething, mesh, p2p-network, webrtc
- Language: JavaScript
- Homepage:
- Size: 80.1 KB
- Stars: 14
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# webrtc-mesh
** BETA Release API in the work, Subject to Change **
## What does it do??
### Prerequisite Disclaimer
WebRTC allows direct communication between RTC capable Peers (usually browser to browser), thanks to the modern Robinhood Style of
Coding (aka take from the geniuses and give to the masses) we can make node talk to webRTC peers. (Shoutout to my dependency contributors @theturtle32, @markandrus and @modeswitch)
### The sauce
Using **your** websocket signaling server (echo server to all connected peers for sdp exchange) do automagically connect all clients running this lib with a network of datachannels
## API - Beta
### Initialize
```javascript
const Mesh = require('webrtc-mesh').Mesh;
var config = {
url: 'wss:websocket.url.server:port/',
key: 'appKey or Token for message filtering', //optional, default is 'mesh'
debug: false, //optional, default is false
}
var mesh = Mesh(config);
mesh.pipe( (ev) => { //handle incoming data
console.log('we got some data from another peer', ev.data)
});
mesh.sendToAll( arrayBuffer(12) ) // or even just 'string of Json'
```
### Initialize as Stream
```javascript
var Mesh = require('webrtc-mesh').Mesh;
var config = {
url: 'wss:websocket.url.server:port/',
key: 'appKey or Token for message filtering', //optional, default is 'mesh'
debug: false, //optional, default is false
}
var mesh = Mesh(config)
var meshedStream = mesh.getStream();
mesh.pipe(meshedStream.push.bind(meshedStream));
process.stdin.pipe(meshedStream).pipe(process.stdout);
```
### Utilities
```javascript
mesh.getPeerList() // returns a map of connected Peers with KEY: peerID Value: object with {status:connectionStatus, conn:reference to Peer Connection, channel: reference to data channel}
mesh.getPeer(peerId) // returns a specific peer from the map
mesh.getPeerId() //return your peerId
mesh.printPeers() // console print for quick check against connection status
mesh.sendToAll(buffer || blob || string) //send to all peers
mesh.onNewPeer( function ) // register a function to receive the 'onOpen' event of a new data channel
```