Giter VIP home page Giter VIP logo

suryatmodulus / mirotalksfu Goto Github PK

View Code? Open in Web Editor NEW

This project forked from miroslavpejic85/mirotalksfu

0.0 1.0 0.0 3.38 MB

๐Ÿ† WebRTC - SFU - Simple, Secure, Scalable Real-Time Video Conferences Up to 4k, compatible with all browsers and platforms.

Home Page: https://sfu.mirotalk.org

License: GNU Affero General Public License v3.0

Shell 0.05% JavaScript 85.71% Python 0.08% PHP 0.12% CSS 4.51% HTML 9.47% Dockerfile 0.07%

mirotalksfu's Introduction

MiroTalk SFU

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
Presentation

MiroTalk presentation - video

Quick Start
  • You will need to have NodeJS and all requirements installed, this project has been tested with Node versions 12.X - 14.X - 16.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 16.X and npm
$ apt install -y curl dirmngr apt-transport-https lsb-release ca-certificates
$ curl -sL https://deb.nodesource.com/setup_16.x | bash -
$ apt-get install -y nodejs
$ npm install -g npm@latest
  • 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 - be patient, the first time will take a few minutes, in the meantime have a good coffee ;)
$ npm install
# Start the server
$ npm start
Docker
# 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 - be patient, the first time will take a few minutes, in the meantime have a good coffee ;)
$ docker-compose build
# Create and start containers
$ docker-compose up # -d
# Stop and remove resources
$ docker-compose down
Https

You can start videoconferencing directly from your Local PC, and be reachable from any device outside your network, simply by following these steps.

Self Host

Change the announcedIp with your Server public IPv4 on app/src/config.js:

{
    ip: '0.0.0.0',
    announcedIp: 'Server Public IPv4', // 'xx.xxx.xxx.xx'
}

Set the inbound rules:

Port range Protocol Source Description
3010 TCP 0.0.0.0/0 App listen on tcp
40000-40100 TCP 0.0.0.0/0 RTC port ranges tcp
40000-40100 UDP 0.0.0.0/0 RTC port ranges udp
Notes
  • Run the project on a Linux or Mac system as the mediasoup installation could have issues on Windows.
Rest API
# 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","screen":"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","screen":"0","notify":"0"}'
Direct Join
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 [email protected]

DigitalOcean Referral Badge

Live Demo

https://sfu.mirotalk.org

mirotalksfu-qr

Credits
Contributing
  • Contributions are welcome and greatly appreciated!
  • Just run before npm run lint
Discussions and support
  • For discussions, help & support, join with us on Discord
License

AGPLv3

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 [email protected].

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

BroadcastX


MiroTalk P2P

Try also MiroTalk P2P, the difference between the two projects you can found here.

mirotalksfu's People

Contributors

iconio avatar loranger avatar miroslavpejic85 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.