{"id":13582804,"url":"https://github.com/codeforkjeff/refine_viaf","last_synced_at":"2026-01-11T05:54:55.978Z","repository":{"id":23422336,"uuid":"26785151","full_name":"codeforkjeff/refine_viaf","owner":"codeforkjeff","description":"No longer maintained. Please use conciliator instead.","archived":false,"fork":false,"pushed_at":"2020-10-12T17:56:24.000Z","size":445,"stargazers_count":26,"open_issues_count":2,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-03T16:02:37.375Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codeforkjeff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-11-18T00:56:11.000Z","updated_at":"2024-09-26T21:26:06.000Z","dependencies_parsed_at":"2022-07-25T10:02:06.966Z","dependency_job_id":null,"html_url":"https://github.com/codeforkjeff/refine_viaf","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforkjeff%2Frefine_viaf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforkjeff%2Frefine_viaf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforkjeff%2Frefine_viaf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeforkjeff%2Frefine_viaf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeforkjeff","download_url":"https://codeload.github.com/codeforkjeff/refine_viaf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247522629,"owners_count":20952590,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T15:03:02.460Z","updated_at":"2026-01-11T05:54:55.905Z","avatar_url":"https://github.com/codeforkjeff.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"\n**IMPORTANT!** Please use\n[conciliator](https://github.com/codeforkjeff/conciliator) instead,\nwhich does what refine_viaf does, plus more. This project is no longer\nbeing maintained.\n\nrefine_viaf\n===========\n\nrefine_viaf implements a [VIAF](http://viaf.org) (Virtual\nInternational Authority File) Reconciliation Service for\n[OpenRefine](http://openrefine.org). This is used for resolving many\ntypes of names (ie. persons, organizations, geographic regions) to\nstandard IDs representing those entities.\n\nThis project was rewritten in Java in Dec 2015. For more info, see\n[this page](http://codefork.com/blog/index.php/2015/12/10/a-major-update-to-refine-viaf/). The\nold version written in Python is no longer being maintained, but can\nbe found in the\n[python-deprecated branch](https://github.com/codeforkjeff/refine_viaf/tree/python-deprecated).\n\nFeatures\n--------\n\n* Support for the following types of names provided by VIAF: Corporate\n  Names, Geographic Names, Personal Names, Works, Expressions\n\n* \"Proxy mode\" to retrieve IDs used by source institutions, instead of\n  VIAF IDs. (NOTE: hyperlinks to source record pages in OpenRefine are\n  supported for BNE, DNB, ICCU, JPG, LC, NDL, SELIBR, SUDOC, and\n  WKP. Links are BROKEN for BNC, BNF, DBC, and NUKAT. For all other\n  sources, the links will take you to the VIAF page.)\n\n* Good performance (uses threads; stable memory usage; caches results)\n\n* Super easy to run\n\nPublic Server\n-------------\n\nIf your needs are low and you can't or don't want to run this software\nyourself, you can use the public server at\n\u003chttp://refine.codefork.com/\u003e. Visit that address for more\ninstructions.\n\nRunning the Service on Your Computer\n------------------------------------\n\nInstall Java 1.7 or greater if you don't already have it.\n\nDownload the .jar file for the\n[latest release](https://github.com/codeforkjeff/refine_viaf/releases). Alternatively,\nyou can download the source code tarball or clone this repository, and\nbuild the .jar file using maven.\n\nRun this command:\n\n```\njava -jar refine_viaf-1.5.2.jar\n```\n\nThat's it! You should see some messages as the application starts\nup. Now you're ready to configure OpenRefine to use the service. When\nyou're done with it, hit Ctrl-C to quit the application.\n\nConfiguring OpenRefine\n----------------------\n\n1. In OpenRefine, chose a column of names you want to reconcile, and\n   select \"Reconcile\" and \"Start Reconciling...\" in the column\n   pull-down menu.\n\n2. Click \"Add Standard Service...\"\n\n3. To reconcile against names from any VIAF source, type in:\n\n    ```\n    http://localhost:8080/reconcile/viaf\n    ```\n\n    To reconcile against a specific VIAF source, append its code to\n    the end of the path. For example, to search only names from the\n    Bibliothèque nationale de France, type in:\n    \n    ```\n    http://localhost:8080/reconcile/viaf/BNF\n    ```\n\n    To retrieve the IDs used by source institutions, rather than VIAF\n    IDs, use \"proxy mode.\" For example, to search only names from the\n    Library of Congress and retrieve their IDs, type in:\n    \n    ```\n    http://localhost:8080/reconcile/viafproxy/LC\n    ```\n\n4. Follow the instructions on the dialog box to start reconciling\n   names.\n\nAdvanced Usage\n--------------\n\nTo build from the source code, install maven and type:\n\n```\nmvn package\n```\n\nIf you want to host this software on a server for long-term usage or\nif you want to enable logging for debugging purposes, take a look at\n`run.sh` for some helpful options.\n\nYou can change several run-time options (including the service name\nthat appears in OpenRefine and turning caching on/off) by editing the\n`refine_viaf.properties` file.\n\nResources\n---------\n\nSpecification for the Reconciliation Service API:\n\nhttps://github.com/OpenRefine/OpenRefine/wiki/Reconciliation-Service-Api\n\nThis code drew inspiration from these other projects:\n\n* https://github.com/rdmpage/phyloinformatics\n* https://github.com/mikejs/reconcile-demo/\n\nDo you use this thing??\n-----------------------\n\nIf so, please take a few seconds to leave a comment on\n[this page](http://codefork.com/blog/index.php/2015/12/10/a-major-update-to-refine-viaf/). Hearing\nfrom users really motivates me to continue improving this project.\n\nLicense\n-------\n\nThis code is distributed under a GNU General Public License. See the\nfile LICENSE for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforkjeff%2Frefine_viaf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeforkjeff%2Frefine_viaf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeforkjeff%2Frefine_viaf/lists"}