How to open .DVC files on Mac
To open .DVC files on Mac, if it is a DVC metadata file: open it in a text editor to read it, and use the DVC command-line tool to manage the corresponding data artifact.
Step-by-step instructions
- If it is a DVC metadata file: open it in a text editor to read it, and use the DVC command-line tool to manage the corresponding data artifact.
- If it is an IDRISI Vector (DVC) file: you will usually need the originating GIS software/workflow; if you cannot open it on macOS, transfer it to a system with the required GIS tool.
Recommended software
- VS Code
- Notepad++/TextEdit
- jq (CLI)
Alternative methods
- Open .DVC in a browser-based viewer if desktop apps fail.
- Try opening .DVC on Mac with a secondary app to rule out app-specific issues.
- Convert .DVC only with trusted tools when direct opening is not possible.
Common issues
The .DVC file opens as unreadable characters
This often means it is not a DVC metadata text file, but a different .dvc format such as a GIS vector data file (e.g., IDRISI Vector).
- Confirm where the file came from (a DVC repository vs. a GIS workflow) and check for surrounding project files that indicate DVC usage.
- If it is from GIS/IDRISI workflows, open it with the originating/compatible GIS software rather than a text editor.
You can read the .DVC file but the data it references is missing
In DVC projects, the .dvc file is metadata; the actual data may live in remote storage and won’t appear until you fetch/checkout it with DVC.
- Use the DVC tool in the correct project directory to retrieve the tracked artifact according to your project’s DVC setup.
- Make sure you have access to the project’s configured storage/remote used for DVC-tracked data.
Double-clicking does nothing or opens the wrong app
Operating systems don’t always associate .dvc files with a specific program, and the extension is used by more than one format.
- Open the file in a text editor first to determine whether it looks like human-readable metadata (common for DVC).
- If it is a DVC metadata file, keep editing/viewing in a text editor and manage it with the DVC tool rather than relying on file association.
Security note
.dvc files used by DVC are typically human-readable metadata; treat them like configuration files and review changes (especially in shared repos) before using them to pull or reproduce data.