Skip to main content

Review: Readux

A review of Readux, an open source software platform for digitized texts, directed by Rebecca Sutton Koeser

Published onApr 12, 2021
Review: Readux


Project Director
Rebecca Sutton Koeser

Project URL

Project Reviewer
James Lacitignola, University of Texas at Austin

Project Overview

Rebecca Sutton Koeser, Jesse Karlsberg, and Sara Palmer

Readux is an open source software platform developed at Emory University to offer a web interface for browsing, searching, and taking notes on collections of digitized print materials. The software also provides a user-friendly way to publish annotated critical editions of works as standalone websites. 

Readux was originally developed from 2014 to 2016 with two major goals. First, Readux improves access to locally digitized print materials, which were previously only available in PDF form through the library catalog. Second, Readux enables the creation of richly annotated scholarly editions of multimodal printed works like the songbooks in the Sounding Spirit series. To compellingly present highly visual works that include music notation or illustrations alongside textual content, Readux starts with digitized page images rather than encoded text or music, retaining the bibliographic form and design of the original. 

Readux is built in Python/Django and based on the Fedora Commons 3 repository. Annotation functionality was implemented with annotator.js and required writing custom plugins to support rich text formatting, displaying annotations in the margin, and selecting and annotating portions of images. For volumes with page-level access, positional OCR text is converted into TEI facsimile, which is used to transparently overlay text on page images for selection and annotation. All the software developed for Readux is tested, documented, open source, and available on GitHub. What’s more, the innovative software development for Readux eventually resulted in two spinoffs from the main codebase: piffle, a python library for working with International Image Interoperability Framework (IIIF) images, and django-annotator-store, a generalized annotator.js backend. A full list of the software developed is available on the site. 

Scholarly edition export functionality was implemented with Jekyll, creating a static site which can be hosted on GitHub Pages for a simple and cheap publication solution. This approach was based on the conviction that scholars should not have their work locked into a proprietary system but should be able to take their editions with them and manage their own content. 

Readux was built as a collaboration between the Library Software Engineering Team (LSET), the Emory Center for Digital Scholarship (ECDS), the Robert W. Woodruff Library, and the Pitts Theology Library. At times, the large number of contributors led to conflicts over ownership, investment, and vision for the project. LSET developed and managed the codebase—Rebecca Koeser served as technical lead and led primary development, Kevin Glover developed site design and annotation functionality, and Yang Li contributed to export functionality. ECDS staff crafted user stories, conducted product testing, and consulted at all levels of development—Alice Hickcox and Sara Palmer served as product managers and Jesse P. Karlsberg consulted on annotation and critical edition functionality. 

Readux was funded in part by a grant from the Andrew W. Mellon Foundation. It attracted a collaborator at Wayne State University Libraries— Graham Hukill contributed code and set up a Readux instance to support work with their materials. Project contributors have presented on Readux at numerous digital humanities, library, and open repository conferences. A full list of project collaborators, citations, and presentations is available on the site credits page. The success of Readux inspired the ongoing development of a new version of the platform based on IIIF APIs instead of Fedora in order to support the display of interinstitutional thematic collections.

Project Review

James Lacitignola

Readux offers a web-based environment to read, analyze, annotate, and publish digital editions based on digital collections held by Emory University (Readux 1.8) and partner collections including the Sounding Spirit Project at UNC Press and the Folger Shakespeare folios project at Wayne State University (Readux 2.0). Currently, the Readux 1.8 corpus includes nineteen different collections, including 19th century Black literature and travel guides, Atlanta city guides, emblem books from Northern Europe, 19th century British popular novels known as “yellowbacks,” and documents from the State of Georgia. The combination of creating annotations and publishing those annotated documents allows users to do close readings of archival materials. So often in the humanities we only see polished published works, and never the research process. By publishing their annotations, Readux users are able to document their analysis of individual documents that led them to make certain arguments. This makes more of the research process available for commentary from outside scholars, expanding collaborative research opportunities.

The process of using Readux is straight-forward with both video and written instructions available to new users. Users log into Readux using a Google, Emory, or social media account, then choose a document to view online, highlight the area they want to annotate, and type a note. Once the annotations have been made, Readux also allows users to export those documents and annotations, and publish them as a website on GitHub. The interface gives users incredible freedom to add their annotations over specific text or over entire sections of the page. This allows users the ability to comment on any aspects of a digitized document regardless of the type of object being annotated.

Readux is a clear example of how digital tools can streamline the sometimes-cumbersome process of conducting research in the humanities. Digital humanities scholars might find the ability to fork the Django-based software that is available on GitHub particularly useful. Deploying Readux to demonstrate how students can use annotations in research processes would also extend its utility outside of Emory’s holdings. 

John Smith:

Assignment Guru helps students get high marks in their exams by providing top-quality assignments writing service. We cover various subjects, including law, math, and nursing. Our expert writers create clear and well-structured assignments. If you need help with your coursework, Assignment Guru is here to support you.

class doerr:

Paying someone to take your online classes is becoming more popular as people look for ways to save time and reduce stress. These services allow students to pay for help completing their online classes. These services can be especially helpful for students who have difficulty with the material or need extra help.

latin cary:

Is your schoolwork making you feel stressed? Get the help you need right now to succeed with your online assignments! With our team of skilled writers and editors, you can get assistance with essays, research papers, topic studies, Nursing Assignment Help and presentations.

layton say:

Considering high-quality work at a coffee price with dedicated support is difficult for students with a limited budget. Take advantage of the "Assignment Help Tutor". expertise. In addition to our tutoring service, we offer homework facilitation at affordable rates. For students, we provide affordable homework facilitation services.

Ilsay ston:

A properly cited paper is your key to success. however,  There are different formats and different needs. The expert can do everything mechanically and give you the best online homework helper. You don’t have to be compelled to pay hours examining every comma and bracket. simply enter the required information into the fields below and acquire the reference you would like. Before you begin select one in every one of the formats and also the sort of supply you would like to cite. Do my online class can provide you with the fields that are necessary to fill in. When you offer the knowledge on the supply, you'll be able to preview the citation to ascertain it for mistakes and orthography before you click done. Then the citation is going to be superimposed on the list and you'll be able to proceed to successive one. after you end operating with the tool you may have the list of citations formatted per the educational standards.