Free WebRTC - SFU - Simple, Secure, Scalable Real-Time Video Conferences Up to 4k, compatible with all browsers and platforms.
Features
- Is
100% Free
-Open Source
-Self Hosted
- No download, plug-in or login required, entirely browser-based
- Unlimited number of conference rooms, without call time limitation
- Desktop and Mobile compatible
- Optimized Room URL Sharing (share it to your participants, wait for them to join)
- Possibility to Password protect the Room for the meeting
- Webcam Streaming up to 4K quality (Front - Rear for mobile)
- Echo cancellation and noise suppression that makes your audio crystal clear
- Screen Sharing to present documents, slides, and more ...
- File Sharing, share any files to your participants in the room
- Take a snapshot from the video frame(screen/cam) to save it as an image on your device.
- Chat with Emoji Picker to show you feeling and the possibility to Save the conversations
- Speech recognition, execute the app features simply with your voice.
- Advance collaborative whiteboard for the teachers
- Select Microphone - Speaker and Video source
- Recording your Screen, Audio, or Video
- Share any YouTube video in real-time to your participants
- Full-Screen Mode on mouse click on the Video element
- Possibility to Change UI Themes
- Possibility to protect your Host with username and password (default disabled)
- Supports REST API (Application Programming Interface)
- Sentry error reporting
Quick Start
-
You will need to have
NodeJS
and all requirements installed, this project has been tested with Node version 12.X and 14.X. -
Requirements install example for
Ubuntu 20.04
# Gcc g++ make
$ apt-get update
$ apt-get install -y build-essential
# Python 3.8 and pip
$ DEBIAN_FRONTEND=noninteractive apt-get install -y tzdata
$ apt install -y software-properties-common
$ add-apt-repository ppa:deadsnakes/ppa
$ apt update
$ apt install -y python3.8 python3-pip
# NodeJS 14.X and npm
$ apt install -y curl dirmngr apt-transport-https lsb-release ca-certificates
$ curl -sL https://deb.nodesource.com/setup_14.x | bash -
$ apt-get install -y nodejs
- Start the server
# Clone this repo
$ git clone https://github.com/miroslavpejic85/mirotalksfu.git
# Go to to dir mirotalksfu
$ cd mirotalksfu
# Copy app/src/config.template.js in app/src/config.js and edit it if needed
$ cp app/src/config.template.js app/src/config.js
# Install dependencies
$ npm install
# Start the server
$ npm start
- Open https://localhost:3010 in browser
Docker
- Install docker engine: https://docs.docker.com/engine/install/
- Install docker compose: https://docs.docker.com/compose/install/
# Copy app/src/config.template.js in app/src/config.js and edit it if needed
$ cp app/src/config.template.js app/src/config.js
# Copy docker-compose.template.yml in docker-compose.yml and edit it if needed
$ cp docker-compose.template.yml docker-compose.yml
# Build or rebuild services
$ docker-compose build
# Create and start containers
$ docker-compose up # -d
# Stop and remove resources
$ docker-compose down
- Open https://localhost:3010 in browser
Notes
- Run the project on a
Linux or Mac
system as themediasoup
installation could have issues onWindows
.
Rest API
- The API documentation uses swagger at https://localhost:3010/api/v1/docs or check it on live here.
# The response will give you a entrypoint / Room URL for your meeting.
$ curl -X POST "http://localhost:3010/api/v1/meeting" -H "authorization: mirotalksfu_default_secret" -H "Content-Type: application/json"
$ curl -X POST "https://sfu.mirotalk.org/api/v1/meeting" -H "authorization: mirotalksfu_default_secret" -H "Content-Type: application/json"
# The response will give you a entrypoint / URL for the direct join to the meeting.
$ curl -X POST "http://localhost:3010/api/v1/join" -H "authorization: mirotalksfu_default_secret" -H "Content-Type: application/json" --data '{"room":"test","name":"mirotalksfu","audio":"0","video":"0","notify":"0"}'
$ curl -X POST "https://sfu.mirotalk.org/api/v1/join" -H "authorization: mirotalksfu_default_secret" -H "Content-Type: application/json" --data '{"room":"test","name":"mirotalksfu","audio":"0","video":"0","notify":"0"}'
Direct Join
-
You can
join
directly toroom
by going to -
https://sfu.mirotalk.org/join?room=test&name=mirotalksfu&audio=0&video=0¬ify=0
Params Type Description room string room Id name string user name audio boolean enable / disable video boolean enable / disable notify boolean enable / disable
Embed a meeting
Embedding a meeting into a service or app using an iframe.
<iframe
allow="camera; microphone; fullscreen; display-capture; autoplay"
src="https://sfu.mirotalk.org/newroom"
style="height: 100%; width: 100%; border: 0px;"
></iframe>
DigitalOcean
This application is running just for demonstration purposes
on DigitalOcean droplet Ubuntu 20.04 (LTS) x64 [1 vCPU - 1GB Ram]
, with Ngnix and Let's Encrypt.
If you want to deploy a MiroTalk SFU
instance on your dedicated droplet
, or for other needs, don't hesitate to contact us at sfu.mirotalk@gmail.com
Https
You can start videoconferencing directly from your Local PC, and be reachable from any device outside your network, simply by following these steps.
Contributing
- Contributions are welcome and greatly appreciated!
- Just run before
npm run lint
License
MiroTalk is free and can be modified and forked. But the conditions of the AGPLv3 (GNU Affero General Public License v3.0) need to be respected. In particular modifications need to be free as well and made available to the public. Get a quick overview of the license at Choose an open source license.
For a MiroTalk license under conditions other than AGPLv3, please contact us at info.mirotalk@gmail.com.
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.