Tools, Plug-ins and Integrations

Tools, Plug-ins and Integrations 2017-05-30T11:30:31+00:00

These tools are created and maintained by the Hypothesis community. Some are code experiments, some are full implementations being adopted by users every day.  If you have a project or know of one that should be listed here, please let us know!


CMS and LMS plug-ins


WordPress – Hypothesis Labs


Screencast: (illustrates PDF activation)

Description: Built by Jake Hartnell and Benjamin Young. Adds the Hypothesis sidebar to your wordpress website. Converts links to PDFs in the Media folder to links.


WordPress Hypothesis aggregator – Kris Shaffer


Description: A WordPress plugin that allows you to aggregate Hypothesis annotations on a single page or post on your WordPress blog.


Canvas – Hypothesis Labs

Links: Installing the App, Using the App (for teachers), Using the App (for students)

Description:  This prototype enables teachers to create annotatable documents as “Assignments” within the LMS platform. More information here.


OJS Hypothesis Plugin –  Alec Smecher


Description: adds Hypothesis integration to the public article view of Open Journal Systems, permitting annotation and commenting.


Omeka Annotator –  Erin Bell


Description: A Hypothesis text annotation plugin for Omeka. –  Hypothesis Labs


Description: A place to upload PDFs and other documents for annotation using Hypothesis, as well as a Google Drive plugin for PDFs.


Drupal – Little Blue Labs


Description: This simple module embeds Hypothesis into your Drupal site.


Archiving and downloading annotations


Annotation viewing and export –  Hypothesis Labs



Description:  View annotations by user, group, URL, or tag. Export results to HTML, CSV, text, or Markdown. More info here.


Hypothesis collector – John Stewart


Description:  Creates google sheets with annotations based on search queries.


Save and analyze H annotations –  Roderic Page


Description: Places annotations on a Cloudant database for analysis.


Added functionality


Slack notifications – Hypothesis Labs


Description: Receive Slack notifications  made by specific users, or groups, or on specific urls or tags.


Hypothesis epub reader – Jake Hartnell


Description: A mashup of the open source Hypothesis and Epub.js projects.


Annotran: Annotate to translate – Martin Eve


Description: Annotran is an extension to the hypothesis annotation framework that allows users to translate web pages themselves and to view other users’ translations. Read about it here and here.


Programming tools


Hypothesis Ruby Gem – Javier Arce


Description: Unofficial ruby gem for the Hypothesis API.


Pypothesis – Kris Shaffer


Description:  Python scripts for interacting with the Hypothesis API.


Hypothesisr – Matthew Lincoln


Description: An R package that allows users to add, search for, and retrieve annotation data.


HypothesisPHP – Alec Smecher

Description: A simple PHP wrapper for the Hypothesis API.


Hypush – Tom Gillespie

Monitor the Hypothesis websocket in order to push realtime notifications to other channels.






Description: This tool finds RRIDs in articles, looks them up in the SciCrunch resolver and creates Hypothesis annotations that anchor to the RRIDs and display lookup results. More info here.




Description: The American Association for the Advancement of Science (AAAS) uses Hypothesis for graduate students to annotate articles using specific highlight colors and categories. More info here.


Extracting structured findings from scientific papers


Description: David Kennedy reviews the literature in his field and extracts findings, which are structured interpretations of statements in scientific papers. He’s using Hypothesis to create reports based on structured annotation. More here.


Hypothesis / Europe PubMed Central


Description: Bring annotations from two systems together in the context of a document.


Infinite Ulysses


Description: created by Amanda Visconti, Infinite Ulysses lets readers of James Joyce’s challenging novel Ulysses while annotating it with their questions and interpretations and perusing annotations from fellow readers.


Other ideas to try


Screen-reader-accessible annotation – Hypothesis Labs



Description: Use a hotkey to select an element, hear it spoken, and open the annotation editor. More info:


Copy annotation to clipboard – Hypothesis Labs


Description: Copy the text of the annotation to the clipboard by clicking an icon. More info:


Highlight groups with annotations – Hypothesis Labs


Description: Highlights the group name with a different color on the dropdown menu, when there are annotations on the group. More info:


Group admin –  Hypothesis Labs


Description: Enables a group of users who have given their H API keys to be subject to admin by an “admin user” who is the H user running the prototype extension. The admin user running can edit or delete annotations by subject users. More info:


Controlled tagging – Hypothesis Labs

Description: Restrict tags to a controlled list.

Screencast: (manage the list in a Google doc, activate it on a per-Hypothesis-group basis)

Screencast: (source the list from an external ontology service)

Screencast: (embed a single-page app in the annotation body to enable full control of tag interaction and context)

More info:


Search / faceted navigation – Hypothesis Labs

Description: An early prototype of faceted navigation


Community, Privacy and Accessibility at Hypothesis