{% let activation_class -%} {% if server_is_running -%} {% let activation_class = "active" -%} {% else -%} {% let activation_class = "inactive" -%} {% endif -%} ReaLearn

ReaLearn Projection

{% if !server_is_running %}

Server
not
running

{% endif %}

Introduction

Welcome to ReaLearn's projection feature. This allows you to project a schematic representation of your currently active controller onto a mobile device (e.g. a tablet computer). You can put this device close to your controller in order to see immediately which control element is mapped to which parameter.

First-time setup

In order to let your mobile device connect to ReaLearn, ReaLearn needs to act as a so-called web server. By default, this server is switched off. In order to set it up correctly, please follow below instructions. Don't worry, this needs to be done only once. After this initial effort, pairing your mobile device with another ReaLearn instance is a matter of a few seconds (you just need to scan a QR code).

{% if server_is_running %} Congratulations, the server is running. {% else %} Start the server! {% endif %} {% if server_is_running %} 😃
- It will automatically be started again next time you start REAPER with ReaLearn. If you decide to not use the projection feature anymore, disable the server in the context menu of ReaLearn's header panel.
- You have disabled it though. This will take effect on the next start of REAPER. You can enable it again using the context menu of ReaLearn's header panel.
{% else %}
- Please open the context menu of ReaLearn's header panel (accessible via right-click on Windows and Linux, control-click on macOS) and choose Server → Enabled. It's possible that your firewall will ask you for permission to open a network port for external devices. In that case, say yes!
- After you have done this, please refresh this page or click ReaLearn's Projection button again.
{% endif %}
Try to open the ReaLearn Companion web app on this computer (requires internet connection and takes a while to load when using it the first time).
- If this works, you know the server is indeed running. That means you can already use projections right here on this computer.
- It's more interesting however to project the controller routing to another device. Let's set this up in the next steps.

Try to open ReaLearn's Companion app on your mobile device.

At the moment there's an Android app and the web app. The iOS app has not been published yet.

If your device doesn't have a camera, point your mobile browser to the following address: {{ companion_web_app_url }}. When asked, enter the following connection details:

Host:	{{ server_host }}
HTTP port:	{{ server_http_port }}
HTTPS port:	{{ server_https_port }}
Session ID:	{{ session_id }}

The app might ask you to open ports in your firewall. If so, follow below instructions:
- Let ReaLearn add an exception to your Windows Firewall using the corresponding action in the context menu of ReaLearn's header panel.
- Manually add a firewall rule that opens ports {{ server_http_port }} and {{ server_https_port }} for incoming TCP connections.
- Manually add a firewall rule that opens ports {{ server_http_port }} and {{ server_https_port }} for incoming TCP connections.
- After that, retry connecting via mobile app.
- Troubleshooting:
  - Check the obvious: Make sure your mobile device is in the same network as your computer running REAPER and ReaLearn (both should use Wi-Fi).
  - If your mobile device still cannot connect, you can temporarily switch off your firewall to see if that's the issue.
  - If this helped, switch your Firewall on again and check if there's a firewall rule that blocks REAPER. Remove it! If that still doesn't help, try to add a Firewall rule manually that opens ports {{ server_http_port }} and {{ server_https_port }} for incoming TCP connections.

Can I use this on stage?

At the moment this feature is optimized for usage in a studio environment, not for usage on stage. Before using it in live scenarios, please consider the following advice:

In order to connect to ReaLearn, your mobile device needs to be in the same network as this computer. At home this is usually a no-brainer because you have a wireless access point that connects everything for you. On stage you would need to establish an ad-hoc wireless network connection between your computer and the mobile device. This is possible and not really difficult but ReaLearn won't set it up for you.
ReaLearn's server is not password-protected or rate-limited. Therefore you should make sure that your ad-hoc network uses a strong password. Otherwise a hacker with bad intentions could possibly find ways to mess up your stage performance.