OpenRefine Installation Help

Overview

OpenRefine is a tool for data cleaning that runs through a web browser (Chrome, Safari, Firefox, Edge). I recommend Chrome. You will need to download and install Google Refine. When you open it, it will run through the browser, but you don't need an internet connection. The data will all be stored on your computer.​

Windows

· Go to the OpenRefine download page.

· Click on Windows kit to download the install file

· To use it, unzip, and double-click on google-refine.exe

· Google Refine will then open in your web browser.

oYou will first see a black box appear; this is your command line window - leave it open during your time using OpenRefine. In a few more seconds, the OpenRefine interface will appear in your internet browser. ​

· If it doesn't open automatically, open a web browser after you've started the program and go to the URL http://localhost:3333 and you should see OpenRefine.

Mac

· Go to the OpenRefine download page.

· Click on Mac kit to download the install file

· Open the downloaded .dmg file

· Drag the icon in to the Applications folder

· Double click on the icon and Google Refine will then open in your web browser.

· If it doesn't open automatically, open a web broswer after you've started the program and go to the URL http://localhost:3333 and you should see OpenRefine.

​

Note for Mac users: Sometimes, Macs will not allow you to open OpenRefine since it is from an unidentified developer. You may see an error message similar to this: "openrefine-mac.dmg can't be opened because it is from an unidentified developer." Please see these official Mac instructions to allow trusted program to run.

Linux

· Go to the OpenRefine download page.

· Click on Linux kit to download the install file

· Download and extract

· Type ./refine to start and Google Refine will then open in your web browser.

· If it doesn't open automatically, open a web broswer after you've started the program and go to the URL http://localhost:3333 and you should see OpenRefine.

Additional Resources

OpenRefine Documentation: https://docs.openrefine.org/manual/installing

Github for OpenRefine: https://github.com/OpenRefine/OpenRefine