Installation & Licensing

Licensing

You will receive a 32 digit License Key that enables you to use Editor Mode to create and modify projects on two devices.

If you do not enter the License Key your project will be branded with the present4D logo. After the License Key has been entered the branding disappears.

Enter the License Key

Note

Local Server License Management

If you use a Local Server License Manager it is not needed to enter the Serial License Key manually on each computer.

_images/Launcher_2018-Serial.jpg _images/license-register.jpg _images/license-unregister.jpg

To register your device for editing and creating presentations follow these steps to transfer the License Key to your device.:

The following instructions are for all VR Headsets except Google Cardboard style. For Google Cardboard style headsets, refer to the instructions later in this chapter.

  1. Highlight your 32-digit License Key and press Crtl.+c to copy it to the clipboard

  2. Launch VR-Suite

  3. Click on the key symbol in the Project Portal.

  4. The dialog Device Registration will open and your 32-digit or 20-digit License Key is automatically inserted from the clipboard.

  5. Activate this PC as editor with Register Device.

  6. Select Close

  7. Exit the VR-Suite with ESC and restart.

Warning

Issues with licensing

If problems occur during licensing, this may be due to the network, firewall or antivirus programs. First try to connect the computer via another internet connection. See also Network Communication .

Unregister your Device

To unregister your device for creating and editing please press Unregister Device. You can register this device or an other device with your License Key immediately.

  1. Launch VR-Suite

  2. Click on the key symbol in the Project Portal.

  3. The dialog Device Management will open.

  4. Deactivate this PC as editor with Unregister Device.

  5. Select Close

  6. Exit the VR-Suite with ESC and restart.

Customize Logo and Interface

It is possible to customize VR-Suite to have your own logo in the iMenu, the Project Portal, and the Splashscreen that appears when you launch the program.

Related links:

Alerts and Warnings

Warning: Splash graphic is not registered yet and Warning: Logo graphic is not registered yet

When you are finished with the new logo and splash graphic, these must still be registred in the licensing menu:

  1. Editor Start Mode

  2. Launch the iMenu

  3. Switch to the Settings

  4. Scroll down to License & Logo Registration and select Change Image

  5. Click on register

  6. Launch VR-Suite

See also: Add Custom Icons to a Project and: customize the complete interface: Custom Styles - Advanced

Licensing in older Versions and Cardboards

Read More…

Following these steps, you will transfer the License Key for unlocking into the VR-Suite:

  1. Copy the 32 digit License Key into the clipboard using Crtl.+c

  2. Launch the VR-Suite in desktop mode, not in VR-mode

  3. Enter the edit mode (by double tapping the space bar)

  4. Select the tab Settings (gear wheel icon)

  5. Scroll to the end of the second page to select Manage license

  6. Select Enter License or target

  7. Select the input box for the License Key

  8. Use Crtl + v to paste the License Key from the clipboard

  9. select Close

  10. Exit the VR-Suite with ESC and restart.

Warning

The input does not work for an empty project! Project data must be available.

Installation

Windows PC & Oculus Rift

You can choose between the installer version and the portable version, which does not need to be installed. The functionality is identical. The installer version installs present4D in the Programs directory if you do not select another directory.

  1. Install the current Oculus Rift software and set it up.

  2. Update Windows and your graphics drivers.

  3. If your multimedia content does not play properly, you might want to install the LAV Filter video codec. This is available as a free download for Windows users.

  4. Download present4D VR-Suite

In case there are no VR glasses connected, the mouse & keyboard mode is started automatically.

Launch the VR-Suite to Allow Network Communication

  1. Install VR-Suite.

  2. Launch the VR-Suite with a double click.

Warning

Allow Communication

During the first launch, a Windows Defender Firewall warning will pop up. Please allow all communication to the network. Otherwise there may be a conflict when you try to activate your license and you may have issues when using conference mode. For other problems please check: Network Communication

_images/firewall_en.png

Change the settings for Windows Defender Firewall

If you encounter problems with licensing, conference mode or Server License Manager, you may have to allow the Windows Defender Firewall network communication for the VR-Suite.

_images/defender.png

See also: Server License Manager Prot

Apple OSX Mac

The Mac OSX version is identical to the PC version but there are some restrictions:

  • No Installer

  • No Approval through Apple

  • HTML WebExport not supported yet

  1. Download present4D VR-Suite Mac OSX

  2. Unzip the downloaded file

  3. Copy it to the system folder Apps to make sure the system works correctly

  4. Launch the App and shut it down once the security alert shows up

  5. Allow opening the App in Apple´s Privacy & Security settings

    _images/apple-security.png

To get to the folder Input right click on the VR-Suite App and select “Show Package Contents”.

Note

If the connection check does not end while starting the VR-Suite or the interface looks broken, please ensure that you have moved the VR-Suite into the Programs folder.

DPVR Edu Pro

Manual Installation
  1. Download the newest DPVR Version from our website.

  2. Copy the apk via USB cable into the folder “downloads”

  3. Open the apk with DPVR´s file manager and folow the instructions.

Pico G2 4K

Viveport
  • Install VR-Suite from the vive port.

Manual Installation
  1. Download the newest Pico Version from our website.

  2. Copy the apk via USB cable into the folder “downloads”

  3. Open the apk with Pico´s File Manager`

  4. Chose APKs

  5. Select the VR-Suite and folow the instructions.

Use Pico G2 4K in Kiosk Mode

Pico G2 4K - set present4D as launcher.

  1. Turn on Pico VR goggles

  2. Activate Developer Mode:

    • Press the Pico button 2x in quick succession to access the settings menu (gear icon).

    • Go to the General tab in the left column and click the select button at least 8 times on the Software Version Number section until the Developer tab appears in the left column.

  3. Switch to the Developer tab - an Android settings menu will open. Scroll all the way down in the menu by holding down the Select button and select the System tab.

  4. Click on the developer options under System.

  5. In the developer options scroll down to Special settings and select Business settings:.

  6. In the newly opened menu, switch to the guilabel:Launcher App(Kiosk Mode) tab on the far right.

  7. Select present4D: and confirm. Restart the device.

Note: If the VR-Suite does not launch immediately after reboot, repeat steps 3- 7.

Pico Neo 3 & Neo 4

Manual Installation
  1. Download the newest Pico Version from our website.

  2. Copy the apk via USB cable into the folder “downloads”

  3. Open the apk with Pico´s file manager and folow the instructions.

SteamVR - HTC Vive and Windows MR

Download present4D VR-Suite for Steam from our website

Meta Quest 1, 2 & 3

  1. Download Easy Installer: Download from.

  2. Connect Quest to PC: Use a USB cable to connect your Quest headset to your PC.

  3. Launch PC Application: Start the SidequestVR app and follow the “Setup Instructions”.

  4. Locate the App in Sidequest: Search for “VR-Suite” in SidequestVR.

  5. Install VR-Suite: Install the latest version for Meta Quest via SidequestVR from our website.

HTC Focus and HTC Following

Manual Installation
  1. Download the newest HTC Version from our website.

  2. Copy the apk via USB cable into the folder “downloads”

  3. Open the apk with HTC´s file manager and folow the instructions.

Samsung GearVR

The Samsung GearVR is no longer supported.

Legacy Support

To see the VR-Suite in the Oculus Go you first need a free Oculus Key. We are working on the fact that this step is no longer necessary in the future.

  1. Create and copy the key from our website: Get an Oculus Home Key

  2. Start the Oculus App on your Smartphone

  3. Click “more”

  4. Click “Reedem Code“

  5. Enter Oculus Key

  6. Now in the Oculus App you will find the VR-Suite in the “library” under “not installed”.

The code only needs to be entered once per Oculus ID, even if this ID is used on multiple devices.

GearVR Icon on Home Screen:

Due to changes in the current Android version, it is no longer possible to put an icon for the VR-Suite on the homescreen from within VR. Please use our additional VR-Suite Companion App for this purpose:

_images/companion-app.jpg

Download GearVR VR-Suite Companion App at Google Play

Oculus Go

The Samsung GearVR is no longer supported.

Legacy Support

To see the VR-Suite in the Oculus Go you first need a free Oculus Key. We are working on the fact that this step is no longer necessary in the future.

  1. Create and copy the key from our website: Get an Oculus Home Key

  2. Open https://secure.oculus.com/redeem-code

  3. Login with your Oculus account

  4. Paste or enter the key

  5. Login with your Oculus account on your Oculus Go

  6. Now in the Oculus Go you will find the VR-Suite in the “library” under “not installed”.

  7. Choose to install VR-Suite.

The code only needs to be entered once per Oculus ID, even if this ID is used on multiple devices.

Note

How to find present4D App Updates in my Oculus Menu

  1. Start Oculus Go or Samsung GearVR

  2. Go to My Bibliothek

  3. Check at the left side: Updates

Android App

Download Android App at Google Play

Important

Please use the full resolution of the Smartphone. Some Smartphones offer the possibility to use a reduced resolution to save energy. This may cause misrepresentation.

_images/android-screenresolution.jpg

iOS App

Download at App Store

Important

Dubbing without the Internet will be submitted later for iOS via update. The transmitting via cable please request a special version.

Quality and Performance Settings for Desktops

It is possible to adopt the quality settings for example to user VR-Suite on low performance laptops. This does not affect the quality on headsets. See also: Quality Settings for Headsets

In the file quality.txt you can change the value. Don´t write anything else than the number into it.
  • 0 quality low (15 frames per second)

  • 1 quality simple

  • 2 quality medium

  • 3 quality default

  • 4 quality maximum

Locate quality.txt on PC

The file is located next to the .exe

Locate quality.txt on Mac

Right click on the app to open package contents

Visual Quality

Tip

In the PC version, you can access the supplementary Display Quality settings by pressing the Crtl key right after the double click to launch the VR-Suite.

Optimal settings are:

Screen

1920x1080

Graphics quality

Level 3

Advanced Users

  • To achieve maximal quality, you should deactivate ASW!

  • After exiting with “ESC”, ASW will be enabled again.

Updates

The handling of actualization differs depending on platform and version.

We generally recommend that you make backups of your projects before you update the software.

  • All mobile platforms receive the updates automatically via the stores.

  • For PC and Mac, please download the latest version from our download page https://present4d.com/download
    • With the Installer version you can easily perform the installation. The old program version will be replaced. All projects are available in the new version.

    • For the portable version, please unzip the folder and copy your project portals into the new directory.

Network Communication

In this chapter you will find all information about firewall, ports and servers.

Upload, Download, Connection Check

For network information regarding the Conference Mode click here: Ports used by Conference Mode

Our application makes standard GET and POST requests using HTTP and HTTPS to the following servers:

Server
  • present4d.com

  • aws.present4d.com

  • servers.present4d.com

  • present4d.net

  • ec2-3-122-45-28.eu-central-1.compute.amazonaws.com

  • remote-config-proxy-prd.uca.cloud.unity3d.com

  • thind-gke-usc.prd.data.corp.unity3d.com

Http/s Requests

Our Http/s requests are nothing special and work like they do on any Internet Browser or Application.

  • Used Transfer Protocol: TCP

  • Destination Ports: 443 (https) or 80 (http)

  • Source Ports: 49152 - 65535 (See explanation below for details)

  • In response packets that are send from the server to a client, destination and source ports are switched

Because the server is just responding to the client Port-Forwarding is not required. But incoming and outgoing traffic needs to be allowed for our application in the source port range.

Details

When a http/s request is made, a TCP connection is established between a “port” (a communication point) on the client (your device) and the server. One can imagine it as a communication-wire, that is connected to numbered sockets on both devices. A port is “blocked” while it’s in in-use and can’t be used by other requests at the same time. So by default the operating system (E.g. Windows) randomly picks a source port from the Ephemeral Port Range for each request. This port on your client is then used to send the Http/s request and to receive the corresponding response from the server. The destination port on the server is by default always 448 for https and 80 for http connections.

This behavior is low-level and the same for all applications that do http/s requests. It’s beyond the possibilities of our application to change this. It is possible, though, to define different port range within the operating system, but we do not recommend this and can’t support it, if you are running in any issues.

Server License Manager Prot

Windows Defender Port 12422 must be allowed. Especially on Windows Server.

Conference Mode

Ports used by Conference Mode

aws.present4d.com:23466

(Multiuser Master Server, manages all online conferences so that the client can show list of open conferences)

aws.present4d.com:50005

(Facilitator, NAT punch-through, works together with the Master Server. Avoids that port 6666 needs to be forwarded)

local:6667

(UDP Broadcast for finding other conferences within the same local network, without an internet connection / master server)

local:6666

(TCP/UDP - Port used for sending Multiuser data)

Port forwarding

This is usually not required. If you can see a conference from the internet but you can’t joint it, the automatic NAT-punch-through failed. In this case the conference creator needs to change the network settings, so that the router forwards port 6666 to the device used to host the conference.

See also Troubleshooting for Conference and Mirror via Network

Local Server License Manager

The new Server License Manager (SLM) simplifies the management of licenses and editor seats. the VR-Suite connects to the SLM when the editor mode is started. If there are still enough editor seats available, the editor mode starts. Otherwise a message appears that currently no editor seats are available.

Students

If the school admin has prepared everything, the student only needs to Enter a Portal Key.

School administrator / teacher

With internet connection
  1. Start Server License Manager Exe on any computer, preferably with a fixed IP address.

  2. Insert the |VRS| serial number

Without internet connection
  1. Start Server License Manager Exe on any computer, preferably with a fixed IP address.

  2. Enable Port 12422 : Server License Manager Prot

  3. Insert the |VRS| serial number

  4. A file slm.dat is created next to the .exe.

  5. Add a blank line below it or the path for the local cloud.

  6. Copy the slm.dat next to the |VRS| app.

Example slm.dat file:

192.168.178.171 (IP if the Computer)
12422 (Port)
9L9Q8QU+u00vUVY00vAB6MVWvAKnRTvslQthAukfO00QtcYgnv004A== (Serial Number)
\\myDrive\Users\user1\Documents\VRProjects\ (Example network path)

Or alternatively local path:

C:\Users\user1\Documents\VRProjects\

The app can be run on a PC or from a NAS.

Video Tutorials

Visit our Youtube Tutorial Video Channel