DOCUMENTATION
Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Jan 31, 2021 16:59

To help you transition, Perfecto offers a desktop app that makes the legacy UI available beyond the EOL of Flash.  This article explains how to get access to the app, install it, and start using it. If you encounter any issues along the way, check the Troubleshooting section.

The Perfecto desktop app is identical to the legacy Perfecto UI. For more information on using it, see our legacy documentation.


To download the desktop app
  1. Access the Perfecto UI landing page.
  2. On the login page, enter your username and password and click SIGN IN.
  3. On the landing page, under Assets and Setup, click DOWNLOAD DESKTOP APP. This starts the download of PerfectoApp.exe (Windows) or PerfectoApp.dng (Mac).

  4. When the download is complete, double-click the downloaded file to install the app.
    On Windows, the app is installed in the following location: C:\Users\<user>\AppData\Local\PerfectoApp. When the installation is complete, the app opens.
    On Mac, continue with step 5.

  5. On Mac, move the installed app file as follows:

     Click to view image

    • If you have the required permissions, move the app to the Applications folder.
    • If you do not have permission to access the Applications folder, move the app to any other folder or to the desktop.
To launch the desktop app
  1. Do the following:
    • On Windows, if you just completed the installation, the app window should already be open. If it is not and for any subsequent app launches, go to Start > Perfecto > perfecto-app.
    • On Mac, launch your app from the location you copied it to, or from Launchpad.
  2. To connect to the correct cloud, do the following:
    • On Windows, in the perfecto-app window, go to File > Switch cloud.
    • On Mac, from the perfecto-app menu, select Switch cloud.
  3. Enter the name of your cloud and click SAVE.
    Your cloud name is the string that precedes .perfecotmobile.com in your cloud URL, as in https://cloud-name.perfectomobile.com.
  4. Log in to the desktop app using your Perfecto credentials.
    It may take a few seconds for the app to verify your credentials and load the Perfecto UI.
To connect through a proxy

If your network is configured to connect through a proxy, start the app from the command line with the --proxy-server argument. For example:

PerfectoApp.exe --proxy-server=127.0.0.1:1234

Troubleshooting

This section provides solutions for errors you may encounter when installing or launching the Perfecto desktop app.

ErrorDescriptionSolution
"Perfecto.App.dmg" can't be opened because Apple cannot check it for malicious software. This software needs to be updated. Contact the developer for more information.In macOS Catalina and macOS Mojave, the app may fail because it has not been notarized or is from an unidentified developer.

You can temporarily override your Mac security settings, as follows:

  1. Go to System Preferences > Security & Privacy > General tab.

  2. Click Open Anyway to confirm your intent to open or install the app.

     Click to view image

For more information, see https://support.apple.com/en-us/HT202491.

Copy app to Applications folder fails on missing permissions 

This error occurs if you try to move the app to the Applications folder but you do not have admin permissions on your machine.Move the app to a different folder.

With any other questions or issues, contact Perfecto Support. Make sure to include the app version in your ticket. The following steps describe how to verify your app version.

To verify the app version

On Windows:

  1. Right-click PerfectoApp.exe and select Properties. 
  2. In the Properties window, on the Details tab, verify the Product version.

On Mac:

  • From the app menu, select About.

To help you transition, Perfecto offers a desktop app that makes the legacy UI available beyond the EOL of Flash.  This article explains how to get access to the app, install it, and start using it. If you encounter any issues along the way, check the Troubleshooting section.

The Perfecto desktop app is identical to the legacy Perfecto UI. For more information on using it, see our legacy documentation.


To get access to the desktop app
  • Send a request to Perfecto Support.
    Perfecto Support will enable the app for you so that it becomes available for download in your cloud.
To download the desktop app
  1. Access the Perfecto UI landing page.
  2. On the login page, enter your username and password and click SIGN IN.
  3. On the landing page, under Assets and Setup, click DOWNLOAD DESKTOP APP. This starts the download of PerfectoApp.exe (Windows) or PerfectoApp.dng (Mac).

  4. When the download is complete, double-click the downloaded file to install the app.
    On Windows, the app is installed in the following location: C:\Users\<user>\AppData\Local\PerfectoApp. When the installation is complete, the app opens.
    On Mac, continue with step 5.

  5. On Mac, move the installed app file as follows:

     Click to view image

    • If you have the required permissions, move the app to the Applications folder.
    • If you do not have permission to access the Applications folder, move the app to any other folder or to the desktop.
To launch the desktop app
  1. Do the following:
    • On Windows, if you just completed the installation, the app window should already be open. If it is not and for any subsequent app launches, go to Start > Perfecto > perfecto-app.
    • On Mac, launch your app from the location you copied it to, or from Launchpad.
  2. To connect to the correct cloud, do the following:
    • On Windows, in the perfecto-app window, go to File > Switch cloud.
    • On Mac, from the perfecto-app menu, select Switch cloud.
  3. Enter the name of your cloud and click SAVE.
    Your cloud name is the string that precedes .perfecotmobile.com in your cloud URL, as in https://cloud-name.perfectomobile.com.
  4. Log in to the desktop app using your Perfecto credentials.
    It may take a few seconds for the app to verify your credentials and load the Perfecto UI.
To connect through a proxy

If your network is configured to connect through a proxy, start the app from the command line with the --proxy-server argument. For example:

PerfectoApp.exe --proxy-server=127.0.0.1:1234

Troubleshooting

This section provides solutions for errors you may encounter when installing or launching the Perfecto desktop app.

ErrorDescriptionSolution
"Perfecto.App.dmg" can't be opened because Apple cannot check it for malicious software. This software needs to be updated. Contact the developer for more information.In macOS Catalina and macOS Mojave, the app may fail because it has not been notarized or is from an unidentified developer.

You can temporarily override your Mac security settings, as follows:

  1. Go to System Preferences > Security & Privacy > General tab.

  2. Click Open Anyway to confirm your intent to open or install the app.

     Click to view image

For more information, see https://support.apple.com/en-us/HT202491.

Copy app to Applications folder fails on missing permissions 

This error occurs if you try to move the app to the Applications folder but you do not have admin permissions on your machine.Move the app to a different folder.

With any other questions or issues, contact Perfecto Support. Make sure to include the app version in your ticket. The following steps describe how to verify your app version.

To verify the app version

On Windows:

  1. Right-click PerfectoApp.exe and select Properties. 
  2. In the Properties window, on the Details tab, verify the Product version.

On Mac:

  • From the app menu, select About.