Adds a lot of features to the main window. Allows to configure those features. Configurations are explained at the end of this document.
- Update: 19th January 2019: many bugs corrected. Configuration can be changed without restarting anki.
- Update 8th november 2018: you can configure the add-on using anki 2.1's configuration method. The configuration won't be lost during next update of the add-on !
Most features offered by this add-on are related to some column.
There is not a lot of change in this column, apart from the decks's color.
If a (sub)deck is empty, it turns red. (You can configure the color.)
This may not be useful for everybody. But if you want to know when a deck is empty in order to add new notes in it, it avoids to check in every deck the number of new cards. For example, if you want to learn guitar chords, it will let you know that it is time to add new chords to anki.
Better ! If you use subdecks, the ancestors of a empty subdeck becomes blue (also configurable). This allows you to find deck with an empty subdeck. Hence, it helps finding empty subdecks without having to uncollapse every top-level decks.
Note that, in some case, you don't want the name to become red. E.g. you wanted to learn the name of the greek letters. When you know all of them, you won't add any new note ever. You just have to add a semicolon (;) (it is configurable) to the name of the deck, and it will not turn red.
Decks with marked card has a blue background (configurable). And if furthermore, the deck's name contains a semicolon (i.e. as explained above, the deck is ended), then the background become yellow.
The number of review of cards in learning. By default you will see the number of review that can be done now, and in parenthesis the number of review which can be done later today.
The number of cards which you have seen in the past, and that you should see today. By default, the number of cards you will see today. And in parenthesis the number of cards you should see today, but that you will not see today because of your limite.
This column called new in Anki. It means New means «number of new cards you will see today». With the caveat that it is not exactly true for subdecks.
The column name "new" is deprecated. It is keep for retrocompatibility, but may be removed one day. It is the same thing as New Today.
By default, this column is hidden. Indeed, it becames two columns «due now» and «later». We recall that, in Anki, a due card is a card which is not new, and that you have to view again today.
The number of cards which you have never answered. Most of these cards are cards you have never seens. But it also consider cards you have seens and buried. You may have seen it and buried it. By default, the number of unseen cards which you will discover today, and in parenthesis the number of unseen cards you will not see today.
The number of cards whose delay is less than 3 weeks
The number of cards whose delay is least at least 3 weeks
The number of Buried cards. Recall that a buried card is a card you will not see today. Either because you did press the «bury» button. Or because you saw another card of the same note, so it was automatically buried.
The number of Suspended cards. Recall that a suspended card is a card you will never see again, unless you unsuspend it manually (using the browser)
The number of cards in this deck. It is not the sum of the preceding column, since it contains also cards you have already seen and which are not yet due. (and it counts only once a card with multiple reviews)
The total number of review you will see today (assuming you always press good)
The last column states which options group is used for the current deck. This avoids the pain to open the menu to see the option names. Really usefull when you have a lot of decks and want to see which is the last deck which used this old configuration you want to delete.
By default, Anki does not show any number greater than 1000. Instead it shows 1000+. You can now edit this limit. Or remove it entirely (by using a negative number). If you set the limit to 0, you will either see a 0, or "+".
Most options are configurable. If some option is not, send me an email, I'll see what I can do.
In order to configure this add-on,(hence, to configure what is shown in the main window) Go to Tools>add-ons>[name of this add-on]>Config. You'll see the configuration file. It will also display in a small window a display of the configuration's rule. We copy them below
- We first discuss the various small configurations related to the whole add-on.
- We then explain how to configure each column.
- We then explain how to configure coloring related to empty deck.
- We finally explain how to configure coloring related to marked cards.
In this section, we describe various small configurations related to the whole add-on.
If the value is null then the default css is used. Otherwise,
you can put the CSS you want here. Use the add-on (Newline in strings
in add-ons configurations)[https://ankiweb.net/shared/info/112201952]
if you want to use newline in JSON/CSS string.
How much time to wait between refreshing the main window. In seconds. By default, the window is refreshed every 30 seconds, thus, it is possible that change made less than half a minute ago are not yet shown.
Whether you want to display the deck's Option group's name, at the end of its line.
By default, without add-on, Anki never shows number greater than a thousand. Instead, it shows 1000+. You can decide to change a thousand by an arbitrary number. Or leave this value to null, and always show the real value.
Note that capping to a thousand does not usually make the rendering quicker.
Each column should occur after the line "columns" :[, and before the line with a closing bracket ]. The order of the lines is important, since it's the order in which columns will be displayed by anki. This means that you can reorder columns in anki by reordering the lines in the configuration. You can copy a line to display a column multiple time (for example, once using percent, and another time using absolute number).
Each column is represented between an opening curly bracket {, and a closing curly bracket }. Each column uses 8 parameters, each represented as a pair
key:value We'll tell you the meaning of each key, whether you can change its value, and what will this change do.
The first value is a description, which will tell you what the column represent. Do NOT alter this value, or the add-on will raise an error.
A description of the content of the column. This is not used by anki, it allows you to decide whether you want the column or not while you edit the configuration.
The value for the key "present" is either true or false. If the value is true, the column will be displayed. Otherwise, it will not. Note that you can also delete the entire column from the configuration, instead of changing the value to false.
If this value is absent, by default, it is assumed that it should be true.
The header of the column. If you leave «null» then the default header will be used. This description will be translated as much as it is possible to do it automatically. However, you can also choose to write your own description. You can use html in this description. I.e. you should use "
" when you want a newline.
The text shown when your mouse is over a number. It will describe what this number represent. You can remove this key if you want no description to be present. And leave this value to null if you want to use the default value.
The color in which the number is written in this column. You can use any color acceptable in an HTML document. The most standard color's name should work.
true or false whether you want to show the percent of cards satisfying this colun condition. For example, 23% of cards are new. Note that sometime, this would not make sens. For example, for the column «cards», the value will always be 100% (unless the deck is empty). For the column notes, the number would not really make any sens (formally, you'd get the percent of cards which is the first of its sibling in this deck).
By default, if percent is absent, it is assumed to be false.
Whether you want an absolute number in your column. That is, a number which is not a percent, but an exact number.
By default, this value is false if Percent is set to true, otherwise its default value is true.
When you consider a deck which has subdecks, you may want to consider cards in subdecks (it is done when the value is true), or you may want to ignore them (it is done when the value is false).
Please do not touch this value. It is used internally by the add-on. If you edit this value, the add-on will throw an error message and anki won't be able to display the main window.
The author of this add-on want to know when a deck is empty. This is very important to him, because he want to add new cards in them as soon as possible. Thus, this add-on change the color of the name of empty decks, and of name of decks with an empty descendant.
The author also want to know which deck has marked card. Thus, the background of the deck's name with marked card change color.
Both of those configuration can be changed as explained in this section. In particular, you can turn one or both of those options off by setting "color empty" and "color marked" to false.
The color of the name of decks without new cards
The color of the name of decks with a descendant without new cards
The color of a deck whose every descendant has new cards.
The color of the decks which has an ended deck with marked cards. The notion of ended deck will be explained in the next section of this documentation.
The color of deck who have marked cards but none of its descendant are both ended and has marked card.
A deck modifier is a symbol (or a word, etc..) whose presence in a deck name change the meaning of the deck. When the meaning is changed, the coloration is also change. It's not clear to the author of this add-on whether anyone appart from himself will need those, but if you want to use them, here is the explanation.
The first three symbols currently has the same effect, but it may occur that one day this effect may change, according of what the author want to do.
By default, this symbol is ";". It means that the deck is definitively done, and no new card may ever be added to it. When a deck has this symbol, neither itself nor its descendant will ever be colored.
By default, this symbol is "/".To the author, it means that no new card will be added because this deck is either too hard, or not interesting enough.
By default, this symbol is "=". To the author, it means that more new card will be added latter, but right now it does not want anki to change the color of the deck's name. In a future version, there may be an option to change the color of those decks.
- In
aqt.deckbrowser, changeDeckBrowser._renderDeckTree,DeckBrowser.refreshandDeckBrowser._deckRow. The former methods are not called. - In
Anki.notes, changeNote.flush. The new method calls the former one. - In
anki.deckschangeDeckManager.save, calling the former method. ChangingDeckManager.collaps, not calling the former method.
| Key | Value |
|---|---|
| Copyright | Arthur Milchior [email protected] |
| Based on | Anki code by Damien Elmes [email protected] |
| Based on | Helen Foster's code, in add-on "Deck_Counts_Now_Later" |
| Original idea | Juda Kaleta [email protected] |
| Somme CSS | Some idea from cjdduarte |
| License | GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html |
| Source in | https://github.com/Arthur-Milchior/anki-enhance-main-window |
| Addon number | 877182321 |