Commons:OpenRefine

Shortcut: COM:OR

About

How to: upload files

How to: edit files

Advanced tips and tricks

Training

Projects

OpenRefine is a free and open source (FOSS) tool with which you can (batch) edit and upload files on Wikimedia Commons. OpenRefine focuses on adding and editing structured data. OpenRefile is available as a cloud service on PAWS to Wikimedia users.

• 
  Um típico projeto da Wikimedia Commons no OpenRefine
• 
  Um esquema no OpenRefine que prepara edições para a Wikimedia Commons

Essa página coleta informações sobre o OpenRefine para a comunidade da Wikimedia Commons.

• OpenRefine para Wikidata: Wikidata:Tools/OpenRefine
• Informações gerais sobre o OpenRefine para Wikimedianos: OpenRefine

Perguntas frequentes

Eu estou com problemas em instalar/abrir o OpenRefine no meu computador. O que devo fazer?

You can download the latest stable version of OpenRefine from its website. OpenRefine's manual includes detailed installation instructions; make sure to read these.

• If you use Windows, then make sure you install the OpenRefine kit with embedded Java.

Some users are unable to install OpenRefine because of, for instance, firewall issues, or because their organization or company does not allow users to install external software. In that case, you can use Wikimedia's cloud version of OpenRefine on PAWS, which is described elsewhere on this page.

Does OpenRefine allow upload of all types of files that Wikimedia Commons supports?

OpenRefine supports all kinds of media files that can be uploaded to Wikimedia Commons. It does not support the upload of data files.

Many upload tools, including OpenRefine, sometimes have trouble uploading TIFF files.

Please note that OpenRefine supports uploading local files up to 100MB, not larger. It is possible to upload larger files from URL though.

Qual é o tamanho máximo de arquivos que podem ser enviados ao Wikimedia Commons com o OpenRefine?

OpenRefine does not (yet) support Chunked Uploads, and hence only allows uploads of files from your local drive up to 100MB. See GitHub issue (help is very welcome to address and fix this issue). Uploading larger files to Wikimedia Commons is possible via URLs on the web. If that is not an option for you, please use Pattypan or the Upload Wizard.

How many files can I upload in one session or project? Can I upload 10,000s or even 100,000s of files at once?

OpenRefine can easily handle datasets of up to tens of thousands (potentially hundreds of thousands) of rows of data. The bottleneck is the speed of uploading files to Wikimedia Commons, which is regulated by the Wikimedia Commons API. For an upload of thousands of files at once (or more), you will need some patience and you will need to keep OpenRefine open.

Can OpenRefine retrieve embedded metadata from files (like EXIF metadata)?

This is not possible inside OpenRefine. We recommend using EXIFtool https://exiftool.org. This YouTube video explains the process quite clearly.

What are the (dis)advantages of running OpenRefine locally? What are the (dis)advantages of the cloud (PAWS) version of OpenRefine?

When running OpenRefine locally (on your own computer):

• On your own computer, it will especially be easier when you want to do file uploads to Wikimedia Commons. You will be able to upload files from your own local harddrive. This is not possible on PAWS.
• On your own computer, you can do various tasks (especially data cleanup and joining/splitting data) without an internet connection. You do need an internet connect as soon as you want to do reconciliation and upload data and files to Commons and Wikidata.

When running OpenRefine in the cloud (via Wikimedia PAWS):

• The cloud version is convenient when you can't easily install new software on your own computer.
• You always need a live internet connection for this.
• With this PAWS/cloud version, it is not possible to upload images from your local computer.

Links gerais

• Site do OpenRefine: https://www.openrefine.org/
• Baixe o OpenRefine: https://openrefine.org/download.html
• Baixe e instale a extensão da Wikimedia Commons para o OpenRefine: https://github.com/OpenRefine/CommonsExtension
• General OpenRefine documentation: https://openrefine.org/docs

Fale sobre o OrenRefine com a sua comunidade e com os usuários da Wikimedia

• Faça perguntas no fórum da comunidade do OpenRefine: https://forum.openrefine.org - Clique aqui para criar um post novo no fórum do OpenRefine]
• Grupo do Telegram para Wikimedianos que usam o OpenRefine: https://t.me/ Qc23Jlay6f4wOGQ0

Bug reports and feature requests

• On GitHub (for OpenRefine in general): Post a feature request on GitHub
• On Wikimedia Phabricator (mainly for Wikimedia Commons reconciliation): Post a bug report on Phabricator

Logo do OpenRefine

559 515 files have been uploaded with OpenRefine.

• Wikimedia Commons edits with OpenRefine 3.7
• Arquivos da Wikimedia Commons enviados com o OpenRefine
• Arquivos enviados por mês
• Last batches on Wikimedia Commons with OpenRefine (via EditGroups)
• Mais métricas

Open Refine

2022 Coolest Tool
Award Winner

in the category
Eggbeater

Aprenda como usar o OpenRefine para o Wikimedia Commons: curso Wikilearn

This online course is available at any time, for free, for anyone with a Wikimedia account. It can be followed at your own pace, with computer-graded exercises. Following the course takes an average of 6 to 8 hours.

Start the WikiLearn course: OpenRefine for Wikimedia Commons: the basics.

Envie arquivos ao Wikimedia Commons com o OpenRefine (versão 3.7)

For uploading files to Wikimedia Commons, you need OpenRefine 3.7. Wikimedia Commons upload is not supported in OpenRefine 3.6 or earlier versions.

Siga o passo a passo de como editar arquivos da Wikimedia Commons com o OpenRefine.

Edite arquivos na Wikimedia Commons com o OpenRefine (versão 3.7 e mais nova)

For editing Wikimedia Commons, you need OpenRefine 3.6 or newer. Wikimedia Commons is not supported in OpenRefine 3.5 or earlier versions. It is highly recommended to also install OpenRefine's Wikimedia Commons extension.

Siga o passo a passo de como editar arquivos da Wikimedia Commons com o OpenRefine.

Dicas avançadas

There is also a page with advanced tips and tricks, which include more instructions on working with manifests and reconciliation, retrieving EXIF, special GREL recipes, and more. Add your own!

Install and run OpenRefine

Como um aplicativo local no seu computador

OpenRefine can be downloaded as an application and works on desktop and laptop computers with Windows, Mac and Linux operating systems. It runs a small server on your computer and you then use a web browser to interact with it. It works best with browsers based on Webkit, such as Google Chrome, Chromium, Opera and Microsoft Edge, and is also supported on Firefox.

Você pode baixar o OpenRefine aqui. Instruções de instalação estão disponíveis no manual de usuário do OpenRefine.

Extensão da Wikimedia Commons para o OpenRefine

Additionally, you can also install OpenRefine's Wikimedia Commons extension. This is not necessary, but helpful for Wikimedia Commons batch editing. It offers:

• A start screen to load file names directly from Wikimedia Commons categories.
• Thumbnails of Commons files (not all file formats supported yet).
• Several dedicated GREL expressions to retrieve data from wikitext for further processing.

O download e instruções de instalação estão disponíveis em at https://github.com/OpenRefine/CommonsExtension

In the cloud (via Wikimedia PAWS)

If you are unable to install OpenRefine on your computer, or if it runs very slowly, then you can also use it in the cloud (on wmcloud.org through PAWS). Everyone with a Wikimedia account can access OpenRefine here. Visit https://hub-paws.wmcloud.org/, log in, and click on the OpenRefine (blue diamond) logo.

The Wikimedia Commons extension (mentioned above) is installed in OpenRefine on PAWS. Please note: with OpenRefine on PAWS it is NOT possible to upload files to Wikimedia Commons from your local computer.

 Launch PAWS

Demo: start OpenRefine on Wikimedia PAWS

OpenRefine via PAWS is not managed by the OpenRefine team; if you have any questions or comments about this service, you can submit a ticket in the PAWS project on Phabricator or ask a question on its talk page.

Log of past activities, presentations...

Quando	Atividade	Links
July 2023-June 2024	OpenRefine and Wikimedia Commons training and sustainability project (funded from Wikimedia Foundation funds)	Página do projeto Train-the-trainer program Midpoint report
August 13, 2022	Tutorial: Batch uploading to Wikimedia Commons with OpenRefine at Wikimania 2022	Etherpad / Video recording
June 9, 2022	OpenRefine and SDC editing tutorial, Wikidata Lab XXXIV	Video recording
May 19, 2022	One hour demo for beginners: Wikimedia Commons batch editing with OpenRefine (tutorial by Sandra Fauconnier), during Image Description Week
March–June 2022	Monthly OpenRefine office hours	No notes/recordings (the meetings were informal)
22 de fevereiro de 2022	OpenRefine community meetup with demo of Structured Data on Commons functionalities	Slides and meeting recording
July 2021 – October 2022	Development of Wikimedia Commons features for OpenRefine (funded by a Wikimedia Foundation Project Grant)	Monthly reports Midpoint report Final report (Nov 2022) Project board on GitHub (OpenRefine)