• How to do server-side redirect of RTMP connections from one application to another

    This sample code is an example of how to redirect RTMP client connections to transparently force connections to specific applications and applications instances.

    Any client that connects to any application can be redirected. This is an example of a VHost listener that re-directs a live encoder connection to an application named live2 instead of the application name specified in the encoder.
    package com.wowza.demo.VHostExample;
    import com.wowza.wms.amf.AMFData;
    import com.wowza.wms.amf.AMFDataItem;
    import com.wowza.wms.amf.AMFDataList;
    import com.wowza.wms.amf.AMFDataObj;
    import com.wowza.wms.client.IClient;
    import com.wowza.wms.request.RequestFunction;
    import com.wowza.wms.vhost.*;
    public class VHostTest implements IVHostNotify {
    public void onVHostClientConnect(IVHost vhost, IClient inClient, RequestFunction function,
    AMFDataList params)
                             if (params.size() >= 3)
                                  AMFDataObj connectObj = (AMFDataObj)params.get(2);
                                  if (connectObj.getType() == AMFData.DATA_TYPE_OBJECT)
                                            AMFDataObj connectObj2 = (AMFDataObj)params.get(2);
                                            // Show all the variables you can change.
                                            List<String> MyKeys = connectObj2.getKeys();
                                            Iterator<String> MyKeysIter = MyKeys.iterator();
                                            while ( MyKeysIter.hasNext())
                                                      String Name = MyKeysIter.next();
                                                      String Value = connectObj2.get(Name).toString();
                                                      System.out.println("Name is "+Name+" value is "+Value+"");
                                            String appStr = (String)connectObj2.get("app").toString();
                                            String tcUrlStr = connectObj2.get("tcUrl").toString();
                                            // rewrite them here
                                            // Example change the appStr from anything to "live2"
                                            tcUrlStr = tcUrlStr.replace(appStr,"live2");
                                            connectObj.put("app", new AMFDataItem("live2"));
                                            connectObj.put("tcUrl", new AMFDataItem(tcUrlStr));
              public void onVHostCreate(IVHost vhost) {
              public void onVHostInit(IVHost vhost) {
              public void onVHostShutdownComplete(IVHost vhost) {
              public void onVHostShutdownStart(IVHost vhost) {
    To use this module:
    1. Add a VHost listener to [install-dir]/conf/Server.xml.
    2. Verify listener is working as expected through log statements.

      Expected log output in [install-dir]/logs/wowzamediaserver_access.log when the VHostListener is active and where the client connects to application named 123456 and the stream being published is myStream. However, you can see in the rest of the log file that the actual application that is actually running is named live2.
      Name is app value is 123456
      Name is tcUrl value is rtmp://[wowza-ip-address]/123456
      Name is type value is nonprivate
      Name is flashVer value is FMLE/1.0 (compatible; FMSc/1.0)
      Name is swfUrl value is rtmp://[wowza-ip-address]/123456
      INFO application app-start _definst_ live2/_definst_

    Note: The application that is specified for the redirect connection does not have to have be preconfigured. Thus, in this example you could connect with the following URL and connections would be redirected to back to the application named live2.


    If you're having problems or want to discuss this article, post in our forum.