Mac seems to have a few issues when trying to install OpenRefine. The official instructions are on the OpenRefine wiki, but this list brings together resources to trouble shoot some common issues.
-
Open Refine needs Java JRE. OS X has a few issues with Java, many are documented at Oracle Java on Mac OS X. Older versions of Java are automatically disabled by OS X. Its best to go to the Java page and just download and install the most up-to-date version for Mac. If you try the rest of this install process and Refine still doesn't work, you may need the legacy Java from Apple.
-
Download the
.dmgversion of the latest OpenRefine release,openrefine-mac-2.6-rc.2.dmg, from https://github.com/OpenRefine/OpenRefine/releases -
Install by opening the
.dmgand dragging the OpenRefine icon into the Applications folder icon. Older versions of Refine and/or OS X might prompt an error message: "Google Refine is damaged and can't be opened". This is due to OS X Gatekeeper misidentifying Refine. You need to change a setting, in Apple menu > System Preferences... > Security & Privacy > General tab > "Allow applications downloaded from:" > change to "Anywhere". -
Run by double clicking on the OpenRefine icon in he Applications folder. OpenRefine icon should appear in your dock, and a browser window should automatically open. However, sometimes a browser window does not automatically open. Then manually navigate to http://localhost:3333/ or http://127.0.0.1:3333/ to find the Refine interface.
-
Shutdown by clicking the OpenRefine icon in the dock and then typing
Command-Q.