Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

🏆️Anki leaderboard Wiki

AnkiWeb Page | Code : 175794613

banner_shigeyuki_2

🌐Anki Leaderboard Web : You can check the leaderboard on this website.

alt text Discord for Anki Leadearborad

This add-on ranks all of its users by the number of cards reviewed today

This add-on is a customized version (fork) of the shutdown Anki LeaderBoard, originally created by Thore Tyborski and credit goes to him.

leaderboard


I’ve enhanced graphics by adding countries, ranks, tooltips, etc. If you find it distracting you can disable it in the settings. (Config -> others tab -> add Pic country and league)


alt text
(This image is a sample so all user names are hidden.)



📖How to use

  1. This add-on ranks all of its users by the number of cards reviewed today, time spend studying today, current streak, reviews in the past 31 days, and retention.
  2. You can also compete against friends, join groups, and join a country leaderboard.
  3. You’ll only see users, that synced on the same day as you.

🏆League

  1. In the league tab, you see everyone who synced at least once during the current season. There are four leagues. (Alpha, Beta, Gamma, and Delta) League
  2. The top 20% will be promoted, and the bottom 20% will be demoted. (Start -> Delta -> Gamma -> Beta -> Alpha)

📅Season (League)

  1. A season lasts two weeks. You don’t have to sync every day. For now I have it set to tally after 3 days and start a new league on the next Monday. (Because of time zone differences between countries and the time it takes mobile users to sync leagues on their PC)

👥Group

  1. Groups is the function to create private leaderboards. e.g. if you create a group with your schoolmates or friends only users who know the password can use the leaderboard. Anyone can freely create groups. If you want anyone to be able to join your group please include the password in the group name. 03_groups
  2. By default, there are public groups for Medicine, Language, and Pokemon. (password 1234)
  3. If you want to delete the group, please contact me.
  4. If you do not set a password, an error will occur.

🤝Friends

  1. You can add users to friends and display them like a group. (If you add a user as a friend, they will not be notified or see your name.) alt text
  2. To add a user as a friend, double-click on the user’s name and click the “Add friend” button or enter the name in Config.

🗝️Account

  1. You can Sign-up, Log-in, Delete account, Log-out, Change user name, and Biography.

  2. Click on the dropbox to toggle the account options.
    02_config_login_options

  3. 🚨Note: Do not use a name or biography that would offend other users, I often receive such reports and users who do not correct them will be banned.

📈XP formula

  1. XP = days studied percentage x ((6 x time) + (2 x reviews x retention))

  2. You have to study at least 5 minutes per day. Otherwise, this day won’t be counted as “studied” (See this issue for more info).

  3. Q. Why doesn’t my XP match when I calculate it manually?


🌐Leaderboard Web

📸Profile icon

I added function to display profile icons (prototype). Icons are displayed on the leaderboard and tooltip. If you find it distracting you can disable it in the settings: Config -> others tab -> add Pic country and league.

  1. 📤Upload Icon:

    1. You can upload your pictures to the server from the new menu.

    2. Menu - > Leaderboard -> Upload profile image alt text

    3. Uploaded images are automatically edited -> Height 64px Width 64px Circle

    4. Icons can be overwritten when uploaded again.

    5. 🚨Note:

      1. Icons will be displayed on leaderboards, tooltips, website leaderboards, etc. and will be stored in add-on as a cache (binary). If you are concerned about your privacy do not use it.
      2. Do not use photos that would be offensive to other users, I often receive such reports and users who do not correct them will be banned.
  2. 📁Profile Icons Cache :

    1. This function works by downloading icons from the server and storing them as a binary cache in the add-on’s user_file folder.
    2. If there are a lot of icons on the server it may take a long time to download the cache. In this case the order of downloading is like this:
      1. Friends -> Country -> Group -> Global -> League
    3. Downloading of the cache of icons from the server is done only while the leaderboard window is open. If you close the window it will be interrupted.
    4. The cache of icons deleted from the server is auto deleted from the icon cache user_file folder of add-on.
    5. These functions run a bit slowly in the background, so they should not affect Anki’s operation and your review. (Anki23+ is required)
    6. 🚨Note:
      1. Each icon is about 7-10KB so 1,000 user icons will require about 10MB of cache, thus if the number of users suddenly increases too much the cache may increase too much (e.g. 10,000users->100MB). I plan to develop workarounds for this once the server icons actually increase.

tooltip iconRank icons

  1. I’ve enhanced graphics by adding countries, ranks, tooltips, etc.

  2. If you find it distracting you can disable it in the settings: Config -> others tab -> add Pic country and league.
    alt text

  3. There are three types of rank icons on the leaderboard, each with 10 ranks in each of the leagues.

    1. Color (User’s current league) :
      1. tooltip icontooltip icontooltip icon tooltip icontooltip icontooltip icontooltip icon Alpha (Gold)
      2. tooltip icontooltip icontooltip icon tooltip icontooltip icontooltip icon Beta (Silver)
      3. tooltip icontooltip icontooltip icon tooltip icontooltip icon Gamma (Sapphire)
      4. tooltip icontooltip icontooltip icon tooltip icon Delta (Wood)
    2. Type (Each Leaderboard) :
      1. tooltip icon Global (Hexagon)
      2. tooltip icon Friends/Country/Group (Diamond)
      3. tooltip icon League (Shield)
    3. Grades (Each Leaderboard):
      1. tooltip icontooltip icontooltip icon A+ (Top 10%)
      2. tooltip icontooltip icontooltip icon A (Top 10-20%)
      3. tooltip icontooltip icontooltip icon B+ (Top 20-30%)
      4. tooltip icontooltip icontooltip icon B (Mid 30-40%)
      5. tooltip icontooltip icontooltip icon C+ (Mid 40-50%)
      6. tooltip icontooltip icontooltip icon C (Mid 50-60%)
      7. tooltip icontooltip icontooltip icon D+ (Lower 60-70%)
      8. tooltip icontooltip icontooltip icon D (Lower 70-80%)
      9. tooltip icontooltip icontooltip icon E (Bottom 80-90%)
      10. tooltip icontooltip icontooltip icon F (Bottom 90-100%)

E.g. if a user is B (Mid 30-40%) on the global leaderboard the rank icon will be icontooltip icon but if the user’s current league is Gamma the color will change and the rank icon will be icontooltip icontooltip icon.

Sync multiple devices

The default leaderboard does not allow multiple devices to log in at the same time. I added workaround for problem with multiple devices.

alt text

  1. Save data to AnkiWeb from your login device:
    • Config -> Others tab -> Sync multiple devices -> Auto save this device’s config dat to AnkiWeb[ON]
  2. Sync Anki decks.
  3. Sync Anki’s deck on the second device.
  4. Download the config data on the second device:
    • Sync multiple devices -> Download Config data from AnkiWeb

This saved data has nothing to do with the server’s leaderboard data, so you can either delete it or not after a successful login. (Sync multiple devices -> Delete AnkiWeb config data)

🎮️Gamification Mode

game-mode

Enhanced gamification with more icons and numerical feedback. If you don’t like it, you can disable it at once in the options(Config -> Oters tab). The code is not optimized yet, so there is a disadvantage for now that it increases the delay before the window is displayed.

Online Status

online-status

Display of yesterday’s users. Added a function to display the scores of users who logged in yesterday and not only today. Users who logged in today will see a green dot. If you do not like this yesterday, you can optionally disable it (Show only today’s users).

Review ProgressBar

review-progress

This will reach 100% when the average number of reviews for the month is reached.

Alert Emoji

alert-emoji

Added a function to display seconds in review. The 0-2 seconds/card is indicated by a patlamp. (Since the most common reason reported so far is that the review is too fast.) This function is only for display, so there is no penalty for now. If you are reviewing too fast for some reason, I recommend you to write the reason in Bio. (Because Bio will be displayed when someone reports a user.)

Time Ranks

time-02

The rank changes by the learning time. Maximum 12 hours.

Review Orb and Crystal

orb_and_crystal

Colorful orbs and crystals are displayed based on the average number of reviews in the last 31 days (or 2 weeks of league). The orb will change color and shape for every 100 reviews, counting in 10 steps until 3000 reviews. After that, the orb counts every 1000 reviews up to a maximum of 10,000 reviews.

Streaks Tree

StreaksTree

A tree grows after one week and can grow up a maximum of 3 years.

Cracker

StreaksCracker

Added a function that sometimes display cracker or cake by streaks.

Retention Weather

retention

The weather icon changes according to the retention rate.

XP ProgressBars

xp-progress

Calculates and displays the level from the XP (League Only). The blue progress bar indicates the XP required for the next level.

Level calculation formula

Calculated to be level 100 at approximately the top of the Alpha League, for now. (EXP 20,000,000)

python: math.floor(math.sqrt(exp / 2000))

  1. 📱Discord RP for Anki Leaderboard - study activity status
  2. 📌Rearrange home addons
  3. 🐻TidyAnkiBear - Select and hide Anki menu bar items

💖Credit



🚨Report problems or requests

If you have any problems or requests feel free to send them to me.

  1. AnkiWeb (Rate Comment) : You can contact me anonymously, and AnkiWeb will send you an email when I reply, a high rating increases priority of development.
  2. AnkiForums : Official AnkiForums support thread, it’s a good place for open discussion.
  3. Reddit (Fixed add-ons, or DM) : You can request me to repair broken Add-ons.
  4. Github (Issues) : Makes it easier to track problems. (I haven’t created a repository yet.)
  5. Patreon (Direct Message) : Response will be prioritized.



📥 How do I install this add-on?

  1. Copy and paste the add-on code ( 175794613 ) into Anki and you can install it. ( Menu -> Tools -> Add-ons -> Get Add-ons -> Code [ add-on code ] )
  2. When I develop bug fixes, create new features, or compatibility for New Anki, I will notify you and you can install it.
  3. The leaderboard is a special add-on that uses the server, unless I manage it regularly it will be broken in a few months, so If you like this add-on please support my volunteer development by rating, sharing, and donating. Thank you!

Click here and please Rate this add-on, Thank you! :-)
Please rate this



💡Frequently Asked Questions


Q. Can I show the leaderboard without opening the add-on window?

  • The leaderboard can be displayed in Anki’s Home by Config. (Leaderboard Config -> Settings -> Home screen -> Show the home screen leaderboard)

Q. How do I show the leaderboard after the review is finished?

  • This feature is not yet available, you can sync when the review is finished by Config. (Leaderboard Config -> Settings -> General -> Sync when deck is finished)
  • You can open the leaderboard with a shortcut key. (Shift + L)

Q. Login keeps failing and sync is not finished, what should I do?

  • Sometimes bad internet communication can prevent the connection, please try again later.
  • It may work if you remove the add-on and reinstall it.

Q. A user is cheating, what should I do?

My version of the leaderboard permits the use of cheats (except for server destruction or illegal activities), thus you can use any cheat you want (e.g. fix lost streaks), and all reports or discussions regarding cheating or criticism of other users are prohibited.

If you do not like other users, please address it with these ways.

  1. You can optionally hide distracting users. (Double click on user name -> Hide user)
  2. You can optionally hide all medals.(Config -> Settings tab -> Show league medals next to username)
  3. Create a group and set rules with your trusted friends and compete.

Please note if you call other users’ reviews cheating or criticize how other users review you will be banned, because those aren’t cheats in the first place and you’re the one violating the rules.

For a more detailed explanation about this, please read About Cheating Q and A.


Q. How do I delete a group?

  • The function to delete a group is not yet developed, please contact me.

Q. Why doesn’t my Anki Streaks match the leaderboard streaks?

If you customized “Next day starts at” you will need to set it manually. Please check if these settings match:

  • Leadearboard: Config -> Settings -> General -> The next day starts […] hours past midnight
  • Anki: Tools -> Preferences -> Review -> Scheduler -> Next day starts at […]

Q. When will the new league start?

  • For now I have it set to tally after 3 days and start a new league on the next Monday. Because of time zone differences between countries and the time it takes mobile users to sync leagues on their PC.

Q. Why doesn’t my XP match when I calculate it manually?

  • The cause of this problem is that the XP formula is partially omitted.

    • days studied percentage : This value is calculated as a number (0-100), not percentage (0%-100%).
    • Retention :
      • Retention is bonus is added, so it will be a little larger than the actual value. (e.g. 70% -> 85%, 40% -> 55% )
        Retention Bonus:
        85%-100% -> 100%
        70%-84%  -> 85%
        55%-69%  -> 70%
        40%-54%  -> 55%
        25%-39%  -> 40%
        10%-24%  -> 25%
        0%-9%   -> 0%
        
      • This value is first calculated as a number (0-100) and then converted to a percentage (0%-100%).

Q. What is the reason for using the bonus instead of real retention?

The reason for this is that retention is calculated by ranges.

Basically the retention rate recommended by Anki is 80-90%, and dedicated learners may aim for 90-95% or so. It is possible to aim for 95%-100%, but this is not efficient because the learning workload increases significantly, like this:

alt text


This means that Anki retention rates are not recommended to be perfect or as high as possible, and possibly slightly lower is more efficient for learning.

So I think 85% would be a reasonable range to be in the same range as 100%, 85% users do not need to go higher, and 95%+ users can lower the retention rate to make learning more efficient and not affect XP. (If the retention rate is changed to the same value as it is, users may make learning inefficient by making the retention rate as high as possible.)

Q. Why is not the leaderboard effective for my learning?

That’s very normal, the Leaderboard is an add-on for users who enjoy competition, so it is not for all Anki users. In gamification of learning users with high scores tend to be more motivated but those with low scores may become less motivated, this means learning efficiency may decrease for some users.

Also Anki is a learning app for studying so many Anki users dislike games in the first place, because they like studying more than games. Long time Anki users tend to prefer the simple version of Anki so there are often Anki users who don’t use add-ons at all.

In short the leaderboard is an add-on for the relatively small minority of Anki users who enjoy competition or gamification, if you like such add-ons it’s suitable for you but if not you don’t need to force yourself to use it, I recommend choosing the method that best suits your learning style.





About Cheating Q and A

Most people love gossip and rumors so reports about cheating are the most common on the leaderboard. (well people will do anything except study.)

Q. Why are cheats permitted?

TLDR: Because it’s cheaper. Basically Shige’s add-ons are made available for free by cutting costs as much as possible to the extreme. (e.g. dirty hacks, messy spaghetti code, lack of necessary documentation for developers, etc.)

alt text

Long explanation:

The leaderboard is intended for competitive purposes add-on and fair competition is ideal, but since Anki is a self grading and freely customizable learning app, truly fair competition or cheating prevention is technically impossible to develop. (to do this would require a format like a school exam, not Anki.)

So in my version of the leaderboard scores are based on self grading and users are free to use any learning method they prefer, in other words cheats are explicitly permitted. Because there is no way to distinguish between cheating and noncheating learning methods, and all discussions and reports about cheating are unproductive.

Thus reports and discussions regarding cheating and misconduct will not be permitted going forward. Please note if you pursue specific users for cheating or misconduct you may be banned, because such criticism could mistakenly hinder serious users’ learning.

If you dislike this system, instead of a report, please devise new features or rules to prevent cheating and request them to me. e.g. I’m in the process of developing these new features: Medals based on a new calculation method, the maximum value that can be sent, and leagues for groups. Suggestions that help improve learning efficiency for many users are welcome.

Q. Why is it impossible to prevent cheating?

The technical challenges are these for now:

  • Anki is self grading so there’s no way to verify whether users are being honest or not.
  • Anki users have different learning methods, so there’s no consensus or definition of what constitutes cheating.
  • Anki is open source program so users can easily manipulate the numbers sent to the server.
  • Anki decks are also open source and learning data is just numbers so users can easily generate dummy decks or cards.
  • The Leaderboard is a free add-on that I develop personally as a hobby so I don’t have the development resources to handle huge amount of reports like commercial apps do.
  • Even though such anti cheat are costly to develop they have very little effect on streamlining user learning so their development priority is low.

To resolve all these challenges we need to base the scoring on the exam and encrypt the program, but such a program is not Anki add-on anymore.


Q. Why is discussion about cheating prohibited?

Because there are too many reports. The leaderboard continues to increase in reports with the growth of users, also many Anki users are exhausted from studying and sleep deprived. And they don’t research or read past discussions or this Wiki, so these are almost equivalent to development obstruction. The leaderboard is an open-source and free add-on, not a commercial app, so there are no development resources to address these.


Q. Without anti cheat measures, won’t the number of users on the leaderboard decrease?

The leaderboard is an open source and free add-on, not a commercial app, this means I’m developing it as a personal hobby, so user numbers increasing or decreasing will not affect its development. Rather, the current biggest issue is developing support to handle the server load caused by the excessive increase in users.


Q. Without anti cheat measures, won’t it negatively impact regular users?

Because it’s very common for Anki add-ons to have such adverse effects.

e.g. One fundamental problem with leaderboards is that if learners study effectively their scores decrease, not increase. When learners create high level cards, study intensely, and manage their time well the number of reviews becomes smaller.

Also the Anki community for medical students recommends a maximum of 3 hours/perday and about 1,000 reviews/perday, it’s known from experience that learners who exceed this are highly likely to burn out. Most learners do not need such a large volume of reviews even enthusiastic learners are sufficient with about 60 new cards per day.

This means that competing on leaderboards may have negative effects on our learning. e.g. pointless reviews increase to boost scores and become inefficient, and study time is wasted and burnout becomes more likely.

So how should we deal with these negative effects? Do nothing!💪 If you dislike it merely do not use it, no one is forcing you to use the add-on.

That is why the leaderboard is an add-on rather than being developed by official Anki or any other volunteer group. Features that are effective for anyone’s learning are built into native Anki so such features do not become add-ons. In other words it’s very normal for almost all add-ons to have drawbacks or negative effects (or the development costs are too high), if not they’ll be incorporated into native Anki and disappear. That’s just how add-ons are.

The only way to determine whether something is effective for learning is for the learner themselves to judge it. There is no way for a program to identify or judge this. Please judge for yourself what is effective for your learning.


Q. Why are there users who review for more than 10 hours? Isn’t that impossible?

Because there are 24 hours in a day. Since there are 10+ million Anki users, it’s not that surprising that there are enthusiastic Anki users who literally spend 24 hours a day on Anki. If you believe that not one such learner exists in this world you are underestimating the human capacity, it is not uncommon for learners in learning communities to challenge human limits rather than simply study.


Q. Why are there users with a 100% retention rate? Isn’t that impossible?

Because Anki allows users to freely customize cards and review methods. e.g. you can set your desired retention rate to be very high like 99%, or review without using the “Again” button, or use filtered decks to change the buttons, or, you can also rearrange the cards so that the easiest ones are first, also you can suspend all the incorrect cards.


Q. Why are there users who review in just a few seconds? Isn’t that impossible?

In Anki it is commonly recommended to create flashcards that can be reviewed in less than 10 seconds, if not the card likely contains too much info. But for some subjects reducing the info isn’t possible (e.g. studying law) so the optimal card design varies depending on the subject you’re studying.

Users who complete reviews in under 5 seconds often use Anki’s Auto Advanced option or the Speed focus mode add-on. These automatically answer the card when time elapses so they’re popular methods for those wanting to shorten study time. (e.g. prevents overthinking)

Reviews under one second occur due to massive cramming. If learners are unable to memorize a card, it is recommended that they recreate it or suspend it, etc. But if learners do not do so or if recreating it proves ineffective they will memorize it by reviewing the card many times. Medical students who must memorize difficult cards and cannot suspend them or students aiming for high scores on exams may use such methods.


Q. Why are there users with thousands of reviews? Isn’t that impossible?

Such large amounts of review often occur when students cram before exams. Anki allows you to create filtered decks using tags, these decks can be reviewed repeatedly. So learners aiming for high scores on exams often tag cards in advance and review all cards as many times as possible before the exam. Similarly you can also focus intensively on difficult cards or incorrect cards.





💖Please Support Shige's Anki add-ons development!

Hi thank you for using this add-on I’m Shigeඞ!

  1. [ 🛠️Fix add-ons ] So far I fixed and customized 80+ broken add-ons for free and developed over 30 add-ons as a hobby (all add-ons). If you have requests to fix broken add-ons feel free to contact me. Fix broken addons (Free)
  2. [ 💖Donation ] I’m looking for supporters for my add-ons development because I like Anki!👍️ If you support my volunteer development you will get 14 add-ons for patrons only and 15 game themes included in AnkiArcade ($5/month).

patrons_banner
Get Patrons only addons | Patrons Q and A | Contact

[ Special Thanks ]
So far I received donations from 580 patrons and without their support I never could develop this, thank you very much!🙏

Patrons: Arthur Bookstein Haruka Luis Alberto, Letona Quispe 07951350313540 Lily Tim Daniel Kohl-Fink NamelessGO Kyle Mondlak ElAnki Abhi S Matthew Hartford findus161 Jonathan Contreras K Peasant of Anki Juan Salgado Yaeerrrrrr Elisabeth Barber Jesse Asiedu David C Ernest Chan Christopher Lam Steven Banner Heidi Leonora Lomoki Akporyoe GP O’Byrne Xiuxuan Wang KM Ujwal Chadha Kolorophyll Jake Stucki Kaitlyn Bowler Isabel Guan gus forester ellie Tobias Klös Aydin Herik Iggi Carly Burdorf Austin Regal Mia Hoang Hung iuventius Patrick ellis Orlando Frey Take Root Vivian Cao tarek qiting zeng Muneeb Khan Zarina Balde Pansanity Sameer Al Matheus Chagas Bryn Price Joseph Howell pie_is_good Svel1989 alpha male, shredded af Keeler Kime Anh-Tai Nguyen Kurt Grabow Gabriel Farrugia Terence Bartenbach R Rebecca Lis Y. Fahim Shaik Augusto Stein Ashok Rajpurohit mootcourt NoirHassassin Morgan Torres Dennis Obis Kmyungc Will S. Meeyah Davis Eric Allen Tae Lee Devon Williams alex han Andrew Yick Robert Remedios Simeon Gabriel Vinicio Guedes sab hoque only Ythalo Vlogs Ketan Pal Aurora Dzurko Kevin Galvez Tyler Schulte Mac Douglas Beeman Ali Abid Kyle Anthony Marley Easterbrook Temi Jide Ansel Ng Azfar Hussain Haley Schwarz …full list