OpenRefine / OpenRefine/openrefine.org
Document the workaround steps for running OpenRefine on OS's that block running unsigned apps
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 161
- Forks
- 142
- Avg merge
- 6h 10m
- Merged PRs (30d)
- 9
Description
Until we solve OpenRefine/OpenRefine#3003 and OpenRefine/OpenRefine#4568 we should document workaround steps.
Some OS's such as MacOS and Windows have additional steps needed for users to acknowledge installing applications downloaded from untrusted sources, or unsigned applications.
Proposed solution
Until OpenRefine has the capability to be considered an approved signed application for MacOS and Windows, we should:
- provide workaround steps in our docs for running OpenRefine.
- As a user, test on MacOS and Windows 10/11 that the workaround steps allow OpenRefine to be run.
Alternatives considered
Additional context
For example, here is a screenshot that could be added to our docs for Windows where running OpenRefine 3.5.2 openrefine.exe for the first time on Windows 11 where the user needs to click on More info and then click the button that appears Run anyway

Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No documentation file is named, so first locate the guide covering installation or running OpenRefine. Document the workaround steps for unsigned apps on macOS and Windows, then test them on macOS and Windows 10/11; done means users can launch OpenRefine by following the documented steps.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos
- Domain
- documentation, operating-systems
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100