PP7REMOTE

Documentation

Dated April 13, 2023

ProPresenter 7 uses a proprietary API server that doesn't support HTTPS protocol at this point. Therefore, our web application will need to communicate with ProPresenter's API server through a reverse proxy server as most modern web browsers do not private network access. For more information, visit here.

To configure XAMPP as your Reverse Proxy Server on Windows, follow these steps

  1. Download and install XAMPP here.

  2. First, make sure that your XAMPP installation has the required modules enabled. Open the httpd.conf file located in the C:\xampp\apache\conf directory (assuming XAMPP is installed in C:\xampp).

    3. Look for the following lines in the httpd.conf file and make sure they are not commented out (i.e., there should be no # at the beginning of the lines):

            LoadModule proxy_module modules/mod_proxy.so
        LoadModule proxy_http_module modules/mod_proxy_http.so
        LoadModule ssl_module modules/mod_ssl.so

  3. If they are commented out, remove the # at the beginning of each line.

  4. In the same httpd.conf file, add the following lines at the end:

    5.         SSLProxyEngine On
        SSLProxyVerify none
        SSLProxyCheckPeerCN off
        SSLProxyCheckPeerName off
        SSLProxyCheckPeerExpire off
        ProxyPass /v1 http://localhost:12345/v1
        ProxyPassReverse /v1 http://localhost:12345/v1

  5. These lines enable SSL proxying and forward all requests to /v1 on your reverse proxy server to http://localhost:12345/v1 (replace 12345 with the port number of your ProPresenter 7 API).

  6. Create a new file called index.php in C:\xampp\htdocs directory (assuming XAMPP is installed in C:\xampp) and add the following lines and save it:

    7.           <?php header("Location: https://pp7.jubilian.io/dashboard.php"); exit(); ?>

  7. Save the changes to the httpd.conf file and start the Apache server in XAMPP. It is important to start the Apache server in XAMPP each time you plan to use PP7REMOTE to communicate with your ProPresenter software. It is also recommended to stop the server when it is no longer required for security reasons.


To set up PP7REMOTE, follow these steps:

  1. Launch ProPresenter and navigate to Preferences, then Network.

    Step 1

  2. Enable the "Enable Network" setting and take note of the IP address and preferred port number. It's recommended to use a less commonly used port number between 1000 and 65000.

    Step 2

  3. To access PP7REMOTE, you can use a mobile or electronic device that is connected to the same network as your ProPresenter. Input the IP address and port number that you configured for your ProPresenter in the previous step before clicking "Submit". Your web browser may display a "Not secure" warning, but you can proceed with the connection.

  4. Congratulations! If you have followed the steps correctly, you should have successfully configured PP7REMOTE to communicate with your ProPresenter. However, if you encounter any issues during the process, please don't hesitate to seek technical assistance to troubleshoot the problems you have encountered.