How to live stream with Pearl and Limelight

Logo for Limelight NetworksWhen you want to share you video stream to a big group of people, a Content Distribution Networks (CDN) is a the perfect choice. One such CDN is LimelightEpiphan Pearl works with Limelight by providing the encoded video stream that it then transcodes to the frame size and bitrate that suits each of your viewers (whether they are watching from a mobile, tablet or desktop computing platform). Using a feature called RTMP (real-time messaging protocol), your live broadcast, lecture or event is pushed from your Pearl to Limelight.

Note, for the steps outlined in this procedure you’ll need firmware version 3.16.0 or greater.


  • A Limelight account
  • Epiphan Pearl
  • Pearl must be configured wired or tethered internet connection (on a network with access to Limelight)
  • Configure a channel on Pearl with the content you want to live stream
    • The channel must use the H.264 video codec
    • The channel must have audio
    • The audio codec must be either AAC (preferred) or MP3 (44 kHz)

Step 1: Confirm your content

Before getting started with the Limelight configuration, make sure your channel is created and configured correctly on Pearl. The best way to do this is to preview the stream.

  1. Connect to the admin interface of your Pearl using your preferred connection mechanism. See the user manual for options.
  2. Login as admin.
  3. Click Info from the Configuration menu; the device information page opens.

    Pearl's info page showing channels currently configured

  4. Use the view link to preview your channel. Make sure it shows the content you expect to see.
  5. Verify the frame size, bit rate and video/audio encoding settings.
  6. Make any needed adjustments. Refer to the user manual for help.

Step 2: Prepare the Limelight stream

Open a new browser window, or a new tab in your current browser window for these next steps. This way you can switch easily between Pearl’s admin interface and the Limelights event setup page.

  1. Log into your Limelight account.
  2. At the top of the browser window, click the arrow next to Upload Media, then click Add Live Stream.
    Image showing where to click to select Upload Media then Add Live Stream for Limelight streaming
  3. The stream configuration window appears. Specify your bit rate and frame size.
    Limelight's stream settings dialog showing stream name, bitrate and frame size.
  4. Select the location nearest to you from the drop down box and click Create.
  5. Your stream is created and published immediately. On the right side of the screen, scroll to and click the Get Encoder Info button.

    Limelight encoder info popup.

  6. The Encoder info popup box appears with the settings you need for your Pearl.

    Limelight encoder settings. Copy these and paste in the Pearl streaming configuration window.

  7. Keep this window open. You’ll need the data from these fields to configure your Epiphan device.

Step 3: Configure Pearl for RTMP streaming

The next step is to transfer the RTMP configuration data to Pearl and ensure the stream is set up correctly. Reminder: You must be running firmware 3.16.0 or higher on your Pearl. Use the Firmware Upgrade menu in the admin interface to install the latest firmware if you do not have it.

  1. Return to Pearl’s admin interface.
  2. Click Streaming for the channel you want to stream; the streaming setup page opens. Scroll to the Stream to a Server section of the page.

    Open the Streaming configuration page on Pearl

  3. Select using RTMP push from the drop down list; the configuration options panel opens.Epiphan Pearl's web admin interface depicting publishing to a CDN using RTMP push
  4. Return to the Limelight browser window.
  5. Highlight and copy the Entry Point.
  6. In the Pearl Admin interface, paste this value into the URL field.
  7. From the Limelight window, highlight and copy the Stream 1 name field.
  8. In the Pearl Admin interface, paste this value into the Stream name field.
  9. From the Limelight window, highlight and copy the Username, paste this value in the Username field in the Pearl Admin interface.
  10. From the Limelight window, highlight and copy the Password, paste this value in the Username field in the Pearl Admin interface.
    Limelight settings copied from Limelight encoder settings to Pearl streaming configuration page.
  11. Click Apply in the Pearl Admin interface and Close in the Limelight encoder settings window.
  12. From the Pearl Admin interface, click the Start button. Your stream is sent to Limelight, and within a few moments is ready for viewing through Limelight’s embedded or linked players.
    Image showing the Start publishing button with Limelight RTMP settings filled in.
  13. When your live event is complete, click the Stop button, Pearl will stop streaming to Limelight. You may also wish at this time to unpublish or delete the stream from the Limelight interface.