Install and Run Refine
To use Refine you will need a web browser (Firefox or Chrome) and an OpenRefine kit.
- Download: visit the Refine download page and choose the latest “Windows kit with embedded Java” package. This is a self contained package that includes everything needed to run Refine on your system.
- Extract: the package you downloaded will be a zip file that needs to be extracted (e.g. “openrefine-win-with-java-3.4.1.zip”). Unzip the package by right clicking and selecting Extract All. Move the resulting folder to a sensible permanent location on your computer, e.g. “C:\openrefine" or Documents.
- Run: inside the folder you extracted, double click “openrefine.exe” to start Refine. The first time you may get a warning that the publisher could not be verified, dismiss the warning and click Run. Once open, pin the Refine icon to your taskbar for easy access in the future!
Note: if you would like to use the traditional Refine kit, check notes on installing Java on Windows.
- Download: visit the Refine download page and choose the latest “Mac kit”. This is a self contained package that includes everything needed to run Refine on your system (e.g. “openrefine-mac-3.4.1.dmg”).
- Install: drag the Refine kit from your downloads to the Applications folder.
- Run: click the Refine icon in your Applications folder.
- Java: if you do not have Java JRE/JDK, install latest Java from your distro’s repositories. For example, on Ubuntu/Debian:
sudo apt install default-jre
- Download: visit the Refine download page and choose the latest “Linux kit”.
- Extract: the package you downloaded will be a compressed archive (e.g. “openrefine-linux-3.4.1.tar.gz”). Unpack the file using your Archive manager or Tar (e.g.
tar xzf openrefine-linux-3.4.1.tar.gz) to a sensible permanent location (e.g. in your Home directory).
- Run: open a terminal in your OpenRefine directory and type
There are two parts to Refine:
- Terminal Window: Starting Refine differs depending on your OS (see above), but in all cases the app will start running in a terminal window. This is the Refine application running in Java. You can ignore and minimize the terminal window (but do not close!). If something isn’t working, you can check here for error messages.
- GUI Interface: Once Refine is running in a terminal, your default web browser should automatically open with the interface–which is a “web page” in your browser. If it does not open automatically or you close the browser tab, find the GUI by typing http://127.0.0.1:3333 or
localhost:3333in your address bar.
To shut down close any Refine tabs you have open in your browser, then stop the host terminal window with
Command-Q on Mac).
This will ensure any open projects are safely saved.
The user interface is rendered by your web browser, but Refine is not a web application. Although it uses the term upload and download, no information is sent online and no internet connection is necessary. For best results, use Firefox, Chrome, or Chromium browser.