Skip to main content
v2026.11,986 entries · CC-BY 4.0

Hill Museum & Manuscript Library: Guide to vHMML Research Tools

Comprehensive research guide to the Hill Museum & Manuscript Library (HMML), vHMML Reading Room, manuscript metadata schemas, and open paleography tools.

Written and maintained by CASRAI Editorial Board

Published · Last updated

On this page

The Hill Museum & Manuscript Library (HMML), based at Saint John’s University in Collegeville, Minnesota, is an international cultural preservation institution and digital humanities research infrastructure provider dedicated to the photographic and digital preservation of endangered handwritten heritage. Through its virtual platform, vHMML, researchers, philologists, and digital humanists gain open, web-based access to high-resolution digital surrogates and cataloging metadata for approximately 486,000 manuscripts and rare printed books spanning European, Middle Eastern, African, and South Asian traditions.

What it is used for in research

Founded in 1965 by Father Oliver Kapsner, OSB as the Monastic Manuscript Microfilm Project at Saint John’s Abbey and University, HMML initially preserved European monastic codices threatened by Cold War tensions and physical degradation. Under the leadership of Executive Director Father Columba Stewart, OSB, the organization expanded into an international preservation initiative. HMML prioritizes manuscript cultures in regions endangered by armed conflict, civil instability, and looting, establishing field digitisation partnerships across more than 30 countries, including Iraq, Syria, Mali, Egypt, Lebanon, Ethiopia, Ukraine, Malta, and South India.

In academic research, HMML and its digital platform vHMML support distinct interdisciplinary workflows:

  • Primary Text Recovery and Philology: Scholars access digitized codices containing unedited literary, legal, philosophical, and liturgical texts. Holdings in Christian Arabic, Classical Syriac, Garshuni, Ge’ez, Armenian, Coptic, Latin, and Timbuktu Islamic manuscripts enable researchers to establish critical editions, trace variant readings, and compile authoritative collations.
  • Codicological Analysis: Codicologists inspect physical book construction remotely. Detailed records capture leaf dimensions, support materials (such as animal parchment, papyrus, and laid paper), quire gatherings, ruling patterns, and historic bindings.
  • Paleographical Instruction: Through the integrated HMML School portal, students and researchers study historical scripts across Latin hands (classical antiquity to Renaissance humanism), Syriac hands (Estrangela, Serto, and East Syriac), and early Arabic scripts.
  • Provenance and Archival History: Researchers reconstruct dispersed monastic and communal libraries through ownership notes, marginal colophons, waqf endowments, and institutional stamps.
  • Computational Humanities and Linked Data: Computational linguists and data specialists query standardized entities in the HMML Authority File (HAF) and ingest bulk records from the vHMML Data Portal into knowledge graphs, enriching research bibliography systems.

How to install or access it

The vHMML research environment operates entirely as a browser-based cloud platform hosted by the Hill Museum & Manuscript Library. Researchers do not need to install local desktop software, client binaries, or browser plugins. The application runs in any modern desktop or mobile browser with JavaScript enabled, including Chromium, Mozilla Firefox, Apple Safari, and Microsoft Edge.

Platform access is structured into five official channels:

  • Open Catalog Search: Anyone can visit https://www.vhmml.org to query the vHMML Reading Room catalog, review codicological descriptions, and access HMML School tutorials without logging in.
  • Free Registered Account: To inspect high-resolution manuscript images in the deep-zoom viewer, users must create a free account at https://www.vhmml.org with a valid email address. Registration grants immediate access to tens of thousands of open digital codices.
  • Restricted Materials: Certain microform collections and partner archives are governed by custodial agreements that limit digital image access to in-person consultation at the HMML facility in the Alcuin Library at Saint John’s University, or require formal scholarly permission.
  • Open Data Portal: Complete database dumps and filtered records are downloadable at https://www.vhmml.org/data under a Creative Commons Attribution 4.0 International license (CC BY 4.0).
  • HMML Authority File (HAF) API: Programmatic access to standardized name, corporate, and geographic entities is available via the public REST API at https://api.haf.vhmml.org/.

Step-by-step instructions

The following procedures outline three core research tasks: searching manuscripts in vHMML Reading Room, exporting datasets from the Data Portal, and querying the HMML Authority File API.

Task 1: Searching manuscripts in vHMML Reading Room

  1. Sign In to your account: Navigate to https://www.vhmml.org/readingRoom and click Sign In in the upper-right corner. Enter your registered email and password.
  2. Open Advanced Search: On the Reading Room landing page, click the Advanced Search toggle adjacent to the primary search bar to open faceted search fields.
  3. Apply Search Filters:
    • In the Country and City fields, specify the repository location (e.g., “Austria”, “Jerusalem”, “Timbuktu”).
    • In the Repository field, select the holding archival partner.
    • In the Language dropdown, select the scribal language (“Syriac”, “Latin”, “Arabic”).
    • In the Date Range boxes, enter calendar boundaries in Begin Date and End Date.
    • In the Support filter, choose “Parchment” or “Paper”.
  4. Execute Search: Click the Search button to populate matching records with thumbnail previews and repository shelfmarks.
  5. Inspect the Catalog Record: Click a result card to examine the Object, Part, and Contents tabs.
  6. Launch the High-Resolution Viewer: Click View Images to open the IIIF-compliant viewer. Use zoom controls or scroll to inspect script details, or click the Two-Up icon for facing folios.

Task 2: Exporting bulk manuscript metadata from the Data Portal

  1. Navigate to the Data Portal: Open https://www.vhmml.org/data.
  2. Select Dataset Category: Under Download Complete Datasets, select Reading Room Records.
  3. Choose Export Format: Click Full Metadata (JSON) for complete line-delimited records, or Limited Fields (CSV) for essential columns (Country, City, Repository, Shelf Mark, HMML Project Number, and PURL).
  4. Run Curated Query Exports: For targeted corpora, execute your search in Reading Room, click Export, and download up to 10,000 records under the CC BY 4.0 license.

Task 3: Querying the HMML Authority File (HAF) via API

Developers and researchers can retrieve authority records programmatically using standard HTTP GET requests. Execute the following curl command in a terminal:

curl -s "https://api.haf.vhmml.org/names?query=Ephrem" | python3 -m json.tool

The API responds with JSON records containing standardized headwords, transliterated name variants, Library of Congress NACO control identifiers, and persistent URIs.

Output and how to read it

The primary analytical output of the platform is its three-tiered catalog record, designed around a specialized metadata schema tailored to complex manuscript codicology:

  • Object Level: Describes the entire physical codex. Fields include Repository Shelfmark (custodial call number), HMML Project Number (persistent microfilming identifier), Binding Description, Dimensions (height × width × depth in millimeters), Condition Notes, and PURL (permanent URL).
  • Part Level: Documents distinct structural or codicological units bound within the object. Each part records the Place of Origin, Date Range, Support Material (e.g., parchment vs. paper), Layout (columns, line counts), and Script Classification.
  • Contents Level: Details individual textual works within a part, including Title as Appears, Uniform Title, Author Attribution (linked to HAF authorities), Language, Incipit, Explicit, and Foliation.

When evaluating these records in comparison with institutional repositories and subject repositories, the vHMML schema maps directly into Dublin Core for broad discovery and METS (Metadata Encoding and Transmission Standard) for digital preservation. In scholarly publications, researchers cite the holding repository and HMML surrogate together: Jerusalem, Greek Orthodox Patriarchate, MS Saba 82 (HMML Project Number: JGP 00082), vHMML Reading Room, PURL: [URI].

Troubleshooting

Researchers may encounter operational hurdles when using the platform. Recommended resolutions include:

  • Authentication Loops: If clicking an image redirects repeatedly to the login prompt, your session has expired or browser extensions are blocking cross-origin cookies. Clear cookies for vhmml.org and sign in again.
  • Restricted Image Notices: When catalog metadata displays but images are unavailable, the codex is governed by a restricted custodial agreement. Full viewing may require in-person consultation at Saint John’s University or a direct scholarly inquiry to HMML curatorial staff.
  • IIIF Deep-Zoom Latency: Slow tile loading during deep zoom indicates network throttling or hardware acceleration limits. Enable WebGL in browser settings and switch from “Two-Up” spread to “Single Page” view.
  • Shelfmark Discrepancies: If a published shelfmark does not return hits, the custodial repository may have reclassified the volume. Search instead by the legacy HMML Project Number or textual incipit.
  • Data Portal Sync Lag: Complete Data Portal archives update weekly. Cataloging additions made within the past seven days will appear in the next automated export cycle.

Free alternatives

The table below summarizes leading free, open-access manuscript repositories and cataloging platforms complementary to vHMML:

Platform Host Institution Regional / Script Focus IIIF Viewer Bulk Metadata Export Key Feature
vHMML Hill Museum & Manuscript Library Endangered Middle East, Africa, South Asia, Central Europe Yes Weekly JSON & CSV (CC BY 4.0) Largest collection of endangered Eastern Christian and Islamic manuscripts
DigiVatLib Vatican Apostolic Library Western Christian, Byzantine, Classical codices Yes (Mirador) OAI-PMH & IIIF manifests Direct access to foundational Vatican archival and theological codices
Gallica Bibliotheque nationale de France French, European, Near Eastern illuminated texts Yes OAI-PMH, SPARQL, REST API Exceptional depth in French illuminated manuscripts and royal collections
Digital Bodleian University of Oxford British, European, Hebraica, Orientalia Yes IIIF Manifests & University Data Catalog Over one million high-resolution images from Oxford collegiate libraries
e-codices University of Fribourg Medieval and early modern Swiss collections Yes (Mirador) TEI P5 XML & CSV dumps Scholarly codicological descriptions for Swiss monastic collections
Handschriftenportal Staatsbibliothek zu Berlin consortium German and Central European manuscripts Yes TEI-XML & open REST API Union catalog uniting hundreds of German municipal and university archives
Endangered Archives British Library Endangered community archives worldwide Yes OAI-PMH & open British Library metadata Preserves non-state and regional archives across Africa, Asia, and the Americas

Scholars conducting comprehensive textual recensions or regional surveys should pair vHMML with these institutional repositories. While platforms such as DigiVatLib, Gallica, and Digital Bodleian house prestigious metropolitan collections, vHMML and the Endangered Archives Programme uniquely safeguard decentralized monastic, municipal, and private archives that exist outside national library networks. In addition, the dataset below provides technical comparison metrics across these systems.

Frequently asked questions

Is access to the vHMML Reading Room completely free?

Yes. Access to the vHMML catalog, metadata records, and digitized manuscripts is completely free. Users create a free account at vhmml.org to view digitized folios, with no subscription or institutional affiliation fees required.

What is the difference between an Object, a Part, and Contents in vHMML?

An Object represents the physical volume or codex as a whole, including binding and shelfmark. A Part represents a distinct codicological unit within that volume, characterized by a specific scribal period, material, or origin. Contents represent individual texts, author works, and incipits within that part.

Can I download high-resolution manuscript images from vHMML for publication?

High-resolution images are provided for research within the web viewer. Because physical manuscripts remain the property of custodial partner archives, reproducing images in print or commercial media requires written permission and licensing from HMML and the custodial institution.

How does the HMML Authority File differ from the Library of Congress Name Authority File?

The HMML Authority File specializes in standardizing names, places, and corporate bodies in underrepresented Eastern Christian, Islamic, and African manuscript traditions. HMML contributes vetted records into the Library of Congress NACO program to improve international representation.

What languages and script traditions are represented in HMML collections?

HMML preserves codices in dozens of languages, including Classical Syriac, Arabic, Garshuni, Ge’ez, Amharic, Armenian, Coptic, Church Slavonic, Latin, and Malayalam, alongside extensive archival collections from Malta.

How often is the vHMML Data Portal updated?

Complete database dumps on the vHMML Data Portal (vhmml.org/data) are refreshed on a weekly schedule. Researchers downloading JSON or CSV archives receive updated metadata reflecting recent cataloging progress.

Does vHMML support digital humanities research and computational text analysis?

Yes. The platform provides its complete manuscript metadata under a Creative Commons Attribution 4.0 International license (CC BY 4.0), exposes public REST API endpoints for the HMML Authority File, and implements IIIF image standards.

Sources

  • Hill Museum & Manuscript Library. “About HMML.” Official institutional portal. https://hmml.org/about/ (Accessed 2026-11-14).
  • Virtual Hill Museum & Manuscript Library. “vHMML Reading Room Help & User Documentation.” https://www.vhmml.org/readingRoom/help (Accessed 2026-11-14).
  • Virtual Hill Museum & Manuscript Library. “vHMML Data Portal.” Bulk manuscript metadata downloads and schema documentation. https://www.vhmml.org/data (Accessed 2026-11-14).
  • HMML Authority File. “HAF Database & API Service.” Authority records for persons, places, and repositories. https://haf.vhmml.org/ and https://api.haf.vhmml.org/ (Accessed 2026-11-14).
  • HMML School. “Online Paleography and Codicology Modules.” Latin, Syriac, and Arabic manuscript curricula. https://hmmlschool.org/ (Accessed 2026-11-14).
  • National Endowment for the Humanities. “Father Columba Stewart to Deliver 2019 Jefferson Lecture in the Humanities.” NEH official announcement and grant records. https://www.neh.gov/news/father-columba-stewart-deliver-2019-jefferson-lecture-in-the-humanities (Accessed 2026-11-14).
  • Saint John’s University. “Hill Museum & Manuscript Library at Alcuin Library.” Collegeville, Minnesota. https://www.csbsju.edu/hmml (Accessed 2026-11-14).

Data: Global Manuscript Digitization Platforms: Institutional Scope, Metadata Standards, and Data Access Specifications

Comparative dataset analyzing seven major international manuscript digitization repositories and platforms, detailing geographic traditions, cataloging schema, IIIF compliance, bulk export capabilities, and open access licensing terms compiled from official institutional documentation.

Period covered: 2024/2026. Coverage: Global.

Global Manuscript Digitization Platforms: Institutional Scope, Metadata Standards, and Data Access Specifications
Platform NameHosting InstitutionPrimary Tradition FocusEstimated Manuscript RecordsCatalog Schema ArchitectureIIIF Image ComplianceBulk Metadata Export FormatOpen Data Licensing Model
vHMMLHill Museum & Manuscript LibraryMiddle East, Africa, South Asia, Central Europe486,000Hierarchical Object-Part-Contents schemaYes (IIIF Image & Presentation)Weekly JSON (line-delimited) & CSVCreative Commons Attribution 4.0 (CC BY 4.0)
DigiVatLibVatican Apostolic Library (BAV)Western Christian, Byzantine, Classical, Renaissance80,000TEI-XML & MARC21 bibliographic catalogYes (Mirador IIIF compliant)OAI-PMH & IIIF Manifest endpointsPublic domain & institutional research license
GallicaBibliotheque nationale de France (BnF)French, Western European, Near Eastern illuminated170,000Intermarc & Dublin Core repository schemaYes (IIIF API v2/v3)OAI-PMH, SPARQL linked data, REST APIOpen metadata (Etalab Open License / CC0)
Digital BodleianBodleian Libraries, University of OxfordBritish, European, Hebraica, Orientalia, South Asian40,000TEI P5 manuscript cataloging architectureYes (IIIF compliant)IIIF Manifests & University Data RepositoryCreative Commons Non-Commercial / CC BY-NC
e-codicesUniversity of FribourgMedieval and early modern Swiss collections3,000TEI P5 XML scholarly manuscript descriptionsYes (Mirador & IIIF APIs)TEI-XML files & CSV catalog dumpsCreative Commons Attribution-NonCommercial (CC BY-NC)
Handschriftenportal (HSP)Staatsbibliothek zu Berlin, SBB/BSB consortiumGerman and Central European historical manuscripts120,000TEI-XML national union catalog schemaYes (IIIF compliant)Open REST API & TEI-XML exportsCreative Commons Public Domain Dedication (CC0)
Endangered Archives Programme (EAP)British LibraryEndangered regional and non-state archives worldwide100,000EAD & British Library Archival Resource schemaYes (Universal Viewer & IIIF)OAI-PMH & British Library Data PortalCreative Commons Attribution (CC BY) for metadata

Sources

Compiled by CASRAI from the sources above. Free to reuse under CC BY 4.0 with attribution.

Follow CASRAI

Research-administration guidance, standards updates and independent tool reviews.

Ask CASRAI · free to try

Ask about Hill Museum & Manuscript Library: Guide to vHMML Research Tools

2 free questions a day, no account.

An AI assistant for research: funder rules, compliance, methods and publishing. It links the sources behind its answers and labels answers that come from a web search.

Answers draw on CASRAI's guides and dictionary plus the federal and funder documents we index: Federal Register, Grants.gov, Regulations.gov and UKRI.

Works on this site and inside Claude, Cursor and the AI tools you already use.

Everything CASRAI publishes — this page, the dictionary, the guides and the news — stays open to read, with no account and no card.

Referenced across the research world

University of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logoUniversity of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logo
  • University of Cambridge logo
  • Columbia University logo
  • Crossref logo
  • University of Edinburgh logo
  • Harvard University logo
  • University of Oxford logo
  • Princeton University logo
  • Stanford School of Medicine logo
  • University College London logo
  • ORCID logo

View CASRAI adoption →