Crestron Home Setup App for Desktops

Use the Crestron Home Setup app for desktop to configure a Crestron Home system on a Mac® or Windows® PC.

Launch the Crestron Home Setup App

The Crestron Home Setup app can be launched from the desktop application or from a web browser.

NOTES: The Crestron Home Setup app must be launched from the desktop when:

  • The Crestron Home processor is running firmware version 3.002.0031 or earlier.
  • The processor is a PYNG-HUB or CP3-R and running Pyng OS 1 or Pyng OS 2.

Launching from Web Browser

Enter the IP address of the Crestron Home processor into a web browser. The web page will prompt you to launch the Crestron Home Setup app.

NOTES:

  • If the Crestron Home Setup app is installed on your computer you will be prompted to launch the Crestron Home Setup app.
  • If the Crestron Home Setup app is not installed on your computer, you will be prompted to download and install the app.
  • The Crestron Home Setup app can also be downloaded from the Crestron website.

Launching from Desktop

Double-click the Crestron Home Setup app to launch the app from the desktop.

NOTE: The Crestron Home Setup app can be downloaded from the Crestron website.

Discover Crestron Home Processors

The Crestron Home Setup app discovers and displays a list of all Crestron Home processors on the local network when the app is launched. Newly discovered systems will have the Add button, the Connect button will be disabled.

NOTE: If no Crestron Home processors are found, click Refresh to update the list or Add Manually to manually add the Crestron Home processor. For details, refer to Add or Edit a Crestron Home Processor.

The main screen consists of the following components:

  • Home List: Displays the list of discovered and saved Crestron Home processors. Saved processors are displayed first, followed by discovered processors.
  • Refresh: Initiates auto-discovery to scan the network and detect new Crestron Home processors. The application scans for new processors every 90 seconds.

    NOTE: If the Crestron Home processor is discovered and then disconnected from the network, the processor is displayed in the Home List until the Crestron Home Setup app is closed and then restarted.

  • Add: Saves the Crestron Home processor in the system list. Available for discovered processors that are not saved. For details, refer to Add or Edit a Crestron Home Processor.
  • Add Manually: Add a Crestron Home processor that was not found during auto-discovery. For details, refer to Add or Edit a Crestron Home Processor.
  • Edit: Changes the connection information for the Crestron Home processor. For details, refer to Add or Edit a Crestron Home Processor.
  • Connect: Retrieves the configuration files from the Crestron Home System and launches the configuration screen. Enabled for processors that are saved. For details, refer to Launch a Configuration.
  • Status Bar: Displays the status of the auto-discovery process and status of retrieving the configuration files from the Crestron Home System.

Add or Edit a Crestron Home Processor

  1. Add or edit the Crestron Home processor.

    1. To add a Crestron Home processor that was discovered, click Add.
    2. To manually add a Crestron Home processor, click Add Manually.
    3. To edit the configuration for a Crestron Home processor, click Edit.

  2. Enter the following information in the Add Home or Edit Home screen.

    • Friendly Name or Location: Enter a name to help identify the Crestron Home processor. If the processor was found during auto-discovery, the field is populated with the host name.
    • Host Name or IP Address: Enter the host name or IP address for the Crestron Home processor. If the processor was found during auto-discovery, the field displays a drop-down menu to select the host name or IP address of the processor.

      NOTES: 

      • For discovered processors, this value will update if the discovery response indicates a change. Discovered systems are tracked by serial number.
      • The same host name or IP address cannot be used for multiple Crestron Home processors.
    • Web Port: The port used to connect to the Crestron Home processor. The value can be changed to work with forwarded ports. The value must be between 1 and 65535. The default value is 443 when SSL is enabled and 80 when SSL is disabled.
    • CIP Port: The CIP (Crestron Internet Protocol) port number used to connect to the Crestron Home processor. The value can be changed to work with forwarded ports. The value must be between 1 and 65535. The default value is 41796 when Secure CIP is enabled and 41794 when Secure CIP is disabled.
    • User Name: The Admin User Name for the Crestron Home processor. The Admin User Name is used to connect to the Crestron Home processor.
    • Password: The Admin Password for the Crestron Home processor. The Admin Password is used to connect to the Crestron Home processor.
    • Reset this home to default values: Displayed when editing a configuration. Removes the stored values for the Crestron Home processor and removes the processor from the saved Home List.

      NOTE: If the Crestron Home processor is disconnected from the network, the processor is displayed in the Home List until the Crestron Home Setup app is closed and then restarted.

  3. Click Save to add the home.

Remove a Crestron Home Processor

To remove a Crestron Home processor from the Home List, use the procedures below.

Remove a Saved Processor

To remove a saved Crestron Home processor, follow these steps:

  1. Select a Crestron Home processor to removed, and then click Edit.
  2. Click the Reset this home to default values. The stored values for the Crestron Home processor are removed and the processor is removed from the saved Home List.
  3. To remove the processor from the Home List, refer to Remove a Discovered Processor.

Remove a Manually Added Processor

To delete a manually added Crestron Home processor, click Edit > Delete this home. The Crestron Home processor is removed from the Home List

Remove a Discovered Processor

To remove a Crestron Home processor that was discovered and is displayed in the Home List, disconnect the processor from the network and then restart the Crestron Home Setup app.

Launch a Configuration

Click Connect to launch a configuration. The Crestron Home Setup app connects to the Crestron Home processor, retrieves the configuration files, and then launches the configuration screen.

Configure the Crestron Home System

Configure the Crestron Home system with the Crestron Home Setup app. For details, refer to Configure a System.

Shortcuts

Create a shortcut to open the configuration for a specific Crestron Home processor.

Create a Shortcut on a Windows PC

To create a shortcut in Windows:

  1. Open a folder. For example, the Desktop.
  2. Right-click and then select New > Shortcut.

  3. Enter crestronhome:[ipadddress] into the address bar (for example, crestronhome:192.0.2.1) and then select Next.

  4. Enter a name for the shortcut.

  5. Select Finish.

Create a Shortcut on a Mac

To create a shortcut in MacOS:

  1. Enter the IP address or hostname into a web browser.
  2. The Crestron Home splash screen displays.
  3. Select the URL in the browser and then drag it to a folder on your computer.

Troubleshooting

Adobe AIR Encounters Error

Adobe® AIR® displays an "Adobe AIR.framework is damaged and can't be opened" message.

Possible Cause(s)

A quarantine flag is placed on AIR.framework which prevents the framework from running. This occurs when Adobe AIR is installed on macOS® Catalina.

Corrective Action(s)

Remove the quarantine flag from the AIR.framework using the Terminal app.

  1. Open the Terminal app.
  2. Run the following command:

    sudo xattr -r -d com.apple.quarantine /Library/Frameworks/Adobe\ AIR.framework