On macOS, users often need to verify what is packed inside an installer or archive without completing the installation. Showing package contents Mac style helps you inspect files, spot potential issues, and confirm licenses before you proceed.
This guide covers several reliable ways to reveal what is inside Mac packages, from simple Finder tricks to precise Terminal commands.
| Method | Interface | When to Use | Level of Detail |
|---|---|---|---|
| Finder Quick Look | Graphical | Quick inspection of standard .pkg and .zip files | File listing and basic metadata |
| Package Installer App | Graphical | Previewing payload location and component choices | Step-by-step component breakdown |
| Expandpkg in Terminal | Command line | Scriptable extraction and deeper file inspection | Full file paths and ownership info |
| xar and pkgutil CLI | Command line | Advanced users working with flat or compressed packages | Raw archive contents and scripts |
Using Finder to Show Package Contents
macOS offers a fast visual way to open package files without installing anything. You can rely on Finder and Quick Look to see the contents at a glance.
Start by opening a new Finder window and navigating to the downloaded .pkg or archive file. Select the item and press the spacebar to activate Quick Look, which displays a preview of the payload structure.
Working with the Package Installer App
The built-in macOS Installer app gives a guided view of what a package will install before you confirm the changes.
Double-click the .pkg file to launch the app, then click Continue through the initial screens. On the Select a Destination step, choose Install but do not finalize the process, and you can review where files will land on disk.
Command Line Expansion with Expand_Pkg
For repeatable inspections, the command line offers precise control over how packages are unpacked.
Use the expand command with the -x and --destination flags to extract the payload to a folder you choose. This approach is ideal when you need to script checks or analyze many packages at once.
Advanced Inspection with XAR and Pkgutil
When you encounter nested or signed packages, deeper tools such as xar and pkgutil become necessary.
In Terminal, xar -xf package.xar extracts flat archive formats, while pkgutil --expandpkg handles compressed variants. These commands reveal internal bill-of-materials files, payloads, and postinstall scripts.
Best Practices for Inspecting Mac Packages
- Use Quick Look for rapid checks and Installer preview for component selection before installation.
- Extract packages to a dedicated folder to keep your system clean and organized.
- Verify payload paths and scripts with xar and pkgutil when dealing with third-party or unsigned packages.
- Document extracted file lists if you need to audit or compare against system baselines later.
FAQ
Reader questions
How do I show package contents Mac for a .pkg file without installing it?
Open the file with the Installer app and stop at the destination selection step, or run expand -x in Terminal to extract the payload to a folder.
Can I preview package contents from the command line only?
Yes, use xar -tf to list top-level entries and pkgutil --payload-files to list every file the package will install.
What if the package is inside a DMG image on Mac?
Attach the DMG from Finder, then apply the same xar, pkgutil, or Expand_Pkg commands to the package file mounted inside.
Will expanding a package modify my system files?
No, listing and extracting packages are read-only actions that do not change your installed applications or system files.