CSC Logo

CSCview - Installation & Troubleshooting Guide

Important: Check your Mac Architecture

Before downloading, verify if your Mac uses an Intel or Apple Silicon (M1/M2/M3) processor to ensure you get the compatible installer:

  1. Click the Apple Menu (Mac Icon) in the top-left corner of your screen.
  2. Select About This Mac.
  3. Look for Processor (Intel) or Chip (Apple Silicon).

On macOS, exceptions to default security settings are required for CSCview. If you encounter an error stating the app cannot be installed, or that it cannot be opened because it is from an unidentified developer, follow the steps for your OS version below.

Special Note for Managed Macs (JAMF / IT Managed)

If you are using a Mac managed by JAMF or your organization's IT department, the installer may be blocked or "quarantined" upon download. To ensure the installation succeeds, you must manually clear the extended attributes before opening the .pkg file:

  1. Open the Terminal app.
  2. Type the following command (but do not press enter yet):
    xattr -rc
  3. Drag the downloaded CSCview.pkg file from your Downloads folder directly into the Terminal window to auto-fill the path.
  4. Press Enter.

Once complete, you may proceed with the standard installation steps below.

Ventura, Sonoma, Sequoia, and Tahoe

  1. Double-click the CSCview.pkg file. You will see a warning with options to Move to Trash or Done. Click Done.
  2. Open System Settings > Privacy & Security.
  3. Scroll all the way down on the right to the Security section. You will see a message stating "CSCview" was blocked.
  4. Click Open Anyway.
  5. A new popup will appear with three options. Click Open Anyway again.
  6. Enter your computer password when prompted to begin the standard installation process.

Sierra through Monterey

Ctrl-click on CSCview in Finder and click on Open. The following is displayed:

"CSCview" is from an unidentified developer. Are you sure you want to open it?

Click on Open.

El Capitan and earlier

Go to System Preferences -> Security & Privacy -> General, and change Allow applications downloaded from: to Anywhere

Troubleshooting: App Crashes on Launch

If CSCview installs successfully but crashes immediately upon opening without an error message, follow these steps to identify the root cause.

1. Reveal the Hidden Error

Standard macOS launches hide technical errors. To see why the app is failing, launch it manually via the Terminal:

/Applications/CSCview.app/Contents/MacOS/CSCview

Look for lines starting with "Exception" or "Library not loaded". If you see an UnsatisfiedLinkError, it means a system dependency is missing.

2. Check for Missing Dependencies

If the error mentions a missing .dylib (dynamic library), you can check which file is requesting it using the otool command. This is common if the app was built on a machine with Homebrew and is looking for libraries in non-standard paths:

otool -L /Applications/CSCview.app/Contents/runtime/Contents/Home/lib/libfontmanager.dylib

Common Fix: If the output shows paths starting with /opt/homebrew/, the installation is missing local components. Please contact the Helpdesk with the output from your Terminal window.

For online support please contact the CXC Helpdesk.