End of Life for Twilio Programmable Video - Upgrade to VideoSDKLearn More

How to Build Real-time Apps using Socket.IO and WebRTC?

Learn how to build real-time communication applications using Socket.IO and WebRTC. This comprehensive guide covers setup, integration, and practical examples for developers.


In today's fast-paced digital world, real-time communication has become a cornerstone of modern web applications. Whether it's instant messaging, video conferencing, or collaborative tools, users expect seamless and instantaneous interactions. Technologies like Socket.IO and WebRTC play a crucial role in enabling these real-time experiences, providing developers with the tools to build interactive and dynamic applications.

Overview of Socket.IO and WebRTC

Socket.IO and WebRTC are two powerful technologies that, when combined, offer a robust solution for real-time communication.
Socket.IO is a JavaScript library that enables real-time, bidirectional, and event-based communication between web clients and servers. It is built on top of WebSockets and falls back to long polling when necessary, ensuring compatibility across a wide range of environments. Socket.IO simplifies the process of managing connections, broadcasting messages, and handling events, making it an ideal choice for real-time applications.
WebRTC (Web Real-Time Communication), on the other hand, is a technology that allows peer-to-peer communication directly between browsers. It supports video, audio, and data sharing without the need for intermediate servers, making it perfect for applications like video chats, file sharing, and online gaming. WebRTC provides a set of APIs that handle media capture, peer connection, and data channels, enabling high-quality real-time communication.
The synergy between Socket.IO and WebRTC lies in their complementary strengths. While WebRTC handles the actual media and data transfer, Socket.IO serves as the signaling mechanism to establish and manage these peer-to-peer connections. This combination allows developers to create scalable and efficient real-time applications with ease.

Setting Up the Environment

Before diving into the implementation, it's essential to set up the development environment. Here’s what you need:


  • Node.js and npm: Ensure you have Node.js and npm installed. You can download them from


  • Basic JavaScript Knowledge: Familiarity with JavaScript is necessary for this tutorial.

Setting Up a Node.js Project

First, create a new directory for your project and navigate into it:


1mkdir socket-io-webrtc
2cd socket-io-webrtc
3npm init -y
This will create a package.json file with the default settings.

Installing Required Packages

Next, you need to install the required packages. In this project, we'll use express for the server, socket.io for real-time communication, and webrtc-adapter to ensure cross-browser compatibility with WebRTC.


1npm install express socket.io webrtc-adapter

Creating the Server

With the packages installed, you can now create a simple Express server and integrate Socket.IO.

Server Setup

Create a file named server.js and add the following code:


1const express = require('express');
2const http = require('http');
3const socketIo = require('socket.io');
5const app = express();
6const server = http.createServer(app);
7const io = socketIo(server);
9io.on('connection', (socket) => {
10    console.log('a user connected');
11    socket.on('disconnect', () => {
12        console.log('user disconnected');
13    });
16server.listen(3000, () => {
17    console.log('Server is running on port 3000');
This code sets up an Express server and initializes Socket.IO to handle WebSocket connections.

Setting Up WebRTC

WebRTC enables peer-to-peer communication, but it requires a signaling mechanism to exchange connection details between peers. Socket.IO will serve this purpose.

Basic WebRTC Setup

Add the following WebRTC setup code to your client-side JavaScript:


1const localPeerConnection = new RTCPeerConnection();
2const remotePeerConnection = new RTCPeerConnection();
4localPeerConnection.onicecandidate = ({ candidate }) => {
5    if (candidate) {
6        remotePeerConnection.addIceCandidate(candidate);
7    }
10remotePeerConnection.onicecandidate = ({ candidate }) => {
11    if (candidate) {
12        localPeerConnection.addIceCandidate(candidate);
13    }
16// Add additional WebRTC setup steps here
This code creates two RTCPeerConnection objects and sets up handlers to manage ICE candidates, which are necessary for establishing a peer-to-peer connection.

Integrating Socket.IO with WebRTC

Integrating Socket.IO with WebRTC involves using Socket.IO for the signaling process, which exchanges the connection details between peers.

Signaling with Socket.IO

Update the server-side code to handle signaling messages:


1io.on('connection', (socket) => {
2    socket.on('offer', (offer) => {
3        socket.broadcast.emit('offer', offer);
4    });
6    socket.on('answer', (answer) => {
7        socket.broadcast.emit('answer', answer);
8    });
10    socket.on('ice-candidate', (candidate) => {
11        socket.broadcast.emit('ice-candidate', candidate);
12    });
On the client side, add the signaling logic:


1const socket = io.connect();
3localPeerConnection.onicecandidate = ({ candidate }) => {
4    if (candidate) {
5        socket.emit('ice-candidate', candidate);
6    }
9socket.on('ice-candidate', (candidate) => {
10    remotePeerConnection.addIceCandidate(candidate);
13function createOffer() {
14    localPeerConnection.createOffer()
15        .then(offer => {
16            localPeerConnection.setLocalDescription(offer);
17            socket.emit('offer', offer);
18        });
21socket.on('offer', (offer) => {
22    remotePeerConnection.setRemoteDescription(new RTCSessionDescription(offer));
23    remotePeerConnection.createAnswer()
24        .then(answer => {
25            remotePeerConnection.setLocalDescription(answer);
26            socket.emit('answer', answer);
27        });
30socket.on('answer', (answer) => {
31    localPeerConnection.setRemoteDescription(new RTCSessionDescription(answer));
This code handles the signaling process by sending and receiving offers, answers, and ICE candidates via Socket.IO.

Get Free 10,000 Minutes Every Months

No credit card required to start.

Building a Basic Video Chat Application

To create a video chat application, you need to capture video and audio streams and handle their transmission between peers.

Capturing Media Streams

Add the following code to capture and display the video stream:


1navigator.mediaDevices.getUserMedia({ video: true, audio: true })
2    .then((stream) => {
3        document.getElementById('localVideo').srcObject = stream;
4        stream.getTracks().forEach(track => localPeerConnection.addTrack(track, stream));
5    })
6    .catch((error) => {
7        console.error('Error accessing media devices.', error);
8    });
This code accesses the user's media devices and displays the local video stream in a video element with the id localVideo.

Testing and Debugging

Testing Tips

  • Use multiple browser windows or devices to test the application.
  • Check browser console logs for errors and use breakpoints to debug JavaScript code.

Debugging Tools

  • Chrome DevTools: Inspect WebRTC internals and network requests.
  • WebRTC-internals: A tool built into Chrome to debug WebRTC connections.

Advanced Features and Further Reading

Advanced Features

  • Chat Functionality: Add a chat feature alongside video calls.
  • Screen Sharing: Enable users to share their screens.
  • File Transfer: Allow users to send files during the call.

Further Reading


In this article, we have explored the powerful combination of Socket.IO and WebRTC for building real-time communication applications. We started with setting up the development environment, installing the necessary packages, and creating a basic server with Socket.IO. We then delved into setting up WebRTC for peer-to-peer connections and integrated it with Socket.IO for signaling. Finally, we built a simple video chat application, highlighting key steps and providing practical code examples.
By leveraging Socket.IO and WebRTC, developers can create scalable and efficient real-time applications that meet modern web users' demands for instant interaction. This synergy offers a robust foundation for building everything from video conferencing tools to multiplayer games and collaborative platforms.

Want to level-up your learning? Subscribe now

Subscribe to our newsletter for more tech based insights