Distribution ZIP/TGZ files are located at releases page.
Just download it and unzip/untar into the
extensions folder in your OpenRefine instance, for more information visit OpenRefine - Installing Extensions.
$ unzip metadata-X.Y.Z-OpenRefine-3.3.zip path/to/openrefine-3.3/webapp/extensions # or $ tar xzvf metadata-X.Y.Z-OpenRefine-3.3.tgz -C path/to/openrefine-3.3/webapp/extensions
We publish Docker images that contains OpenRefine 3.3 together with the metadata extension. Only requirement is having Docker service running:
$ docker run -p 3333:3333 fairdata/openrefine-metadata-extension
To persist data and eventually be able to share them across multiple instances of OpenRefine, you need to mount
/data directory, for example:
$ docker run -p 3333:3333 -v /home/me/openrefine-data:/data:z fairdata/openrefine-metadata-extension
To add other extensions (e.g. RDF extension), you can just put them into the mounted folder according to the official documentation. Always also check installation instruction of the desired extension. For the previous example, you should place your extensions to the directory
Configuration files are located in
extensions/metadata/module/config folder and examples are provided. In case of Dockerized instance, you need to mount this folder with your configuration files as volume similarly to
For more information, visit our documentation.
You are required to have Maven installed with other necessary tools for building Java (see OpenRefine - Documentation for Developers):
$ mvn clean compile
To create a distribution ZIP/TGZ files, run:
$ mvn package
After issuing these commands, prepared ZIP/TGZ files should be located in
target directory according to the Maven output.
Build with Docker
You can also use provided multistage
that builds the extension and then runs it in OpenRefine. Therefore, you don't need
any Java dependencies locally, just Docker:
$ docker build -t openrefine-metadata:local-tag . $ docker run -p 3333:3333 openrefine-metadata:local-tag
Then open http://localhost:3333 in your favorite web browser.
You can also build a Docker image with specific OpenRefine version using argument (see Dockerfile for details):
docker build . -t openrefine-metadata:local-or3.2 --build-arg OPENREFINE_VERSION=3.2
Note that we are using Java SE 8 (LTS), concretely OpenJDK 8 in Docker images (to comply with OpenRefine requirements).
This project is licensed under MIT license - see the LICENSE file for more information.