Hypothesify — Jan Odstrcilik

🧐 What is Hypothesify?
Hypothesify is a small Firefox extension for the annotation tool Hypothes.is that allows private and public annotation of any website or PDF.

Currently (26th April 2020), there is no Firefox extension for this great tool. So I decided to make one as part of my learning process of JavaScript. This explains why the code is not really nice and there will be definitely some 🐛. Sorry for the inconvenience.

🗃 Functions of Hypothesify
Hypothesify has the following functions:

• It can show a number of public annotations for a selected website before you open it in Hypothes.is. ⚠ Please, note that if you choose this option, every URL goes through the servers of Hypothes.is.
• It can open and close a selected webpage or a PDF document in Hypothes.is.
• It generates a code that you can send to your friends, include in your Note app or integrate into your webpage. To copy the code, click on the generated code panel and press CTRL+C (Windows and Linux) or CMD+C (MacOS).

⚗ Generated code

• a simple link 🔗
• "a" HTML element with @href attribute
  Markdown code in the format []()
• "iframe" HTML element (for inclusion of the whole webpage as iframe)
• hiccup iframe code for inclusion of the webpage into Roam 🧠

⚙ How does Hypothesify work?
Hypothesify uses two key services of Hypothes.is:

1. Its public API for obtaining the number of public annotations for any selected webpage.
2. Its via proxy that opens any webpage or PDF document in Hypothes.is.

🔎 Privacy
The extension itself does not collect or store any private information. However, if you wish to "Check for available public annotations" in the popup menu, every URL will be sent to the Hypothes.is server. While the request to the server contains only the URL, I assume that the server gets also the IP address of the machine making the request. Note that sometimes the URL address may also contain sensitive information.

🎁 Support for Hypothesify
If you wish to support this extension, you can make a PayPal donation. 🤸‍♂️

💾 Versions

• v.1.0, 26th April 2020 - first version

📜 Licence of Hypothesify
GNU GPLv3 (code will be available on GitHub).

🐱‍💻 Comments and feedback
Welcomed :).