🏆️Anki leaderboard Wiki

banner_shigeyuki_2

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)

  1. 📌Rearrange home addons
  2. 🐻TidyAnkiBear - Select and hide Anki menu bar items
  3. 📱Anki Discord Sidebar - Chat room within Anki

💖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.



💡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?

There are two ways to Hide or Report a user.

1. Hide user

Basically if you find such users distracting, please hide them.

  • Double click on user name -> Hide user

2. Report

These are some of the most commonly reported examples of suspected cheats:

  1. Review time is too fast
  2. Retention is too high

However these may not be cheats because learner use Anki in different ways, these are possibilities:

  1. The learner may be reviewing a batch of cards before the exams.
  2. The learner reviews a lot of easy cards.
  3. The Learner is delayed review and trying to catch up.
  4. The learner may be using Anki's option to shorten the time to record.

In my opinion these learning methods are not malicious so they do not deserve a ban (perhaps the calculation method needs to be changed).
In any way we lack development resources yet at the moment, so basically please address this problem with hide user.

Q. How do I delete a group?

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

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:

workload


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 doesn't the leaderboard sort order help my learning?

For now there are workarounds for these, try these settings if you haven't already:

[1] Sorting
You can change the sort order of the leaderboards. (Today's Reviews, Today's Time, Streak, Reviews in the past 31 days, and Retention) e.g. Sort by past31days to exclude all users who reviewed a lot just today.
Config -> Settings -> Genearl -> Sortby

[2] League
Leagues are regularly scheduled for 2 weeks and are calculated by XP, not by reviews. It is a system that requires long term learning, so short term learners will not be able to get to the top. So far about half of the top rankers are medical students, and language learners seem to be a relatively small minority.

[3] Changing the default leaderboard
You can change the default leaderboard to be displayed. (Global, Friends, Groups, and Leagues)
Config -> Settings -> Genearl -> Default Leaderboard
e.g. if you are only interested in groups of medical students you can set the group of medical students as your default leaderboard. The medical students group has the most active users 334. (Languages have 136 users, 2024-11-18). The number of active users is small for now but the total number of active users is increasing by about 1000 every few months, so I guess it will be solved in the long run.

[4] Hide users
If there are users who are offensive to you, you can hide them by using the hide user option: Double-click on the user's name

[5] Report Users
If you report a user you can contact me and I can ban the offending user, basically I do not reply to reports but I read all of them: Double click on the user's name

But even if we use all of these functions I think it is still insufficient, so currently the functions under development are like these:

[1] XP enhancements
Use XP or score in global leaderboards.

[2] Display of past history
e.g. Leaderboards for yesterday, this week, a month, all periods. Leagues for groups, history.

[3] Auto hide users in bulk
e.g. Hide users who review too quickly in bulk, hide all users using offensive words, hide all users who have joined a particular group.

[4] Enhancement of ban function
e.g. Make it impossible to avoid banning by re-registering, introduce stealth BANs.

All of these functions are technically developable but will still take some time to develop, this free add-on is developed and maintained by me as an individual free volunteer(In short it's just a hobby when I get bored of it it's over), and basically fixing bugs and supporting the latest Anki is a high priority.



📥 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