Code Monkey home page Code Monkey logo

livekit's Introduction

LiveKit - Open source, high performance WebRTC infrastructure

LiveKit is an open source project that provides scalable, multi-user conferencing over WebRTC. It's designed to give you everything you need to build real time video/audio/data capabilities in your applications.

LiveKit is written in Go, using the awesome Pion WebRTC implementation.

Features

  • Scalable, distributed WebRTC SFU (Selective Forwarding Unit)
  • Modern, full-featured client SDKs
  • Built for production - JWT authentication and server APIs
  • Robust networking & connectivity. UDP/TCP/TURN
  • Easy to deploy - single binary, docker & kubernetes
  • Advanced features - speaker detection, simulcast, selective subscription, moderation APIs, and webhooks.

Documentation & Guides

Docs & Guides at: https://docs.livekit.io

Try it live

Head to our playground and give it a spin. Build a Zoom-like conferencing app in under 100 lines of code!

SDKs & Tools

Client SDKs:

Server SDKs:

Tools:

Quickstart

Generate config file and keys

docker run --rm -v$PWD:/output livekit/generate --local

The above command generates a livekit.yaml you can use to start LiveKit. It'll contain an API key/secret pair you can use with your LiveKit install.

Starting with docker

docker run --rm -p 7880:7880 \
    -p 7881:7881 \
    -p 7882:7882/udp \
    -v $PWD/livekit.yaml:/livekit.yaml \
    livekit/livekit-server \
    --config /livekit.yaml \
    --node-ip <machine-ip>

When running with docker, --node-ip needs to be set to your machine's IP address. If the service will be exposed to the public Internet, this should the machine's public IP.

Test with example app

Head over to the example app and enter the generated token to connect to your LiveKit server. This app is built with our React SDK.

Once connected, your video and audio are now published to your new LiveKit instance!

Generating access tokens (JWT)

To add more users to a room, you'll have to create a token for each participant. Learn more about access tokens.

livekit-server provides a convenient sub-command to create a development token. This token has an expiration of a month, which is useful for development and testing, but not appropriate for production use.

docker run --rm -e LIVEKIT_KEYS="<api-key>: <api-secret>" \
    livekit/livekit-server create-join-token \
    --room "<room-name>" \
    --identity "<participant-identity>"

Deploying to server

Deployment Docs: https://docs.livekit.io/deploy/

Single node server

Use our deploy config generator to set up a single node deployment with automatic TLS termination and built-in TURN.

It includes a cloud-init/setup script that's supported by most cloud environments.

docker run --rm -it -v$PWD:/output livekit/generate

Kubernetes

We publish a helm chart that helps you to set up a cluster with high availability. For detailed instructions, see Kubernetes guide

Testing your deployment

Use the connection tester to ensure your installation is set up properly for user traffic.

Building from source

Pre-requisites:

  • Go 1.15+ is installed
  • GOPATH/bin is in your PATH

Then run

git clone https://github.com/livekit/livekit
cd livekit
./bootstrap.sh
mage

Contributing

We welcome your contributions to make LiveKit better! Please join us on Slack to discuss your ideas and/or submit PRs.

License

LiveKit server is licensed under Apache License v2.0.

livekit's People

Contributors

davidzhao avatar boks1971 avatar frostbyte73 avatar cnderrauber avatar shishirng avatar matkam avatar ashellunts avatar hn8 avatar dsa avatar theomonnom avatar bekriebel avatar real-danm avatar slzeroth avatar lukasio avatar avvertix avatar alindeman avatar juneezee avatar furqanrydhan avatar tinyakov avatar noahlt avatar ramakrishnachilaka avatar ronnieeeeee avatar b20132367 avatar sibis 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.