How to open .CAR files on Mac
To open .CAR files on Mac, install and use IPFS Kubo (CLI) to work with .car files via DAG import/export workflows described in the Kubo CLI docs.
Step-by-step instructions
- Install and use IPFS Kubo (CLI) to work with .car files via DAG import/export workflows described in the Kubo CLI docs.
- Use ipfs-car to pack/unpack CAR archives when you want to extract content or rebuild a CAR file.
Recommended software
- VS Code
- Notepad++/TextEdit
- jq (CLI)
Alternative methods
- Open .CAR in a browser-based viewer if desktop apps fail.
- Try opening .CAR on Mac with a secondary app to rule out app-specific issues.
- Convert .CAR only with trusted tools when direct opening is not possible.
Common issues
The .CAR file won’t open in a normal archive or media app
CAR is not a ZIP/RAR media container; it stores IPLD/IPFS blocks addressed by CIDs, so typical desktop viewers won’t recognize it.
- Open it with IPFS/IPLD tooling (IPFS Kubo for import/export workflows, or ipfs-car for pack/unpack operations).
- If you expected regular files (e.g., a folder), use a CAR unpacking workflow (such as ipfs-car) rather than a generic archive utility.
Import/export fails (file is malformed or incompatible)
Tools may reject CAR files that are not well-formed according to the CAR specification or are otherwise truncated/corrupted.
- Re-download or re-export the .car file to rule out truncation or partial transfers.
- Confirm the producing tool matches the CAR spec expectations (see the IPLD CAR spec hub and CARv1 specification) and use a compatible reader/writer implementation (e.g., Kubo, ipfs-car, or js-car).
You imported the CAR but can’t find the expected content
A CAR can contain multiple roots or a different root than you assumed; without the correct root CID, the data you want may not be obvious.
- Check the roots/entry points using CAR-capable tooling (e.g., a CAR reader/writer utility or library) and identify the correct CID root for the data you need.
- Repeat the export/import using the intended root CID when generating the CAR (per the IPFS Kubo DAG export/import workflow).
Security note
Treat .car files as untrusted input: they are parsed by complex codecs and block-processing code, so only use reputable tools and keep them updated.