Skip to content

MaastrichtU-Library/omekas-to-wikidata

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

122 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Omeka S to Wikidata Tool

A web-based application that guides users through importing linked data from Omeka S collections into Wikidata. Transform your cultural heritage metadata into structured, linked open data that contributes to the global knowledge base.

Developed by Maastricht University Library and Radboud University Library as part of the 2025 "Open Topstukken" (Open Collection Highlights) project.


πŸš€ Try It Now

β–Ά Launch Live Demo

Start using the tool immediatelyβ€”no installation required. Process your Omeka S data through our guided 5-step workflow and generate Wikidata-ready QuickStatements.

Other Versions


πŸ“š Documentation

For Everyone

  • User Manual - Complete step-by-step guide for using the tool
    • Detailed walkthrough of all five steps
    • Project and file management
    • Tips, best practices, and troubleshooting
    • Perfect for librarians, archivists, and collection managers

For Developers & Contributors


🎯 What Does This Tool Do?

The Omeka S to Wikidata tool bridges cultural heritage collections with the semantic web. It helps you:

  1. Import data from Omeka S APIs (with automatic CORS handling)
  2. Map your metadata fields to Wikidata properties using Entity Schemas
  3. Reconcile values with existing Wikidata entities to avoid duplicates
  4. Add references to document your data sources
  5. Export QuickStatements code for bulk import into Wikidata

Who is this for?

  • Librarians and archivists managing digital collections
  • Collection managers at cultural heritage institutions
  • Digital humanities researchers working with linked data
  • Data curators contributing to Wikidata

No programming required - the tool provides a visual, step-by-step interface for the entire process.


⚑ Key Features

πŸ”„ Automatic CORS Handling

Access Omeka S APIs even when CORS headers aren't configured:

  • Tries direct connection first
  • Automatically falls back to proxy services
  • Provides manual JSON input as last resort
  • Includes administrator guidance for CORS configuration

πŸ’Ύ Save & Reuse Mappings

Create mapping templates once, use them many times:

  • Save mapping configurations as reusable templates
  • Load mappings for similar datasets
  • Share mappings with colleagues
  • Separate mappings from actual data

🎯 Entity Schema Integration

Leverage Wikidata's structured schemas:

  • Select appropriate schemas for your item types (paintings, books, etc.)
  • Get intelligent property suggestions
  • Ensure data quality and consistency
  • Follow Wikidata best practices automatically

πŸ”— Smart Reconciliation

Link to existing Wikidata items to avoid duplicates:

  • Search for matching items in Wikidata
  • Configure property-specific requirements (languages, units, etc.)
  • Edit and validate data before export
  • Track progress across large datasets

πŸ“¦ Project Management

Never lose your work:

  • Save complete project state at any time
  • Resume work later from saved projects
  • Export mapping templates separately
  • Keep backups of your work

πŸ› οΈ How It Works

The tool guides you through five clear steps:

1️⃣ Input

Configure your Omeka S API endpoint and import JSON data. The tool automatically handles CORS issues and validates your data structure.

2️⃣ Mapping

Map your Omeka S fields to Wikidata properties. Select an Entity Schema to get relevant suggestions, and save your mapping as a reusable template.

3️⃣ Reconciliation

Refine individual values, link items to existing Wikidata entities, and configure property-specific settings like language codes.

4️⃣ References

Add source attribution to your statements. Configure which properties receive which references for proper documentation.

5️⃣ Export

Generate QuickStatements code and import your data into Wikidata. Test in the Wikidata Sandbox before going live.

Read the complete User Manual β†’


πŸ”— Related Links


🀝 Contributing

We welcome contributions from developers, documentarians, and users!

Getting Started:

  1. Read the First Edit Guide - Complete walkthrough for new contributors
  2. Check the Contributing Guidelines - Standards and expectations
  3. Review the Technical Documentation - Architecture and patterns
  4. Explore the JavaScript Module Map - Navigate the codebase

Ways to Contribute:

  • πŸ› Report bugs and issues
  • πŸ’‘ Suggest new features
  • πŸ“ Improve documentation
  • πŸ”§ Submit code improvements
  • πŸ§ͺ Add or improve tests
  • 🌐 Translate the interface

πŸ’‘ For Omeka S Administrators

To enable direct API access without proxies, add this to your .htaccess file:

# Enable CORS for API access
<IfModule mod_headers.c>
    Header set Access-Control-Allow-Origin "*"
    Header set Access-Control-Allow-Headers "origin, x-requested-with, content-type"
    Header set Access-Control-Allow-Methods "GET, POST, OPTIONS"
</IfModule>

For production environments, replace "*" with specific trusted domains.


πŸ“„ License

[Add license information here]


πŸ™‹ Support & Contact

  • Issues & Bug Reports: GitHub Issues
  • Questions: Open a discussion or issue on GitHub
  • Project Team: Maastricht University Library & Radboud University Library

🌟 Project Status

This tool is actively developed and maintained as part of the Open Topstukken project. We welcome feedback, bug reports, and contributions from the community.

Latest Updates: Check the development version for the newest features.

About

Omeka S to Wikidata ETL tool

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages