<span style="font-color:red;">Detailed explanation with screenshots can be seen here: </span>Anki Addon Support Forum Post
Incremental Reading is a way to read many articles concurrently and efficiently add spaced repetition cards to Anki in the process. In essence, you add reading material to an Incremental Reading deck in Anki and read it as time permits. As you read, you can highlight important passages and extract them into separate cards in Anki, either for further refinement, or as final SRS cards in another Anki deck. When you have finished reading an article, you will have incorporated all the important knowledge into your Anki deck(s) and can delete it, confident that the knowledge will be continually reinforced by Anki’s core SRS function.
The Incremental Reading Extension addon relies on the View Size Adjust addon for several important navigation and keyboard shortcut capabilities. Be sure to add both addons before you begin.
NOTE on UPGRADING:
This version changes the IRead2 model. Changing the model will require you to modify your existing IRead2 cards (removing little used Model and Deck fields, adding Title) or delete the IRead2 model and all associated cards before installing the upgrade.
NOTE on the original Incremental Reading addon:
The Incremental Reading Extension addon is a fork (an alternative) of the original Incremental Reading addon. Do not attempt to install both concurrently.
To get started, once you've installed the addon (and the View Size Adjust addon), create a new Deck called 'Incremental Reading.' You want to use a separate deck because Incremental Reading is fundamentally different from typical Anki work. Anki SRS is for memorizing. Incremental Reading is for creating content to memorize using Anki SRS. Once you have a new deck, add a new IRead2 card to the deck and populate its Title, Text and Source fields. The text of the article you intend to read will go in the text field.
When you choose to study the Incremental Reading deck, it will present you with the full text of the article. You read and extract material using the keyboard shortcuts discussed below in the Features section. If you finish the article, you probably want to delete it. But if you are reading incrementally, you may read it intermittently along with other article. In that case, when you hit the 'show answer' button, you'll be presented with three buttons for prioritizing the card: 'Soon', 'Later' and 'Custom.' See below for further explanation on scheduling.
The Incremental Reading Extension, along with the View Size Adjust addon, supports incremental reading in Anki with the following features:
• Keyboard navigation
o PgUp, PgDn, ArrowUp, ArrowDown
o Also available from the Edit menu
• Keeping track of where you left off in each article
o Scroll to last viewed text when the card is loaded
o Uses same ‘zoom factor’ you last used for the same card
• Adjust the size of the text as needed
o Ctrl++ to increase text size
o Ctrl+- to decrease text size
o Saves selected size with each card and reapplies when shown
o Also available from the Edit menu
• Highlighting of text
o Select and hit ‘h’
o Custom colors (Hit Alt+2 to open a dialog. Also available from Edit menu)
o Anti-highlighting option (color text, rather than background)
• Custom keyboard shortcuts for adding cards efficiently
o Alt+1 to create a custom shortcut
o Choose deck, card model, shortcut key combination, highlighting, field into which to paste selected text, and to whether or not you want to see the add/edit dialogs.
o Automatically copies Tags from source Incremental Reading card to the new card created using the keyboard shortcut.
o Automatically copies Source field from Incremental Reading card to the new card created using the keyboard shortcut (if new card model has a Source field).
o Shortcuts are added to the Edit menu as they are created.
o Removing a shortcut is done by disabling it using the same dialog. Hit Alt+1, choose the same key combination and uncheck ‘Enabled’ checkbox.
Independent scheduling algorithm more suitable to Incremental Reading
o Queue depth based, rather than time-based
o Configurable ‘Soon’ and ‘Later’ scheduling buttons. Dialog for editing these options is available in the Tools menu (‘Incremental Reading Scheduler Options’). Options include:
• Push a card to a specific depth (count or position) in the queue
• Push a card to a percentage depth into the queue
• Apply randomness to either approach
o Custom organizer dialog.
• Move any card to any position in the queue
• Bulk moves
• Opened from Tools menu (‘Incremental Reading Organizer’).
• Also opened from ‘custom’ answer button when working with Incremental Reading cards in the Anki Reviewer.
<h3>To Show Editor or Not to Show Editor</h3>
A couple of options on the Add Shortcut dialog (Alt+1) require explanation:
Show Add Cards dialog
– This checkbox is checked by default. When you invoke the keyboard shortcut, the Add Cards dialog will be opened as it normally is when you add cards in Anki. It will be prepopulated with the Deck and Card Model you’ve chosen. If this checkbox is unchecked, the shortcut will add the card automatically without opening the Add Cards dialog. This is a convenience for incremental reading where a frequent activity is creating smaller, but still large, extracts from a source article and feeding those back into the Incremental Reading deck. The shortcut takes care of populating all fields with reasonable values in that case, making opening the dialog inconvenient (because you then have to close it).
Show Edit Current dialog
– The original Incremental Reading addon opened two dialogs every time you attempted to add a new card. First it opened the Edit Current dialog, which contains the same card you were just looking at, but in editing mode. Second it opened the Add Cards dialog that you would normally expect. The advantage to this option is that you can delete the text from the original article as you do extracts, rather than highlighting. Personally, I prefer highlighting and deleting the entire original article at the end when I’m done with it.
<h3>Scheduling Algorithm for Incremental Reading</h3>
Anki’s normal scheduling algorithm is designed to support Spaced Repetition and address the “forgetting curve.” It makes very little sense to try to schedule reading material using the “forgetting curve” and its increasing intervals. Instead, incremental reading is really a matter of prioritizing a large number of articles based on your interest level and the importance you place on each article. Accordingly, a different scheduling algorithm is required.
For incremental reading, the goal is to manage a queue of articles and to be able to reprioritize each article every time you read it. It should also be possible to find an article you want to see, no matter where it is in the queue, and bring it forward. And periodically, you may want to review the entire queue and organize it in a specific way.
The scheduling algorithm attempts to meet the above goals without interfering with Anki’s normal scheduler or dramatically changing the Anki interface. To do so, it effectively removes the Incremental Reading cards from the Anki scheduler and keeps all the incremental reading cards permanently in the NEW queue. This keeps all Incremental Reading cards available all the time (not hidden away in a REVIEW queue to be shown again in a few days, weeks or months).
An incremental reading card will always have three buttons labeled ‘Soon’, ‘Later’ and ‘Custom’. The meaning of ‘Soon’ and ‘Later’ is configurable, but essentially means ‘This is important and I want to see it again Soon’ or ‘This is less important, don’t show it to me again until Later.’ If, despite configuration, you don’t get the behavior you want, or if you want to handle a card specially, there is the ‘Custom’ button, which opens the Organizer dialog to let you put that card wherever you want in the queue.
Configuration of the ‘Soon’ and ‘Later’ scheduling options is available from the Tools -> Incremental Reading Scheduler Options menu item. Options include:
– Treat the configured value as a simple position number.
– Treat the configured value as a percentage value
– Apply some randomness to the placement of the item using the configured count or percentage value.
– The numeric value. It represents either a count or a percentage.
<h4>Position vs Percent</h4>
If you choose Position and don’t apply Random, then hitting the button in question will directly place the card at the position you indicated. If you apply Random, it will place the card at a random position between 1 and the Position you indicated.
If you choose Percent and don’t apply Random, then hitting the button in question will calculate the position as a percentage of the queue depth and place the card at that position. If you apply Random, it will place the card at a random position between 1 and the calculated position by percentage.
The above explanations apply for the ‘Soon’ button. The ‘Later’ button differs only in that the placement of the card will be between the Position or Percentage given for ‘Soon’ and the Position or Percentage given for ‘Later’. Thus, if you specify 10 Percent for ‘Soon’ and 50 Percent for ‘Later’, the ‘Later’ button will place the card at a position between 10 and 50 percent into the queue.
The Organizer is a dialog that shows a list of all the cards in the Incremental Reading deck. There is a checkbox next to each card that can be used to select an individual card or many cards and move them up or down in the queue. To move a card up, check the box next to that card and click the ‘Up’ button. To move a card down, click the ‘Down’ button. If multiple cards are checked, they move up or down together.
If a selected card cannot be moved up because it has hit the top of the queue or because the card above it is also selected, it will not be moved. Cards selected below it can move up until all selected cards make a contiguous block. The same applies for moving cards down alone or in bulk.
The ‘Pin Top/Bottom’ checkbox at the top locks the top-most (or bottom-most) item in place while ‘Up’ or ‘Down’ are clicked to move other selected items, allowing you to ‘anchor’ a block of selected items anywhere in the queue.
The Card Position field at the top of the Organizer allows you to specify a position to directly move the top-most selected item to. If multiple items are selected, they move up or down together.
<h2>Compatibility and Upgrading</h2>
Update your View Size Adjust addon.
You need the most recent of both the Incremental Reading Extension addon and the View Size Adjust addon.
IRead2 Card Model has changed.
• Removed Model and Deck fields. The original IRead2 card has Model and Deck fields that were needed by the predecessor Incremental Reading addon. With the custom shortcuts approach used by Incremental Reading Extension, they are no longer needed. Accordingly, they have been removed.
• Added ‘Title’ field. Using the Organizer requires you to be able to identify each card sufficiently to be able to prioritize it in the queue. Adding a ‘Title’ field makes that possible.
Changing the IRead2 model means that for those of you who are upgrading, there is a little work. Here are the options for doing the upgrade.
– Delete the IRead2 card model before applying the new addons. This will delete all IRead2 cards in your collections. The addons will create the new IRead2 card model when installed.
– Modify the IRead2 model before updating the addon.
• Delete the Anki Deck field and the Model field. Anki will warn you that it will be modifying your collection in a way that makes it incompatible with the copy in the cloud or on other devices. You will need to do a full sync afterwards.
• Add the Title field and position it as the first field in the model. Also check the radio button that says to use that field for sorting in the Browser.
Initial Release (1.0) 20121228 - Extension of Incremental Reading addon to provide scrolling convenience, scroll position persistence per card, custom shortcuts for card extraction, and text highlighting.
UPDATE (1.0.1) 20120229 - Added link (subscript #) at the end of highlighted text to support removal of highlighting. Intent is to use same link to support cross-linking with corresponding card created from original highlighted text.
UPDATE (1.1) 20120229 - Added sync support. Will sync shortcuts, size and scroll position between desktop instances of Anki. NOTE - corresponding update of View Size Adjust addon (1.3) does the same for view size in all decks (outside of Incremental Reading).
UPDATE (1.1.1) 20120229 - Fixed issue with highlight not being reapplied after editing the card.
UPDATE (1.1.2) 20120230 - Fixed issue with IRead2 note type not being created on installation of the addon. Fixed issue affecting filenames with multiple profiles.
UPDATE (1.2) 20130106:
- Migrated add cards shortcut capability to View Size Adjust addon so it could be used outside of the IRead2 model. That addon also puts the shortcuts in the Edit menu so you can reference what shortcuts you have created. Also added the ability to select the highlight color to apply to the IRead2 source card for a given shortcut. <span style="color:red;font-weight:bold">Please download the latest View Size Adjust addon.</span>
- Added a dialog to permit setting the highlight color used when hitting 'h' key.
- Fixed issues with saving scroll position under some circumstances. Now saves based on reviewCleanup hook (anytime the reviewer is closed, which covers the Incremental Reading situation where the reviewer is closed in the middle of a reading session) as well as anytime the show answer button is pressed.
UPDATE 1.2.1 (20130106) - Reverted functionality to open the source IRead2 card in an edit window when hitting 'x' for 'c', for extracting or creating cards, per feedback from users. For those that prefer a single window approach, the custom shortcuts provide that workflow.
UPDATE 1.2.2 (20130107) - Fixed issue with error on final card of review.
UPDATE 1.3 (20130108) - Minor update to support a related change in View Size Adjust addon to enable adding cards based on a selection without opening the Add Cards dialog.
UPDATE 1.4 (20130116) - Added option to color text instead of background when using highlight function alone or with the Add Cards shortcuts. Look for the radio buttons in the highlight and create shortcut dialogs.
UPDATE 1.4.1 (20130121) - Fixed error on using original 'x' and 'c' shortcuts.
UPDATE 1.4.2 (20130126) - Fixed issue with shortcut being duplicated in menu when switching profiles. Requires update to View Size Adjust plugin as well.
UPDATE 2.0 (20130317) - Added separate scheduling capabilities from Anki SRS. Requires upgrading View Size Adjust as well.
UPDATE 2.1 (20130318) - Cosmetic adjustments to dialog text and sizing.
UPDATE 2.2 (20130402) - Added default value for doHighlightFont to address bug on closing (failed to save because value had no default value). Also should address issues with switching profiles.
UPDATE 2.3 (20140609) - Adopted changes provided Aleksej (https://gitorious.org/vsa_and_ire/vsa_and_ire)
. Added here for convenience of new adopters.
As add-ons are programs downloaded from the internet, they are
malicious. You should only download add-ons you trust.
To download this add-on, please copy and paste the following code
If you were linked to this page from the internet, please go to the
and then Add-ons>Browse & Install to paste in the code.
Posted on 2014-08-18
If you get an error when installing about missing View_Size_Adjust try installing that Anki add on as well from here: https://ankiweb.net/shared/info/3136737107
ImportError: No module named View_Size_Adjust
Donation for bugfixes?
Posted on 2014-08-17
Where can we donate to support this?
Posted on 2014-08-05
An error occurred in an add-on.
Please post on the add-on forum:
Traceback (most recent call last):
File "C:\cygwin\home\dae\win\build\pyi.win32\anki\outPYZ1.pyz/aqt.addons", line 39, in loadAddons
File "c:\pyi\iu.py", line 436, in importHook
File "c:\pyi\iu.py", line 521, in doimport
File "C:\Users\acer\Documents\Anki\addons\Incremental_Reading_Extension.py", line 26, in <module>
File "c:\pyi\iu.py", line 455, in importHook
ImportError: No module named View_Size_Adjust
Good idea, but I did have some problems ...
Posted on 2014-07-08
I am NOT bashing the add-on; it worked at first for a couple of days and I appreciate the effort the programmer put into it.
After changing the note type for some cards I added via Incremental Reading, I opened the 'Manage Note Types' dialogue in Anki and wanted to make some changes; when I tried to close the dialogue I got the usual error box when there's trouble with some add-on. Only this time; I could NOT close that box, it kept popping up. The only way to get out of this was to kill the Anki process, which should be a no-no as data loss might occur (fortunately, it didn't).
So for the time being, I had to uninstall the add-on. I don't really know whether the add-on or Anki itself is to blame … I'll simply copy and paste text snippets myself into Anki for now.
Anyway, this is ALWAYS the downside of that third party plugin/add-on concept; the more you add, the more unstable the whole thing potentially becomes …
Description is written by a 10 year old apparently.
Posted on 2014-06-30
This is the worst piece of writing I had to force myself to read through in a long time.
At least fix your HTML tags.
link does not work
Useful, at least if you know how to use it.
Posted on 2014-06-17
The fixes from https://gitorious.org/vsa_and_ire/vsa_and_ire have been incorporated here, but you can still find a couple of hints on usage there (under "Not in the manual").
Also note that the .dat files had "_" prepended to their names, which means you may have to rename them to preserve whatever useful settings they contained.
An essential feature; give it a try
Posted on 2014-02-22
I believe the reason why incremental reading is not widely popular amongst SRS users is that it is so badly explained everywhere (and its name is terrible).
Incremental reading could be described as the addition of study material in bulk to an SRS, for future processing into flashcards. Needless to say, you add as much as you want: you can work on one piece of text at a time if you feel like it, or just a few (this is what I do), or thousands, as the Supermemo website thinks is appealing to most, for some unfathomable reason.
This means that ANY material dense enough to be heavily clozed (such as a textbook, study notes or a text in a foreign language) can be processed much, much faster through incremental reading. Paste the material into a new card, start reading it, and create clozes as you study it. You can stop whenever you want and pick up right where you left off later. Everything is already in your SRS.
If you don't like the idea of reading on a screen, you can read the material before, and then paste it into Anki and use incremental reading to create cards from it in bulk. If you are reading from a paper source, just OCRise it. This will still be faster and less boring than the traditional way of entering cards.
You may have noticed this is just like copying and pasting material into Anki for each new card - but much more convenient. If you have been doing that, then refusing to try incremental reading (like I did) is like refusing to put your paper flashcards away and to upgrade to software just because you're used to it and "it does the job". This is silly.
Anki users asked for efficient clozes, and they got them. Image occlusion seems like the next popular thing, and I hope it will one day become a native feature. Incremental reading, or "one-step flashcard generation" as it should be called, is the next logical step. But it will not happen unless those who can benefit from it start using it, and realise how useful and sensible a feature it is.
Now that the rant is over, on the add-on itself... It is actually really simple, although a quick set-up guide would be helpful (everything you need is on this page, though). Of course, it is rather basic, but it should be enough to save you a LOT of time - something for which I am infinitely grateful to the author (and the author of the original add-on). I hope it is not dead and more updates will follow; loosing IR for Anki would be really sad.
Posted on 2013-03-01
This appears to be just what I wanted in an IR addition to Anki, and I look forward to moving my study completely over to this platform.
NOTE: Do NOT install both this and the Incremental Reading plug-in. Doing so will generate an error. I tried to do this, thinking that the opening comment meant that you had to have both, and never had success.
Posted on 2013-02-20
Some of the explanations on here were a bit confusing, but once I got the hang of it I really like this plugin. It makes the tedious work of making flashcards out of key points in the reading much simpler.
Thanks a bunch,