No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
README.md
contributing.md

README.md

Awesome ArchivesSpace

ArchivesSpace is an open source, web application for managing archives information. The application is designed to support core functions in archives administration such as accessioning; description and arrangement of processed materials including analog, hybrid, and born-digital content; management of authorities (agents and subjects) and rights; and reference service. The application supports collection management and functions as a metadata authoring tool.

What is this list?

Awesome ArchivesSpace is an awesome list. It points to resources (code, blog posts, anything with a URL, really) regarding ArchivesSpace created by the community that are dispersed around the web. Resources are loosely categorized by broad topic.

The intended audience for the list is those who have decided to adopt or have already implemented ASpace, both ASpace members and non-members, and need some help on where to go next in a specific area.

This list is not intended to be an exhaustive roadmap to ArchivesSpace implementation, but more as a "resource guide". Inclusion on the list is not an endorsement of any kind.

Table of Contents

Contributing to the list

Please help us continue to collect and add relevant sources to Awesome ArchivesSpace. See the Contributing Guidelines for information on how to update this page.

Awesome ArchivesSpace was initially populated with three categories of resources: Migrations, Plug-ins, and Integrations. Through that work, additional categories of interest were identified: Implementation, Scripts, and Trainings and Documentation. We encourage the ArchivesSpace community to add links to these categories as well as welcome new category suggestions.

Not seeing what you need?

Here are some other helpful links:

Ownership and credits

The ArchivesSpace community has ownership over Awesome ArchivesSpace. TAC Vice Chair has responsibility for the ongoing maintenance of the list which includes: responding to all pull requests, monitoring the ASpace user group listserv for new content and adding it to the list, taking care of any administrative issues, and initiating an in-depth review of the list by TAC as needed with a minimum recommendation of every two years. Please reach out to the TAC Vice Chair if you have any further questions or suggestions that cannot be handled via a pull request or issue.

Awesome ArchivesSpace was initially populated by the Awesome ArchivesSpace Ad Hoc Working Group, under the aegis of the Technical Advisory Council, in 2018. The working group was comprised of: Justin Dalton, Christina Luers, Anne Marie Lyons, and Maggie Hughes.

Migrations

The links below relate to ArchivesSpace migration projects. Resources are loosely grouped by the systems or tools organizations were coming from when migrating to ArchiveSpace. Some links may appear in multiple categories.

Any legacy database

Links that can be useful for any legacy database:

Archivists' Toolkit

Archon

Re:Discovery

  • Yale University ArchivesSpace Migration:
  • Migration Scripts (University of Denver): Migration scripts from Re:Discovery to ArchivesSpace.

EAD or Homegrown database

If you are migrating from EAD or a Home Grown database, you may find these links useful:

Plug-ins

The links below relate to ArchivesSpace plug-in projects. Resources are loosely grouped by whether the plug-in involves importing or exporting data, searching, administration, authentication, and additional front-end and back-end functionality. Some links may appear in multiple categories.

Import/Export Data

  • Plugins and Scripts from UNLV (University of Nevada, Las Vegas Libraries): Includes plugins to use custom PDFs for different repositories, customization of the default MARCXML export, spawn a number of accession records at once into resource records, and an overlay function that that allows for more granular record merging.
  • Harvard ASpace Excel Import plugin (Harvard Library): Supports the bulk uploading via Excel Spreadsheet of Archival Objects and (optionally) their associated Creator Agents, Top Containers, Subjects, Digital Objects, etc.
  • Import Agent Records with LCNAF Import Plug-in (ArchivesSpace): Information from the ArchivesSpace membership documentation about creating agent records using the Library of Congress Name Authority File plugin.
  • ArchivesSpace @ NYU: Local Development (New York University): Provides information and access to locally-developed plugins, including an EAD export customization plugin, a plugin for location management (pre-ArchivesSpace v.1.5.0), a MARC record export plugin, and a digitization work order plugin and digital object creation tool.
  • MOMA EAD Importer (Brian Hoffman): Custom ArchivesSpace EAD Importer for MOMA EADs. Theses customizations are specific to version 1.0.9 of ArchivesSpace and may not work with later versions.
  • Yale EAD Exporter Plugin Example (Developer house at code4lib 2015): It shows how to tweak the EAD converter. In this example, Yale wanted to add container barcode_1 to the EAD container @label attribute with the convention of "LABEL BARCOD" (e.g., "text 1234").
  • OCLC Import (Hudson Molonglo): Search OCLC records and choose which ones to import into ArchivesSpace as Accession records.
  • Custom MARC Exporter (Lora Woodford): Sample custom MARC exporter demonstrated at the 2018 Code4Lib pre-conference workshop. Enables customizations to MARC exporter for country codes, descriptive cataloging forms, cataloging sources, dates, and locations.

Search

  • NCSU Search Title Boost (NCSU Libraries): Boosts exact matches on title field - improves precision of search queries from linked record fields (linked agents, subjects, etc.). Note that this functionality can now be implemented by customizing the Solr parameters via the ArchivesSpace config file.
  • Search Identifier plugins:
    • Search Identifier (Duke University Libraries): Adds the identifier column to search and advanced search results pages for a number of different records.
    • Search Identifier (LYRASIS): Adds an identifier column to search and advanced search results pages in the staff interface.
    • ArchivesSpace Advanced Search Extension (Hudson Molonglo): This is an ArchivesSpace plugin to extend the advanced search to index and allow searching on a series of record fields as specified by Yale University.

Administration

Authentication

Additional Back-end Functionality

  • NCSU Delete Button Context Plugin (NCSU Libraries): Changes the label on the 'Delete' button in the record toolbar to indicate the type of record being deleted.
  • Payments Module (Hudson Molonglo): Payments subrecord for accession records.
  • Alma/ArchivesSpace Integrations Plugin (University of Denver): Built on the Top Container functionality...based on the resource record provided by the user, the integrations will perform the following API calls: Check for a BIB with the Resource's MMS ID; check for holdings associated with the BIB identified by that MMS ID; add new holdings; create a new BIB record if no MMS ID is present.
  • Generating Accession identifiers:
    • Custom Accession Identifiers (Brian Hoffman): Creating custom accession identifiers. Users with "Manage Repository" permissions will see a new menu item in the Repository settings menu (click the gear icon to the right of the selected repository). Use the "Department Codes" setting to add and remove codes for your Repository. Department codes will appear in a dropdown for the second part of the Accession identifier. The first and third sections of the identifier will be system-generated upon saving the record. The fourth section will be removed.
    • Custom Accession Identifiers (University of Virginia, forked from Yale/Hudson Molonglo plugin): This is a modification of the original generate-accession-identifiers plugin with two significant differences.
    • Next Resource Identifier plugin (University of Denver Libraries): ArchivesSpace plugin to determine the next collection number in a sequence.
  • University of Denver's local ArchivesSpace plugins (University of Denver Libraries): Includes branding; extending the resource_tree content model to display the component IDs in the third column, for easier tree navigation for our archivists; extending the public search result summary to provide additional metadata about Resources, Archival Objects, and Digital Objects; adding rows to the component toolbar for Archival Objects to allow for MODS export and linking to digital objects.
  • Timewalk plug-in (Alex Duryee): An automated date parser plugin for ArchivesSpace.
  • Information about Plugins (ArchivesSpace): ReadMe file from ArchivesSpace plugins page on Github.
  • Writing an ArchivesSpace plugin (Mark Triggs, Teaspoon Consulting): "ArchivesSpace allows you to write custom code to add new features, or change the behaviour of existing features. This code takes the form of a plugin: you structure your code according to certain conventions and it is automatically loaded when the ArchivesSpace system starts up. This article looks at the source code behind a plugin for generating accession identifiers."
  • css stylesheet (Yale University): for the staff interface.
  • ArchivesSpace Assets Reroute Plugin (Mark Triggs, Hudson Molonglo): This is a plugin to reroute the Rails asset pipeline in the ASpace frontend and public UI to use plugin assets. It's specifically designed to allow plugin assets to be served by Tomcat7.
  • Container Management (Hudson Molonglo): ArchivesSpace plugin to add a new container type to ArchivesSpace. This plugin is compatible with ArchivesSpace v1.1.x.
  • Yale ArchivesSpace ILS Integration (Hudson Molonglo): ArchivesSpace plugin to add support for integrating Yale's ILS.
  • Yale Accessions plugin (Brian Hoffman): Creates custom accession identifiers for Yale.
  • Yale MARC XML (Hudson Molonglo): Additional MARC XML for accession mappings for Yale.
  • Default text for notes (Hudson Molonglo): ArchivesSpace plugin to specify default text for selected fields. This plugin was developed for the National Library of Australia.
  • Yale Materials Types (Hudson Molonglo): When this plugin is installed, you will see a new Material Types subrecord form in the Accessions form. After adding a Material Types subrecord to an Accession, you can check the material types that apply to the Accession. You can set default Material Types by clicking 'My Repository Preferences'; in the user dropdown menu. Checked Material Type preferences will be checked by default when a new Material Types record is created.
  • ASpace Yale Container Operations (Hudson Molonglo): Plugin for bulk container operations.
  • Item linker (Denver University Libraries): This ArchivesSpace plugin allows a user to create a Digital Object record directly from an Archival Object (i.e. for digital surrogates of a physical object), and automatically link that Digital Object to the item upon its creation. If a Digital Object is already linked to the item record, the user can push updates from the item to its Digital Object.
  • Archival Object_MODS (Denver University Libraries): This plugin allows users to download MODS representations of Archival Objects in ArchivesSpace. On the backend, there is an API call allowing the direct download of a MODS representation of any Archival Object as well as the metadata for that MODS representation, similar to the MODS export for Digital Object records.
  • Autogenerate DOIDs (Lora Woodford): This plugin auto-generates an identifier for Digital Objects created in staff mode (frontend).
  • Manager User Defined Fields (Ohio State University): This ArchivesSpace plugin hides any user defined fields that are default or not used for the specific type of item being created/edited.

Additional Front-end Functionality

  • Implementing the ArchivesSpace PUI: A Before Action Review (Yale University): Blog post that explains the purposes of this Before Action Review (BAR): identify what would be accomplished, what would change, and what would indicate success by moving to the ArchivesSpace public user interface.
  • Donor Details Plugin (Bentley Historical Library): Blog post that discusses the Bentley's Donor Details plugin. Includes links to the plugin code.
  • ArchivesSpace Developer Screencasts: 20. Writing an importer plugin (Mark Triggs, Hudson Molonglo): Youtube video that demonstrates how to write a plugin that adds an importer to ArchivesSpace.
  • Turning an ArchivesSpace Plugin into Core Code (Christine Kim, ArchivesSpace): One of the simplest and quickest ways to begin writing for the ArchivesSpace core code is to take an existing plugin and convert it into a pull request to the master branch of ArchivesSpace.
  • Fix <title render="..." ...> bug in ArchivesSpace v1.5.4 (Tim DiLauro/Johns Hopkins University): This plugin remedies the worst of the ArchivesSpace v1.5.4 Public User Interface (PUI) <title> tag rendering bugs, which resulted in missing title text in fields and component tree, partially rendered pages, and bracketed in browser tabs/window headings. It currently does not address similar issues in staff mode (frontend) and is not applicable to the 2.x versions of ArchivesSpace.

Integrations

The links below relate to ArchivesSpace integrations projects. Resources are loosely grouped by the type of system being integrated with ArchivesSpace such as digital preservation systems, content publication systems, import/export integrations, etc. Some links may appear in multiple categories.

Digital Preservation Systems

Import/Export

  • EADChecker (Harvard Library): Import/export integration for checking EADs against local standards via schematron. This is a small website intended to allow Harvard Archivists to check their EAD files prior to ingest by ArchivesSpace.
  • ArchivesSpace Preprocessor (Harvard Library): The ArchivesSpace Preprocessing system processes EAD files and applies changes (fixes) to them to allow for successful ingest into ArchivesSpace.
  • Link (Archive-It) Seeds to related ArchivesSpace collections (Mary Haberle, Archive-It): The "Related Archival Materials" metadata field makes it possible for partners using ArchivesSpace to integrate non-web collections in their holdings into seed-level Archives-It records.
  • Repurposing ArchivesSpace Metadata for Original MARC Cataloging (Carol Ou, Katherine L. Rankin, Cyndi Shein): "UNLV...completed a pilot project exploring the repurposing of descriptive metadata for archival collections stored in ArchivesSpace for the creation of original MAchine-Readable Cataloging (MARC) records contributed to OCLC WorldCat."
  • Circa (NCSU Libraries): Request and workflow management for archives and special collections. A web-based system for managing requests for special collections materials. The application includes a JSON API, built in Ruby on Rails, and a default front end written in Angular.js (v. 1.6.x). Circa provides close integration with ArchivesSpace, upon which the application depends for managing containers associated with specific collection components, as well as the location of those containers. It can also support requests for materials described in an ILS.
  • Atlas Systems: Aeon/ArchivesSpace Plugins
    • ArchivesSpace-Aeon Fulfillment Plugin: Allows patrons to submit requests from ArchivesSpace PUI to Aeon.
    • Aeon ArchivesSpace Client Addon: This addon is used to integrate the ArchivesSpace staff interface into the Aeon Client request form so that staff can search the records of their ArchivesSpace instance and import details into Aeon requests.

Content Publication

  • staticAid (Hillel Arnold): A Jekyll static site generator for archival description serialized in JSON, generated via the ArchivesSpace REST API, or by other modular backends which can be added to the system.
  • AS2D8: ArchivesSpace-to-Drupal 8 integration (Jason Loeffler): AS2D8 is a series of Drupal modules for harvesting data from ArchviesSpace. AS2D8 extends the Drupal core Migrate API with plugins, provides sensible defaults for displaying ArchivesSpace resources in Drupal and all of the usual Drupal content and website management tools.

Case Studies

  • Open-Source Opens Doors: A Case Study on Extending ArchivesSpace Code at UNLV Libraries (Cyndi Shein, Carol Ou, Karla Irwin, Carlos Lemus): "UNLV is in its third year of implementing...ArchivesSpace, and is sharing UNLV-developed code that extends ArchivesSpace's built-in function. The case study demonstrates how adopting and building upon community-created code and developing original local code is improving critical workflows that support creating collection descriptions, cleaning up metadata, and disseminating finding aids that are easier for researchers to comprehend."

Trainings and Documentation

The links below relate to ArchivesSpace training resources and/or documentation.

Implementation

The links below relate to ArchivesSpace implementation projects.

  • Implementing ArchivesSpace at Arizona State University (Elizabeth Dunham): Arizona State University Libraries became charter members of ArchivesSpace, an "open source archives information management application for managing and providing web access to archives, manuscripts and digital objects", in early 2013. This case study discusses the Libraries' migration of its Archives and Special Collections (ASC) from Microsoft Access, Archivists' Toolkit and FileMaker Pro to ArchivesSpace.
  • Implementing ArchivesSpace at NYPL: Part 1 (New York Public LIbrary): "In 2014, the Archives Unit at The New York Public Library began its evaluation of ArchivesSpace. Following a rigorous review of the application, we began implementation in earnest in 2016, and started using it in production earlier this year. Historically, Special Collections developed its own systems for collection/data management, which could be developed and tailored to suit our needs. As such, moving from a homegrown data management system/model to a community-designed one represented a major shift in how the Library evaluates and implements systems. Instead of being able to build to our wants/needs from the ground up, ArchivesSpace required us to meet the application halfway in its assumptions and practices."

APIs and Scripts

The links below relate to ArchivesSpace scripts and APIs.