Skip to content

Running and Testing

Robert Swain edited this page Jul 23, 2015 · 3 revisions

If you're looking at this, you've hopefully built everything and you're itching to start using OpenWebRTC. There are a few possibilities for getting started actually testing and using OpenWebRTC...

Once you're set up, take a look at the test app page for some links to WebRTC test apps you can use to try it all out.

The daemon

With the daemon method, you can use OpenWebRTC with any existing browser. The video rendering performance will be suboptimal with this setup, but it is very useful for testing purposes to be able to use entirely standard web browsers.

Step 1 - Installing a Browser Extension

Safari

Currently we only provide a Safari extension, just download and double-click the downloaded file to install in Safari.

Safari gUM screenshot

If you want to modify the extension you need to use the Extension Builder in Safari:

Safari screenshot

Firefox and Chrome

Even though Firefox and Chrome already have WebRTC support, you may want to use OpenWebRTC as a backend. You should be able to use Greasemonkey with Firefox or Tampermonkey with Chrome to load a user script and quite easily inject code like this:

var script = document.createElement("script");
script.src = "http://localhost:10717/owr.js";
document.head.appendChild(script);

Step 2 - Running the daemon

OpenWebRTC browser extensions communicate with the daemon via its local web server. Before any page load, extensions fetch JavaScript from the daemon containing WebRTC functionality and inject it in to the current context. The daemon runs in a separate process in the background.

Daemon screenshot

Start the daemon by running the following commands:

cd ~/cerbero
./cerbero-uninstalled -c <CONFIG FILE> shell
openwebrtc-daemon

Note that you need to build OpenWebRTC first. In this example we run it on OS X, but the daemon is also available on Linux.

Bowser on iOS

We also released Bowser for iOS which is a web browser for iOS with WebRTC support using OpenWebRTC. At the time of release, it works almost identically to the daemon method discussed above, just integrated into an iOS app using a UIWebView to provide the web browsing functionality.

Your own application!

We hope the framework is also useful for development of your own applications or for integration into web browsers. Please let us know if you're using OpenWebRTC and we can perhaps link to your project here! 😃