Based on 91 ratings:
Sign in to rate
< Back

Image Occlusion 2.0

7.27MB. Updated 2015-04-01.


NEW: Version 2.8 (1 Apr 2015); Fixed bug in color of the masks. This addon adds Image Occlusion capabilities to Anki. After installing the addon, please read the online documentation which you can access through the help menu in the main Anki window. To access the documentation from Anki go to Help > Image Occlusion 2.0 (help). Feature requests and questions should be emailed to the author or posted in the Anki forums. The code is on Bitbucket and on GitHub Author contact:


As add-ons are programs downloaded from the internet, they are potentially malicious. You should only download add-ons you trust.

To download this add-on, please copy and paste the following code into the desktop program:

If you were linked to this page from the internet, please go to the Tools menu and then Add-ons>Browse & Install to paste in the code.

Ask a Question

Write a Review

Front card template code problem and feature suggestions
Posted on 2015-08-23

The front template has the footer in it twice, but this is easily fixed by removing one line.


<span style="display:none">{{SVG}}</span>
{{/Original Image}}


<span style="display:none">{{SVG}}</span>
{{/Original Image}}

Feature suggestions:
1. Allow the user to add more note fields. I like to add the date and source of the information to my notes.
2. Create the cards from 1 note so they be easily selected in the browser by searching for the note ID. This would be similar in function to the default cloze note type. The disadvantage of the default cloze note type is that you can't add individual comments to the cards to explain the specific cloze. Perhaps having a toggle to create multiple notes vs 1 note would be best.

SVG-Edit issue:
The zoom seems to be bugged for me. The image disappears when I select zoom (Z), so I can't edit anything until I restart Anki.

simply the best
Posted on 2015-08-07

Great piece of software. I can't imagine going back to before I knew about this addon. :)

There's a big bug though. At first I thought it was my fault but it has happened a few times already:

I have several decks, and sometimes when I add new cards with this addon, they end up in the wrong deck. It makes a really big mess.

It happened 4 or 5 times already.

Apart from that, I use it all the time and it really helps me a lot.

Holy mother of god
Posted on 2015-08-02

Is this the real life? Is this just fantasy?

- med student

holy fuck
Posted on 2015-07-03

i make love to this addon everyday

-medical student

So good
Posted on 2015-06-09

I'm a visual learner and a die-hard Anki fan so this add-in is great. I also sometimes run into the problem of it not adding cards every once in a while, but it seems like the problem only occurs if I study a deck then try to make cards. I just prophylactically restart Anki before I start making cards after my morning review and rarely have a problem.

Posted on 2015-05-23

It's been helping with my Biology It makes me life MUCHHH EASIER!
Thank you so much:)!

extra note created
Posted on 2015-05-19

when i draw occupying rectangles, clicking on either of create note buttons creates an extra note(i.e. 2 rectangles results in 4 notes, 1 rectangle= 2 otes)
i'm using win 8.1and last version of anki and addon

[SOLVED] Problems in Windows 7
Posted on 2015-05-05

Very nice add-on! Good work!
Now is working but I had a problem with the encoding set on line 163 of
I changed this line from
d[unicode(bname, "UTF-8")] =, "UTF-8"))
d[unicode(bname, "1252")] =, "1252"))
and it works fine.

"UnicodeDecodeError: 'utf8' codec can't decode byte" error
Posted on 2015-02-05

Unfortunately, I cannot get what appears to be a wonderful plugin to work. The very first time I submitted an image occlusion, I received a UTF8 codec error.
EDIT: I figured it out. The name of the image file imported into the addon was causing it to break because it had a non-ASCII character (studying a language).

Addon works great!

Great Add on!
Posted on 2015-01-23

Thank you for fixing image occlusion. It is really an amazing add on.

A great tool, timesaver and otherwise awesome
Posted on 2015-01-21

You'd be amazed how much this helps :)

The image resizing option doesn't seem to be working though. Rather than resizing the image, it crops it (useless).

Plain Perferct
Posted on 2015-01-10

This plugin is exactly what I was looking for. And in addition to that, it works just very smoothly, looks good, feels good and translates to ankidroid with no problems!
Thanks a lot, sir!

Now working properly on Mavericks OSX
Posted on 2015-01-05

Works Again properly on Mavericks

Stopped working on Windows 7 w/ new Anki release
Posted on 2014-11-11

The most recent Anki release caused this plugin to stop functioning on Windows 7. I could make the occlusions in the SVG viewer but clicking the button to generate the cards did absolutely nothing. I noticed the plugin was updated since I last installed it (roughly 3 months ago) so I reinstalled the plugin and now cards are generated properly. I am having an issue getting occlusions to display properly but that may just be me since it's been a month or two since I last made some.

All in all this is an outstanding plugin, and while I wish it could have a more friendly and intuitive interface I won't complain when it's free. :) Kudos to the author for improving the study habits of legions of users!

Best addon NA
Posted on 2014-11-03

Srsly. Doesn't get better than this. Medical school is EZ mode thanks to you! :)

Posted on 2014-10-13

Great add-on! Easy to use, just watch a couple youtube videos to learn how. The first time it didn't work when I pressed the "make cards" buttons, but I followed the advice of one of the reviewers below. I deleted the add-on and reinstalled, then it worked.

Impossible to use with Macbook Air 2013 running OsX Maverick
Posted on 2014-10-11

It's buggy as hell, slow, and after trying it for a couple hours, I just gave up.

Forced to uninstall. Please bring back the old version
Posted on 2014-09-28

It is extremely easy to create occlusions on images which is excellent.

However when reviewing the image occlusion cards either the picture doesn't load or the occlusions don't load rendering the card useless. I was therefore forced to uninstall the add-on.

By all accounts Image Occlusion ran extremely well before the update.

Please bring back the old version!

wrong "field count" error resolved
Posted on 2014-09-27

If I paste a PNG file, Image Occlusion 2.0 does not work.

If I use a JPG file, it DOES work

Loved it until the September update
Posted on 2014-09-14

I am running the current version of Anki on the current version of OS x. This extension has been invaluable to me as a student. Everything worked great until the update on September 12. Now I can't scroll around the image without it zooming in and out like crazy. It is a lot slower and a lot buggier than before the update. I suspect that the issue may lie with the SVG image editor and not the actual extension. Either way, I would like to have the old version back. I saw no improvement in the update.

Seems great, possible solution for mobile bug
Posted on 2014-08-12

Haven't used this a whole lot but seems to do what it says on the tin. I have experienced the same bug as other mobile users - the image loads before the occlusion shape - and seem to have solved it by changing the html code order so the rectangle loads first and using z-index to make the main picture then load beneath the rectangle in the card definition:

{{#Original Image}}
<div style="position:relative; width:100%">
<div style="position:absolute; top:0; width:100%; z-index:2">
<div style="position:absolute; top:0; width:100%; z-index:1">
{{Original Image}}<br/>
<span style="display:none">{{SVG}}</span>
{{/Original Image}}

{{^Original Image}}
<span style="display:none">{{SVG}}</span>
{{/Original Image}}

Problems with Mac Desktop and iPad users. Flashing answers.
Posted on 2014-07-28

The app is great except for one major flaw: whenever it goes to the next card, all of the answers will be exposed for a split second before loading the generated boxes. Usually this flicker is just long enough for me to be able to see the answers, which is extremely frustrating. Has anyone figured out a solution to this?

Still works well
Posted on 2014-07-28

Was having a few minor issues with the add-in not creating cards, but a quick delete-and-reinstall fixed it. Great add-in for those visuals.

Posted on 2014-05-05

Works exactly as you expect. Minor problem in that sometimes it will refuse to add cards, though it can be fixed by closing anki and opening it again.
I'm using it in conjunction with a program picpick to rip screenshots, cover the labels I don't want and then do the proper labelling in the addon.

Also don't go and do something silly like make your label boxes red (like I did) - red is the colour that the label boxes turn to to show you which you're supposed to be working on

I suggest when you start out to use a test deck just to get acquanted.
This has been massively helpful: I've made nearly 1000 cards for anatomy, which sounds rough, but it's light years better than having to try and remember that with text only

Very useful, but sometimes very frustrating indeed
Posted on 2014-04-22

When I do bigger images or rotate the rectangles non-horizontally, very often the note-adding buttons stop working until Anki is restarted. Updating SVG-Edit in the addon to 2.7.1 didn't help.

Brilliant addon !
Posted on 2014-04-16

How I've used it:

Screen capture.
Click the addon button
Image appears.
Add 1 or more masks.

This works so fast.
Thank you.

Posted on 2014-01-24

Image Occlusion is to diagrams what cloze in anki 2 is to cloze in anki.
Thank you for an awesome add-on. :)

Posted on 2013-12-12

This addon made my learning much more effective in almost all classes. It's much easier to remember things with pictures. The only drawback it has, it's not in vanilla anki (because of some qt-javascript problem as far as I know).

I strongly recommend this addon to everyone, it makes studying much easier and more enjoyable. It's really not only useful for medical things, but I also use it for things like chemistry, biology, economy, law and even languages (often there are pictures which show how something works in a language - much easier to learn this way). For things like physics and geometry it's very useful, too. I think there are endless possibilities to put this addon into action.

Just because of this addon I could boost my marks dramatically in some classes and in other classes I'm a bit better, too (after I already got better grades overall just by using plain Anki).

very frustrating
Posted on 2013-11-10

I just wasted countless hours trying to get this to work. Sometimes I will process an entire image and then click the "add note" button, and nothing will happen. Restarting Anki will fix this.

however the biggest problem is that when the cards are generated, they are all blank except for my rectangle. I don't know what to do and I am really upset that this wasted so much time I could have spent actually studying.

Thank your for the updates and ongoing support!
Posted on 2013-10-13

I would just like to express my gratitude for all the recent updates and support!

The latest revision is working perfectly on Anki 2.0.13.

Thank you for all your work and for creating this fantastic extension!

It's simply the best!
Posted on 2013-10-04

I can't live without it! Thanks a lot!

Posted on 2013-09-13

I used to do this manually. This is just perfect. No bugs encountered so far.

Anatomy made easy
Posted on 2013-08-29

I study medicine and this add-on is an essential part of Anki for me. I had problems with the previous versions but version 2.2 appears to work great. Thank you very much!

Worked for 4 days: now it prevents my whole deck from working
Posted on 2013-04-29

I downloaded this add-on on 4/23. I re-downloaded it on 4/28 to make sure I have the latest.

It worked great. I created about 40 cards with image occlusion in about 2 minutes, maybe even less time. As I said, awesome.

But about 2 hours ago when I created another card, it created errors. I did Check Database and that didn't work.

I emailed the programmer, Tiago. He emailed back, which I am thankful for. He recommended exporting the collection, uninstalling Anki, and reinstalling, and then importing. I did all that.

Still, it doesn't work.

This was an indispensable add-on. I am a huge fan. I am really disappointed I cannot use this for my securities exam (Series 7).

Here is the Discussion I opened up on Anki's site:

Thank you.

Bugfix does not fix major bug of using wrong base image
Posted on 2013-04-08

This add-on is wonderful but unfortunately still has a major bug that impedes using the addon without restarting anki frequently.

If you make one set of occlusions using image1 and add it to deck1 and then try to make another set of occlusions using image2 in another deck (deck2) the occlusions you draw on image2 will actually be applied to the previous image (image1) instead of the intended image (image2). These cards are obviously not useable and you do not know this has happened until you try to study them.

I think this is the problem the reviewer from 03-25-2013 is referencing.

Posted on 2013-04-01

Best plugin for Anki, but current bug that was described below needs a fix, kinda annoying to have to restart anki each time.

Bug found
Posted on 2013-03-25

Great plugin, however if you close the add window after making an occultion, then go back to add again and create another, they will end up with the image last used before the add window was closed. You won't be able to tell until you preview teh cards. Restart Anki fixes this.

A must for anyone studying medicine
Posted on 2013-03-09

for anyone doing medicine, this addon is a MUST. Fastest way to put diagrams into Anki.

Thank you so much.
Posted on 2013-03-01

That is all :)

This is huge!
Posted on 2012-11-14

To celebrate the occasion of the update, I just learnt the states of the U.S. -- from creating the deck to learning them it was only half an hour or so. Very nice look and feel, and thoughtful implementation!

2012/11 update is great
Posted on 2012-11-13

The 2012/11 update is great

Posted on 2012-10-30

Absolutely great!
Makes this type of card usable in a practical timeframe!
I'm going to be using this add on a lot!

Posted on 2012-10-21

I've been an avid Anki user for over a year and have 4000+ cards in my decks. I've used this app for a short while and it has already saved me a ton of time. I used to make image occlusion cards manually in Paint which I found very useful/efficient, but now I can make the same quality cards 8-10X faster. This addon is an absolute lifesaver for studying anatomy. HIGHLY recommended.