Skip to content

Installing

Matt Miller edited this page Dec 17, 2025 · 1 revision

OpenRefine

First step is to install OpenRefine. Download here and follow these install intructions.

Mac

The easiest way to get started with BookReconciler is to use the Electron App. Download from the release page.

Newer Macs (2020+) use Apple Silicon while older Macs use Intel.

  • Open the .dmg file and drag BookReconciler to Applications
  • Right-click BookReconciler.app → Open
  • Click "Open" when macOS shows security warning (if needed)

Windows

On windows download the Windows from the release page. You may run into these prompts:

Screenshot 2025-12-17 002243

Click More Info and then:

Screenshot 2025-12-17 002251

Run Anyway

Once installed on both Mac or Windows you should see two screens, the App and the configuration web browser:

Screenshot 2025-12-17 002334

Docker

There is also a docker image for any system / linux. It comes with a docker compose file so simply run the command line command docker compose up and head to http://127.0.0.1:5001 in your web browser.

Python

You can also run the program as python script.

pip3 install -r requirements.txt
./run_dev_server.sh

Clone this wiki locally