Pion WebRTC

A Golang implementation of the WebRTC API

See DESIGN.md for an overview of features and future goals.

Install

Currently Pion uses CGO and OpenSSL for DTLS. We are actively working on replacing it. For now you have to make sure to install a C compliler and the OpenSSL headers for your platform:

Ubuntu/Debian

sudo apt-get install libssl-dev

OSX

brew install openssl
export CPATH=`brew --prefix`/opt/openssl/include
export LIBRARY_PATH=`brew --prefix`/opt/openssl/lib
go get -u github.com/pions/webrtc

Fedora

sudo yum install openssl-devel

Windows

Install MSYS2
Download pkg-config-lite and put pkg-config.exe on the PATH environment variable.
From the MSYS2 console: Run pacman -S mingw-w64-x86_64-openssl to install OpenSSL.
From the MSYS2 console: Run pacman -S mingw-w64-x86_64-gcc to install the C compiler.
Set the PKG_CONFIG_PATH environment variable. ie. Run the following from the Windows console: SETX PKG_CONFIG_PATH C:\msys64\mingw64\lib\pkgconfig, That folder should contain openssl.pc.

Usage

Check out the example applications to help you along your Pion WebRTC journey.

The Pion WebRTC API closely matches the JavaScript WebRTC API. Most existing documentation is therefore also usefull when working with Pion. Furthermore, our GoDoc is actively maintained.

Now go forth and build some awesome apps! Here are some ideas to get your creative juices flowing:

Send a video file to multiple browser in real time for perfectly synchronized movie watching.
Send a webcam on an embedded device to your browser with no additional server required!
Securely send data between two servers, without using pub/sub.
Record your webcam and do special effects server side.
Build a conferencing application that processes audio/video and make decisions off of it.

Roadmap

The library is in active development, please refer to the roadmap to track our major milestones.

Community

Pion has an active community on the Golang Slack. Sign up and join the #pion channel for discussions and support. You can also use Pion mailing list.

We are always looking to support your projects. Please reach out if you have something to build!

If you need commercial support or don't want to use public methods you can contact us at team@pion.ly

Related projects

pions/turn: A simple extendable Golang TURN server
[WIP] pions/media-server: A Pion WebRTC powered media server, providing the building blocks for anything RTC.
[WIP] pions/dcnet: A package providing Golang net interfaces around Pion WebRTC data channels.

Contributing

Check out the contributing wiki to join the group of amazing people making this project possible:

John Bradley - Original Author
Michael Melvin Santry - Mascot
Raphael Randschau - STUN
Sean DuBois - Original Author
Michiel De Backker - SDP, Public API, Project Management
Brendan Rius - Cleanup
Konstantin Itskov - SDP Parsing
chenkaiC4 - Fix GolangCI Linter
Ronan J - Fix STCP PPID
wattanakorn495
Max Hawkins - RTCP
Justin Okamoto - Fix Docs
leeoxiang - Implement Janus examples
Denis - Adding docker-compose to pion-to-pion example
earle - Generate DTLS fingerprint in Go
Jake B - Fix Windows installation instructions
Michael MacDonald

License

MIT License - see LICENSE.md for full text

Name		Name	Last commit message	Last commit date
Latest commit History 428 Commits
.github		.github
examples		examples
internal		internal
pkg		pkg
.codacy.yaml		.codacy.yaml
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
.golangci.yml		.golangci.yml
.travis.yml		.travis.yml
CONTRIBUTING.md		CONTRIBUTING.md
DESIGN.md		DESIGN.md
LICENSE		LICENSE
README.md		README.md
errors.go		errors.go
go.mod		go.mod
go.sum		go.sum
media.go		media.go
mediaengine.go		mediaengine.go
rtcbundlepolicy.go		rtcbundlepolicy.go
rtcbundlepolicy_test.go		rtcbundlepolicy_test.go
rtccertificate.go		rtccertificate.go
rtccertificate_test.go		rtccertificate_test.go
rtcconfiguration.go		rtcconfiguration.go
rtcconfiguration_test.go		rtcconfiguration_test.go
rtcdatachannel.go		rtcdatachannel.go
rtcdatachannel_test.go		rtcdatachannel_test.go
rtcdatachannelinit.go		rtcdatachannelinit.go
rtcdatachannelstate.go		rtcdatachannelstate.go
rtcdatachannelstate_test.go		rtcdatachannelstate_test.go
rtcdtlsfingerprint.go		rtcdtlsfingerprint.go
rtcdtlstransport.go		rtcdtlstransport.go
rtcdtlstransportstate.go		rtcdtlstransportstate.go
rtcdtlstransportstate_test.go		rtcdtlstransportstate_test.go
rtcicecandidatetype.go		rtcicecandidatetype.go
rtcicecandidatetype_test.go		rtcicecandidatetype_test.go
rtcicecomponent.go		rtcicecomponent.go
rtcicecomponent_test.go		rtcicecomponent_test.go
rtciceconnectionstate.go		rtciceconnectionstate.go
rtciceconnectionstate_test.go		rtciceconnectionstate_test.go
rtcicecredentialtype.go		rtcicecredentialtype.go
rtcicecredentialtype_test.go		rtcicecredentialtype_test.go
rtcicegatheringstate.go		rtcicegatheringstate.go
rtcicegatheringstate_test.go		rtcicegatheringstate_test.go
rtciceprotocol.go		rtciceprotocol.go
rtciceprotocol_test.go		rtciceprotocol_test.go
rtcicerole.go		rtcicerole.go
rtcicerole_test.go		rtcicerole_test.go
rtciceserver.go		rtciceserver.go
rtciceserver_test.go		rtciceserver_test.go
rtcicetransport.go		rtcicetransport.go
rtcicetransportpolicy.go		rtcicetransportpolicy.go
rtcicetransportpolicy_test.go		rtcicetransportpolicy_test.go
rtcoauthcredential.go		rtcoauthcredential.go
rtcofferansweroptions.go		rtcofferansweroptions.go
rtcpeerconnection.go		rtcpeerconnection.go
rtcpeerconnection_test.go		rtcpeerconnection_test.go
rtcpeerconnectionstate.go		rtcpeerconnectionstate.go
rtcpeerconnectionstate_test.go		rtcpeerconnectionstate_test.go
rtcprioritytype.go		rtcprioritytype.go
rtcprioritytype_test.go		rtcprioritytype_test.go
rtcrtcpmuxpolicy.go		rtcrtcpmuxpolicy.go
rtcrtcpmuxpolicy_test.go		rtcrtcpmuxpolicy_test.go
rtcrtpreceiver.go		rtcrtpreceiver.go
rtcrtpsender.go		rtcrtpsender.go
rtcrtptranceiver.go		rtcrtptranceiver.go
rtcrtptransceiverdirection.go		rtcrtptransceiverdirection.go
rtcrtptransceiverdirection_test.go		rtcrtptransceiverdirection_test.go
rtcsctptransport.go		rtcsctptransport.go
rtcsctptransportstate.go		rtcsctptransportstate.go
rtcsctptransportstate_test.go		rtcsctptransportstate_test.go
rtcsdptype.go		rtcsdptype.go
rtcsdptype_test.go		rtcsdptype_test.go
rtcsessiondescription.go		rtcsessiondescription.go
rtcsessiondescription_test.go		rtcsessiondescription_test.go
rtcsignalingstate.go		rtcsignalingstate.go
rtcsignalingstate_test.go		rtcsignalingstate_test.go

License

calebdoxsey/webrtc

Folders and files

Latest commit

History