How can we help?

My Cases

Installing the Universal Capture Desktop Application
Last Updated: Sep 21, 2018 08:59AM EDT

This article applies to:  Echo360 Admins

The Universal Capture application is currently available in Classroom mode for the Mac. This means that the application must be registered with an Institution, assigned to a Room (for scheduling) and available for remote monitoring and control by Admins.

NOTE: Personal mode is now available for institutions that have opted in for Universal Capture selected beta testing. If you are interested in more information regarding beta testing contact your Echo360 representative or send a message to support@echo360.com.

The Universal Capture application can coexist with Personal Capture for the Mac, however, we do not recommend attempting to run both applications at once. If you have not already done so, please see Universal Capture Specifications to be sure the computer you are using meets the minimum system requirement for Universal Capture.

In order to switch between Universal Capture: Classroom and Universal Capture: Personal, uninstall the current version and then install the desired one. Do not attempt to install Personal mode on top of Classroom mode, or vice versa.

Download the Installer

  1. Log into Echo360 as an Administrator.
  2. Click the Settings menu to open it and select Downloads, as shown in the below figure.
  3. Click the Download link from the Universal Capture section of your choice (Classroom or Personal mode) from the Downloads page, shown below. The installer must be run locally, so save the file to your computer.
    Admin Downloads page with Universal Capture download links as described

Install the Program

The Universal Capture Download link downloads a .dmg or Disk Image for installation purposes. Use the steps below to install Universal Capture from the .dmg.

Use Local Directories for Installation!
The Universal Capture installation and data directories must be on the local drive; they cannot be located on a network, remote (mapped), or USB thumb drive. Use the defaults provided during installation.

Note that in Classroom mode, the Installer will prompt you for your Institution ID. This is necessary so that your Universal Capture application can be registered with your Institution.

To find your institution ID:

  1. While logged in as an admin, click the Settings icon, then select Configuration.
  2. On the Configuration page, select API Configurations from the left.
    The Institution ID resides on this page, as shown in the below figure, and can be selected and copied for use in the installer.
    API Configurations page with arrows showing navigation to the page and the institution ID field as described

To install Universal Capture on a Mac

  1. Locate the downloaded Universal Capture Installer .dmg file. It should be located in the Downloads folder (Finder > Downloads).
  2. Double-click the .dmg file to mount the image and begin the installation process.
  3. A new Finder window should appear showing the .dmg contents. Double-click the UniversalCapture.pkg file to launch the installer.
  4. Once the installer is launched, follow the prompts to the complete installation.
    The Institution ID is needed during installation so that your Universal Capture application can be registered with your Institution. Use the above procedure to obtain it if you have not already.
  5. If installing Classrom mode, locate and make a note of the MAC address of the built-in wifi network adapter for the computer. This will be the MAC address used to add the device to a Room.
    Note that this does not mean that you have to use the built-in wifi network adapter, this is only for identification purposes.

After Universal Capture is installed, launch it. Log in and run a test capture to ensure it works as expected. If it does, you may delete the downloaded installer file and unmount the disk image.

NOTE that when Universal Capture is first launched (after installation) it takes approximately 2-5 minutes for the application to establish a connection to your Institution and make sure that the latest software is being used. During this time a loading screen will be displayed that will disappear once the connection is established. This is a good time to create the Room assignment if using Classroom mode.

Command Line Installation for Mac OS X

Universal Capture allows for command line installation of the software on a target Mac running Sierra (OS X 10.12) or higher.

To install Universal Capture via command line in Classroom mode

  1. Identify the computer(s) where you want to install Universal Capture.
  2. Download the Installer to the Downloads directory.
  3. Navigate to the Downloads directory and run the following command to mount the disk image:
    • hdiutil mount UniversalCaptureClassroom<Region>_<VersionNumber>.dmg
  4. Copy the package contents to the target directory:
    • cp "Install Echo360 Capture Classroom.pkg" "<target directory>"
  5. Create a text file in the same directory as above (Step 4) of the target computer containing only your Institution ID named:
    • institutionId.txt
  6. Run the following command to install the package:
    • sudo installer -package /<target directory>/UniversalCaptureClassroom<Region> _<VersionNumber>/Install\ Echo360\ Capture\ Classroom.pkg -target "/Volumes/Macintosh HD"
  7. Clean up by unmounting the disk image:
    • hdiutil unmount /Volumes/UniversalCaptureClassroom<Region> _<VersionNumber>

To install Universal Capture via command line in Personal mode

  1. Identify the computer(s) where you want to install Universal Capture.
  2. Download the Installer to the Downloads directory.
  3. Navigate to the Downloads directory and run the following command to mount the disk image:
    • hdiutil mount UniversalCapturePersonal<Region>_<VersionNumber>.dmg​
  4. Run the following command to install the package:
    • sudo installer -package /Volumes/UniversalCapturePersonal<Region> _<VersionNumber>/Install\ Echo360\ Capture\ Personal.pkg -target "/Volumes/Macintosh HD"
  5. Clean up by unmounting the disk image:
    • hdiutil unmount /Volumes/UniversalCapturePersonal<Region> _<VersionNumber>

To add a Desktop Shortcut for Universal Capture (Optional)

  1. Run the following commands
    • cd ~/Desktop
    • ln -s /Applications/Echo360\ Capture.app <Shortcut Name>

Uninstall from Mac OS X

Uninstalling Universal Capture is easy, however, be aware that sudo access is needed and all data is deleted on the removal of the program.

To remove Universal Capture

  1. Run the following command to run the script:
    • sudo /Applications/Echo360\ Capture.app/Contents/Resources/uninstall.sh
c9f5f1d87ac29bd0c146e9565da3c739@echo360.desk-mail.com
https://cdn.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete