Connect the Wowza GoCoder encoding app to Wowza Streaming Engine

Wowza GoCoder is sunset and should only be used with existing Ultra-Low Latency (ULL) streams until that technology is also sunset.

Wowza GoCoder™ is an RTSP-based mobile live-streaming encoding app for Apple iOS and Android devices. If you're running Wowza Streaming Engine Manager on a device that has the GoCoder app, you can automatically configure the app with live application connection settings to publish a stream from Wowza GoCoder to a live application in Wowza Streaming Engine™ media server software. If you're running Wowza Streaming Engine Manager on the local server computer or on a remote computer, you can send the connection settings for a live application to an email app on the device and launch GoCoder with the prescribed settings by clicking the URL in the email message.

Before you start


You should complete the following tasks:

1. Authenticate live source connections from GoCoder


By default, Wowza Streaming Engine requires that RTMP-based and RTSP-based encoders provide a source user name and password before they can connect to live applications and publish a live stream. This section describes how to create a source account and manage source authentication for the Wowza GoCoder app in Wowza Streaming Engine Manager.

  1. In Wowza Streaming Engine Manager, click Server in the menu bar and then click Source Authentication in the contents panel.


     
  2. Click Add Source.
  3. Add Source User Name and Password information. The source user name and password values are case-sensitive and can only contain alphanumeric, period (.), underscore (_), and hyphen (-) characters.

  4. Click Add.

    A source account is used to authenticate connections from sources to live applications in Wowza Streaming Engine. You can create and store multiple source accounts for a Wowza Streaming Engine instance. By default, the source credentials are stored in [install-dir]/conf/publish.password.

  5. In your application's contents panel, click Source Security, and then click Edit.


     

  1. Under your source type, select Require password authentication.

  2. (Optional) Under Client Restrictions, select one of the options to control which IP addresses encoders can connect from. Restricting source publishing to specific IP addresses or blocking source publishing from specific IP address is recommended for security purposes.
  3. Click Save and then restart the application.

For more information about Source Security options, see Secure incoming sources.

2. Configure playback


  1. Click the Applications tab at the top of the page and then select your application in the contents panel.
  2. Click the Setup tab on your application's page and then click Edit.
  3. Under Playback Types, select any streaming protocols you need to support for playing streams sent to this application. The playback types enable transmuxing a source stream into MPEG-DASH, HLS, RTMP, and RTSP/RTP.
  4. Click Save.

  1. In the application's contents panel, click Playback Security, and then click Edit.


     
  2. Under Client restrictions, select No client restrictions to allow players to connect from any IP address.

  3. Click Save and then restart the application.

For more information about Playback Security options, see Playback security options.

3. Connect the Wowza GoCoder app


The Sources (live) page for live applications in Wowza Streaming Engine Manager enables you to configure and deliver connection settings for the application to Wowza GoCoder. The GoCoder app can then load the live application connection settings in order to connect to the application automatically.

If you're running Wowza Streaming Engine Manager on an Apple iOS or Android mobile device that has the GoCoder app, you can automatically configure the app with the application connection settings to publish a stream from Wowza GoCoder to a live application. If you're running Wowza Streaming Engine Manager on the local server computer or on a remote computer, you can send the connection settings for the application to an email app on the device and launch GoCoder with the prescribed settings by clicking the URL in the email message.
 
Note: These methods overwrite existing connection settings in the GoCoder configuration.
  1. In your application's contents panel, click Sources (live).


     
  2. In the Sources (live) page, click Wowza GoCoder.


     
  3. If necessary, adjust the application connection settings for the application from their default values.


     
    • The Server IP Address and Port values are the default streaming host port settings (IP address and port) for the virtual host (VHost). By default, Wowza Streaming Engine uses TCP port 1935 for all forms of streaming. To change streaming host port settings for the VHost, go to the Virtual Host Setup page in the manager.
       
    • The Stream Name is the name of the incoming live stream and defaults to myStream automatically. Change this value if desired.
       
    • In Source User Name, select the name of a source account. If the application requires that incoming RTSP connections be authenticated with a password (the default setting), the GoCoder settings will use the source user name and password for this account to connect. If the application doesn't require that incoming RTSP connections be authenticated, the selected source account isn't used. For more information about how to manage secure source connections, see Managing source authentication settings.
  4. Configure the GoCoder app with the application connection settings by using one of the following options:
     
    • If you configured the application connection settings on your device that has Wowza GoCoder installed, click the Auto-configure GoCoder button for your device (click Auto-configure GoCoder for iOS on your Apple iOS device or Auto-configure GoCoder for Android on your Android device).


       
      -OR-
    • If you're using the manager on the local server computer or on a remote computer, send the connection information to an email app on your device.



      Open the email message on your device and click the URL in the message to launch GoCoder with the application connection settings. For details about the URL parameters, see Configure the GoCoder app by emailing the connection settings URL.
       
      Notes:
      • The built-in Gmail client for Android doesn't support the email configuration method. You must use a different email client if you send the URL in an email message.
         
      • For security reasons, the Source Authentication information isn't included in the email message. You must still manually enter this information in your GoCoder Login settings.
  5. Tap the Encode button to automatically connect to the application in Wowza Streaming Engine.
     
  6. Verify that the stream is published.

4. Verify the connection


To verify that Wowza Streaming Engine is receiving the published stream, complete the following steps in Wowza Streaming Engine Manager.

  1. Click Incoming Streams in the contents panel for your live application.

    You should see your stream listed with Active for the status.

  2. Click the stream name to see the uptime, network throughput, and other information about the published stream.

5. Test playback


  1. From your application's page in Wowza Streaming Engine Manager, click Incoming Streams.
  2. Click the name of your stream and then click Test Playback from your stream's page.
  3. Review and, if needed, edit the following information in the Test Playback window for your stream:
     
    • Server – The IP address or domain name of the server and the streaming port ([address]:[port]).

  4. (Optional) In the Streaming URLs section, select Secure URL for the streaming protocol you want to use to test playback if you have configured SSL/TLS for streaming over https, rtmps, or rtsps.
  5. Click the Copy icon for the streaming protocol you want to use to test playback.
  6. Paste the playback URL into your player or a mobile browser depending on the protocol. Alternatively, you can use the Wowza Video Test Players webpage.

For more information about playback URLs, see About playing Wowza Streaming Engine streams.

Next steps


More resources