Extract Guide — Mac

How to unpack Mac downloads without corrupting DMGs, app bundles, PKG installers, or plugin folders.

Extraction Is Part of the Install

Mac downloads are rarely a single file you double-click and forget. A download may contain a DMG disk image, PKG installer, app bundle, plugin bundle, ZXP extension, script, or a readme — often several of these together. If the archive is only partially extracted, macOS can report the app as "damaged," the installer can miss helper files, or After Effects can fail to recognize a plugin.

Treat extraction as the first real step of installation. Keep the original archive, extract into its own folder, and never run installers from a preview window or directly inside an archive manager.

Choose the Right Extractor

Keka (Recommended)

Keka is the cleanest choice for password-protected archives, .7z files, .rar archives, and split archive parts. It handles far more formats than Finder's built-in Archive Utility.

Archive Utility (Built-in)

Fine for simple ZIP files and normal DMG mounting. Not reliable for protected or multi-part releases. If Archive Utility extracts an empty folder or says the password is wrong, retry with Keka before assuming the download is broken.

The Unarchiver

A reasonable fallback for common compressed formats. If one extractor fails and the archive size matches the listed download size, trying a second extractor is a valid troubleshooting step.

Clean Extraction Workflow

Move the archive first. Put it in a stable folder — Downloads, Desktop, or a dedicated folder. Don't extract from iCloud placeholders, browser temp folders, or half-synced cloud locations.

Extract into a new folder. Right-click → Open With → Keka. Extract into a folder named after the release. Keeping releases isolated prevents loose installers and readmes from mixing.

Handle split archives as one set. If the download includes parts like .001, .002, or .part1.rar, keep all parts in the same folder and extract from the first part only. The extractor stitches them together automatically.

Keep the archive until verified. Don't delete the original download immediately. Keep it until the app opens, the plugin appears in After Effects, and everything works.

Read the extracted folder first. Look for a readme, install notes, or folder names that explain the target app version. Mac releases often separate files for Intel vs. Apple Silicon, or different Adobe versions.

Understanding File Types

DMG

A disk image. Double-click to mount it, then either drag the app to Applications or run the installer inside. After installation, eject the mounted disk image from Finder (right-click → Eject).

PKG

Opens the macOS Installer app and usually needs an administrator password. PKGs can install into Applications, Library folders, plugin directories, or background service locations. Close Adobe apps before running plugin PKG installers.

APP

An app bundle — Finder shows it as a single file, but it's actually a folder. Move real apps into /Applications. Don't run production apps from Downloads or from inside a mounted DMG.

Plugins, Scripts & Extensions

Native After Effects plugins, CEP/ZXP extensions, and JSX scripts each have different install locations. If your extracted folder contains these instead of a normal app, check the Mac Install Guide for correct placement.

Gatekeeper Warnings

macOS checks downloaded apps before allowing them to run. A "damaged" or "unverified" message doesn't always mean the file is broken — it can mean the app is unsigned, was modified, or has a quarantine flag. Re-extract first, then use the normal approval flow: Control-click the app → Open, or check System Settings → Privacy & Security for an "Open Anyway" button.

Don't blindly strip quarantine metadata from everything. If a file is genuinely compromised, that warning is useful. Only override for files you trust. See the Gatekeeper Guide for proper handling.

Common Problems

Password rejected

Type the password manually — copy-paste can grab invisible spaces. Confirm the archive is fully downloaded and use Keka.

App says damaged after extraction

Re-extract into a fresh folder. If the same bundle still fails, check Gatekeeper quarantine, macOS version compatibility, and whether the release is Intel-only.

DMG opens but nothing installs

Look inside the mounted disk image — it may show a drag-to-Applications layout, a PKG installer, or a readme. Don't copy the DMG itself into Applications.

Extracting from iCloud or cloud sync

Cloud sync can leave placeholder files or lock folders mid-extraction. Move the archive to a local folder first, wait for the download to finish, then extract.