Skip to content

A chrome extension to integrate the malleus project with various resources (e.g. notion website, emedici)

License

Notifications You must be signed in to change notification settings

Sabicool/Malleus-Extension

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Readme

This is an extension made for chromium based browsers for the Malleus Clinical Medicine Project. Please read more about the project here.

Showcase

Easily search the Malleus Clinical Medicine deck for flashcards related to the currently open webpage. For example easily find questions related to a eMedici question.

./resources/showcase.gif

Features

You can now use this together with the following sites:

Usage

  1. Make sure you have Anki running and have installed the anki-connect extension
  2. On any webpage1 you find simply click the malleus extension button in your toolbar or right click the page and click “Search Malleus Deck”.

You can also search the Malleus deck with any highlighted text

  1. Select any text on a webpage and right-click the selected text
  2. Choose “Search Malleus with Selected Text” from the context menu
  3. The extension will clean up the selected text by removing comon separators and extra whitespace and search the Malleus deck for any cards related to it

Example Use Cases

On the Malleus website search for any disease you may want to find cards on using the search icon at the top right of the website (e.g. atrial fibrillation). Open the page and then click the Malleus extension button from your toolbar. A anki browser window should appear with all the relevant cards. Currently only supports pages from the subject tags database (i.e. diseases) and pharmacology database.

Review questions as you would in eMedici and simply click the Malleus extension button in your toolbar to bring up a anki browser window with all the relevant cards

Open any page on eTG and the relevant cards and click the Malleus extension button in your toolbar to bring up the relevant anki cards in an anki browser window.

Note that you can also use the right click context menu if you prefer. Please note that extensions which edit the html or look of the page (e.g. the Amboss extension) may interferer with the use of this extension.

Installation

The extension is now on the chrome web store. Please download the extention and then also download the anki-connect extension.

Manual Installation

To download the latest release of the extension please follow the following steps

  1. Download the latest release here or go to the releases page and download the latest release file (should be the file named “malleus-extension.zip”)
  2. Go to chrome://extensions/
  3. Turn on developer mode at the top right
  4. Drag and drop the malleus-extension.zip file onto the chrome window (should say “drop to install”)
  5. Pin the extension to your toolbar

You will also need the ankiconnect extension.

Directions for the future

Sharing and publishing

  • [X] Make releases workflow
  • [X] Publish on chrome web store

Quality of life improvements

  • [X] Extension checks if the Anki server is running; if not suggest to the user to download anki-connect or start anki
  • [X] Improve eTG integration using tags instead of source searching; can use source searching to fall back onto
  • [X] Add right click context menu
  • [X] Switch over to using notion api
  • [X] Search through tag fields instead of title for eTG pages
  • [-] Improve notion website integration for other databases

Other integrations

  • [X] Notion website
  • [X] eTG
  • [X] AMH
  • [-] RCH
  • [ ] ACI
  • [-] Other sites; just search the source field with the URL or query title against notion database

I want to enable further integration with emedici:

Add support for other qbanks

  • [ ] Passmedicine
  • [ ] Elsevier
  • [ ] Amboss
  • [ ] AMSA Med Ed

Troubleshooting

Some versions may be imcompatible with prior versions. Please remove and reinstall the addon if this happens

On some pages (e.g. eTG) using extensions such as the Amboss extension may interfere with it. Please disable other extensions if you see issues

Does not work for PDFs

Licence

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This license grants you the freedom to use, modify, and distribute this software, provided that any derivative work or distribution is also licensed under the AGPL-3.0. Additionally, if you deploy this software on a network, users interacting with it over that network must also be granted access to the source code.

For more details, please refer to the full license text in the LICENSE file or visit GNU AGPL-3.0 License.

Footnotes

1 Generally works for most pages. The document.title, just needs to start with the disease and drug. Otherwise you can just highlight the text of the screen and search the Malleus Deck. If there are instances where it doesn’t work regularly please create a new issue.

About

A chrome extension to integrate the malleus project with various resources (e.g. notion website, emedici)

Topics

Resources

License

Stars

Watchers

Forks