1. Help home
  2. Cavern Remote
  3. Setup

Cavern Remote user guide

Readme Setup Browser Controls Correction Projection Menus Pro Lights

Setting up Cavern Remote

  1. Install MPC-HC. The recommended version is by clsid2.
  2. In MPC-HC options, under Web Interface, enable it on any port, and set these:
    • "Serve pages from" - tick this, and browse Cavern Remote's "web" folder.
    • "CGI handlers" - set this to Cavern Remote's "handler.exe", like .md=C:\Cavern Remote\handler\handler.exe;, but use the location you unzipped Cavern Remote to.
  3. Check your local IP (open a command prompt and use the ipconfig command and look for IPv4 Address) and port (in MPC-HC's Web Interface settings), and merge them like <IPv4 address>:<port>. This will be the web address that opens Cavern Remote in your browser or on your phone. Create a shortcut if it's convenient.
  4. Check all optional setup tasks, and do the ones you need.

Optional: run MPC-HC as admin

For full functionality (keyboard, mouse, and Equalizer APO control), MPC-HC has to run as admin. This is required because Equalizer APO keeps its configuration files in the Program Files folder, and admin rights are needed to modify those. For full transparency and as proof that it is not malicious, the source code of the command handler is available on GitHub.

To set up MPC-HC with admin rights, open its properties from the installation directory, go to the Compatibility tab, and in the settings for all users window, you will find a check box to run as admin.

Optional: start MPC-HC with the computer

If you didn't give admin rights to MPC-HC, simply create a shortcut for it in the Startup folder of your Start Menu. To open this folder, copy this path in the file browser: %appdata%\Microsoft\Windows\Start Menu\Programs\Startup.

For applications that run with admin rights, the Start Menu version will not work, nor adding an entry in the registry. These applications require a new task in the Task Scheduler with the following options:

  • Run with the highest privileges (tick on the first tab)
  • On the Triggers tab, add a new trigger after login.
  • On the Actions tab, add a new action to open MPC-HC.

If you use SVP, it also has to run as admin, and needs a separate task to start with the system.

Optional: setup shader selection (picture mode)

  1. Navigate to the Player/Shaders page in MPC-HC's options.
  2. Create your presets here. A recommended source of shaders is the Cinema Shader Pack.
  3. Open web\_cavern.js in any text editor and add the names of your presets to the shaderPresetNames list. Preserve the format of the array.

This is only an advertisement and keeps Cavern free.

Optional: setup Equalizer APO support (sound mode)

  1. In handler\apopath.txt, set the location of Equalizer APO's config folder.
  2. Add any custom presets in the presets folder. These must be a replacement to Equalizer APO's main config.txt, and keep in mind that these will overwrite the active configuration when selected. Make a backup of config.txt in Equalizer APO's config folder first, or use Cavern Remote's backup feature on the Pro page.
  3. Open web\_cavern.js in any text editor and add the names of your presets to the apoPresetNames list. Preserve the correct format, check the other array on how to do this properly, and don't include the .txt extensions.

Optional: setup projector corrections (projection tab)

  1. Get Cinema Shader Pack.
  2. Copy its Shaders folder to MPC-HC's root folder. Allow overwriting. The following file must exist: MPC-HC/Shaders/Screen File.hlsl.
  3. In handler\mpcpath.txt, set the location of MPC-HC's root folder.

Optional: setup ambient lighting control

Setup for users with electrical engineering experience is under the Lights tab.