Tools, Plug-ins and Integrations

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!

Learning Management Systems (LMS)

LMS App

Link: https://web.hypothes.is/education/lms/

Description: An official Hypothesis application that enables integration with any LMS supporting IMS Learning Tools Interoperability (LTI), such as Blackboard Learn, Desire2Learn Brightspace, Instructure Canvas, Moodle, Sakai, and Schoology, to provide capabilities including single sign-on and automatic private group provisioning for each class.

Content Management Systems (CMS)

WordPress

Link: https://wordpress.org/plugins/hypothesis/

Screencast: http://jonudell.net/h/wordpress-via-pdf.mp4 (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 via.hypothes.is links.

WordPress Hypothesis aggregator

Link: https://github.com/kshaffer/hypothesis_aggregator

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

OJS Hypothesis Plugin

Link: https://github.com/asmecher/hypothesis

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

Omeka Annotator

Link: https://github.com/ebellempire/Annotator

Description: A Hypothesis text annotation plugin for Omeka.

DocDrop.org

Link: http://docdrop.org/

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

Drupal, from Little Blue Labs

Link: https://www.drupal.org/project/hypothesis

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

Archiving and downloading annotations

Use any of the following community-provided tools to export (download) your annotations.

For note-taking apps

Send Hypothesis annotations directly into your notes.

Roam: (via RoamJS) Hypothesis Extension

Import your Hypothesis notes and highlights into Roam.

Readwise

Readwise has a built-in integration with Hypothesis. Visit your syncs to set it up.

Obsidian: Obsidian Hypothesis Plugin

Obsidian Hypothesis (Community Plugin) is an unofficial plugin to synchronize Hypothesis web article highlights/annotations into your Obsidian Vault.

Alternatives for technical users
  • Gooseberry: A command line utility to generate a knowledge base from Hypothesis annotations
  • Annotation tools: python tools to link Hypothesis and Pinboard annotations to Obsidian
  • Chris Aldrich’s gist: retrieve your annotations into Obsidian (for templater plugin)

LogSeq: Logseq Hypothesis Plugin

Retrieve your online web annotations and insert them directly into Logseq. All you need to do is enter your API key, and then you can add all your annotations to your Logseq.

Org Mode: hypothesis.el

Import data from hypothes.is into Emac.

Online tools from the community

Standalone tools found on the web.

Facet

View annotations by user, group, URL, or tag. Export results to HTML, CSV, text, or Markdown. Screencast: https://jonudell.net/h/facet.mp4

Hypothesis collector

Create google sheets with annotations based on search queries.

Chrome extensions

Grab Hypothesis annotations directly from your browser.

Hypothesis to Markdown bullet points

Browser extension for fetching and formatting Hypothes.is annotations into markdown bullet points, ready for copying into Roam, Notion or similar apps.

For technical users

If you have some skills at the command line or in a text editor, these ones are for you!

Gooseberry CLI tool

A command line utility to generate a knowledge base from Hypothesis annotations. (Very slick, with Obsidian compatibility, too)

Hypotheiss + Steampipe

Steampipe is an open source CLI to instantly query cloud APIs using SQL. List annotations from Hypothesis.

hypothesis-to-bullet

Script to fetch Hypothes.is annotations or Twitter threads and output Markdown that is suitable for Roam for macOS computers.

recon16-annotations

Place annotations on a Cloudant database for analysis.

Added functionality

Slack notifications

Link: https://github.com/judell/h_notify

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

Hypothesis EPUB reader

Link: https://github.com/JakeHartnell/HypothesisReader

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

Annotran: Annotate to translate

Link: https://github.com/birkbeckOLH/annotran

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.

Annotation Powered Survey

Link: https://github.com/judell/AnnotationPoweredSurvey

Description: A toolkit for building online surveys that ask questions to which answers are annotations.

ClinGen Workflow

Link: https://github.com/judell/ClinGen

Description: An approach to annotation-powered biocuration.

CopyAnnotations

Link: https://github.com/judell/CopyAnnotations

Description: Copy top-level annotations from one URL (and/or group) to another.

TagRename

Link: https://github.com/judell/TagRename

Description: Rename Hypothesis tags.

Programming tools

Hypothesis Ruby Gem

Link: https://github.com/javierarce/hypothesis

Description: Unofficial ruby gem for the Hypothesis API.

Hypothepy

Link: https://github.com/embo-press/hypothepy/tree/master/hypothepy

Description: A lightweight Python API for Hypothes.is

Pypothesis

Link: https://github.com/kshaffer/pypothesis

Description:  Python scripts for interacting with the Hypothesis API.

Hypothesis

Link: https://github.com/judell/Hypothesis

Description: Yet another Python wrapper for the Hypothesis API.

Hypothesisr

Link: https://github.com/mdlincoln/hypothesisr

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

HypothesisPHP

https://github.com/asmecher/HypothesisPHP

Description: A simple PHP wrapper for the Hypothesis API.

Hypush

https://github.com/tgbugs/hypush

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

Integrations

SciBot

Link: https://github.com/SciCrunch/scibot

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.

AAAS/Discover

Link: https://github.com/judell/StandaloneAnchoring

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

Link: https://gist.github.com/judell/ca913dd64a29f852afd3

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

Screencast: http://jonudell.net/h/scibot-epmc-v1.mp4

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

Infinite Ulysses

Link: https://github.com/amandavisconti/infinite-ulysses-public

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

Screencast: http://jonudell.net/h/accessible_annotation_02.mp4

Link: https://blog.jonudell.net/2016/09/28/towards-accessible-annotation-a-prototype-and-some-questions/

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

Copy annotation to clipboard

Screencast: http://jonudell.net/h/copy_paste_annotation_v1.mp4

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

Highlight groups with annotations

Screencast: http://jonudell.net/h/highlight-groups-with-annotations-v1.mp4

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

Group admin

Screencast: http://jonudell.net/h/group-admin-v1.mp4

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.

Controlled tagging

Description: Restrict tags to a controlled list.

Screencast:  http://jonudell.net/h/controlled_tagging_v1.mp4 (manage the list in a Google doc, activate it on a per-Hypothesis-group basis)

Screencast: http://jonudell.net/h/controlled-tagging-with-scigraph-ontology.mp4 (source the list from an external ontology service)

Screencast: http://jonudell.net/h/annotation-applet_03.mp4 (embed a single-page app in the annotation body to enable full control of tag interaction and context)

Search/faceted navigation

Description: An early prototype of faceted navigation

Screencast: http://jonudell.net/h/activity_pages_early_prototype.mp4