Installation Instructions - tfmorris/OpenRefine GitHub Wiki
How to install and run Refine
If you have been using Freebase Gridworks 1.1, here are the UpgradingTo2p0 upgrading instructions.
OpenRefine is a desktop application in that you download it, install it, and run it on your own computer. However, unlike most other desktop applications, it runs as a small web server on your own computer and you point your web browser at that web server in order to use Refine. So, think of Refine as a personal and private web application.
NOTE: The current release version is called Google Refine. This page uses the new name, OpenRefine, in anticipation of the next release.
- Download OpenRefine here.
- Install it as detailed below for your operating system.
- As long as OpenRefine is running, you can point your browser at http://127.0.0.1:3333/ to use it, and you can even use it in several browser tabs and windows.
- If you're running a proxy, you can change the IP configuration with -i, see Running & Configuration below, or use refine -help for options.
The development version hasn't had the same level of testing that the release version has, but we generally try to keep it in good shape. It will have bug fixes which are not yet available in the release version, but may also have new bugs as well.
Here are step-by-step instructions to get & build the development version:
Install: Once you have downloaded the .zip file, uncompress it into a folder wherever you want (such as in C:\Google-Refine).
Run: Run the .exe file in that folder. You should see the Command window in which OpenRefine runs. By default, the Command window has a black background and text in monospace font in it.
Shut down: When you need to shut down OpenRefine, switch to that Command window, and press Ctrl-C. Wait until there's a message that says the shutdown is complete. That window might close automatically, or you can close it yourself. If you get asked, "Terminate all batch processes? Y/N", just press Y.
Install: Once you have downloaded the .dmg file, open it, and drag the OpenRefine icon into the Applications folder icon (just like you would normally install Mac applications).
Run: To launch OpenRefine, go to the Applications folder and double click the OpenRefine app. You'll see the OpenRefine app appear in your dock.
Shut down: You can switch to the OpenRefine app (clicking on its icon in the dock) and invoke its Quit command.
Install / Run: Once you have downloaded the tar.gz file, open a shell and type
tar xzf google-refine.tar.gz cd google-refine ./refine
This will start OpenRefine and open your browser to its starting page.
Shut down: Press Ctrl-C in the shell.
By default (and for security reasons) Refine only listens to TCP requests coming from localhost (127.0.0.1). If you want to respond to TCP requests coming to any IP address the machine has, run refine like this from the command line
./refine -i 0.0.0.0