p2p.js

p2p.js is an open source JavaScript library which provides solution to build peer to peer webapps without hassle powered by auto matchmaking WebRTC. This solve the common issues faced by WebRTC based application developers who are unwilling to deploy the required signaling servers.

p2p.js is designed to be a low level library in a heararchy of p2p libraries. Consequently in order to get more features you need to build abstractions on top provided api or another library.

>DEMO<

Benefit

• ✅ WebRTC auto matchmaking
• ✅ No server required
• ✅ Simple API
• ✅ ESM support

How does it works?

This module manage WebRTC matchmaking automatically based on app id via established public WebTorrent protocol as signaling transport then provides video, audio and data channel. Take a look at the signalingserver.js for more information.

Ideas

• P2P Chat
• P2P File Transfer
• P2P Video Call
• P2P Media Streaming
• P2P Game Multiplayer
• P2P Screen Sharing
• P2P Camera

Install

npm install p2p.js

CDN

• https://esm.sh/p2p.js

<script type="importmap">
{
	"imports": {
		"p2p.js" : "https://esm.sh/p2p.js"
	}
}
</script>

Usage

import {createPeer} from 'p2p.js';

const peers = [];

const config = {
	appid: 'myApp'
}

const peer = createPeer(config);

peer.onPeerConnect((peer_id)=>{
	peers.push(peer_id);
	console.log('connect',peer_id);
});

peer.onPeerDisconnect((peer_id)=>{
	peers.splice(peers.findIndex(item=>item===peer_id),1);
	console.log('disconnect',peer_id);
});

peer.onPeerData((peer_id,data) => {
	console.log(`${peer_id} say : ${new TextDecoder().decode(data)}`);
});

setInterval(()=>{
	const me = peer.getPeerId();
	peers.forEach(peer_id=>peer.sendPeerData(peer_id,`i am ${me}`));
},5000);

API

peer = createPeer(config)

Create a new p2p peer.

config - configuration object :

• appid - custom unique application ID.
• password - optional custom password for session encryption.
• tracker - optional custom WebTorrent tracker list.
• rtcconfig - optional custom RTCPeerConnection configuration object.
• webrtc - custom WebRTC object contains RTCPeerConnection, RTCSessionDescription, RTCIceCandidate.

peer.getPeerId()

Get this peer ID.

peer.getPeers()

Get all peers ID that connected.

peer.destroyPeer()

Destroy and cleanup this peer.

peer.sendPeerData(peer_id,data)

Send data to peer.

peer.addPeerStream(peer_id,stream)

Add a MediaStream to peer.

peer.removePeerStream(peer_id,stream)

Remove a MediaStream from peer.

peer.addPeerTrack(peer_id,track,stream)

Add a MediaStreamTrack to peer.

peer.removePeerTrack(peer_id,track,stream)

Remove a MediaStreamTrack from peer.

peer.replacePeerTrack(peer_id,old_track,new_track,stream)

Replace a MediaStreamTrack with another track.

peer.onPeerConnect((peer_id)=>{})

Listen on new peer connection.

peer.onPeerDisconnect((peer_id)=>{})

Listen on peer disconnection.

peer.onPeerData((peer_id,data)=>{})

Listen on incoming data.

peer.onPeerStream((peer_id,stream)=>{})

Listen on incoming stream.

peer.onPeerTrack((peer_id,track, stream)=>{})

Listen on incoming video/audio track.

peer.onPeerError((peer_id,error)=>{})

Listen on fatal error connection.

TURN

p2p.js works for most WebRTC apps but some network don’t allow peer-to-peer connection. The common way to solve this issue is by using TURN for relaying network traffic. TURN services include free offer among others are Cloudflare and Metered or you can self hosted TURN.

const iceConfiguration = {
    iceServers: [
        {
			urls: 'stun:my-turn-server.mycompany.com:19401'
		},
		{
            urls: 'turn:my-turn-server.mycompany.com:19402',
            username: 'optional-username',
            credential: 'auth-token'
        }
    ]
}

const config = {
	appid: 'myApp',
	rtcconfig : iceConfiguration
}

const peer = createPeer(config);

See Also

• WebPEER - WebPEER is a P2P Network that Runs on Standard Browser.
• signalingserver.js - Alternative WebRTC signaling server that works in browser, no server required.

License

• MIT (2026) Nuzulul Zulkarnain