🏆️Anki leaderboard Wiki

• AnkiWeb Page | Code : 175794613
  

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

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.

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)

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

• 🏆️Anki leaderboard Wiki
• 📖How to use
  • 🏆League
    • 📅Season (League)
  • 👥Group
  • 🤝Friends
  • 🗝️Account
  • 📈XP formula
  • 🌐Leaderboard Web
  • 📸Profile icon
  • Rank icons
  • Sync multiple devices
  • 🎮️Gamification Mode
    • Online Status
    • Review ProgressBar
      • Alert Emoji
    • Time Ranks
    • Review Orb and Crystal
    • Streaks Tree
      • Cracker
    • Retention Weather
    • XP ProgressBars
      • Level calculation formula
  • 🔗Related Add-ons
  • 💖Credit
• 🚨Report problems or requests
• 💡Frequently Asked Questions
  • Q. Can I show the leaderboard without opening the add-on window?
  • Q. How do I show the leaderboard after the review is finished?
  • Q. Login keeps failing and sync is not finished, what should I do?
  • Q. A user is cheating, what should I do?
  • Q. How do I delete a group?
  • Q. Why doesn’t my Anki Streaks match the leaderboard streaks?
  • Q. When will the new league start?
  • Q. Why doesn’t my XP match when I calculate it manually?
  • Q. What is the reason for using the bonus instead of real retention?
  • Q. Why are cheats permitted?
  • Q. Why is it impossible to prevent cheating?
  • Q. Why is not the leaderboard effective for my learning?
• 📥 How do I install this add-on?

📖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)
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.
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.)
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.
   

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

• 🌐Anki Leaderboard Web : You can check the leaderboard on this website. (past 24 hours)
  
  

📸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

   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.

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

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. Alpha (Gold)
      2. Beta (Silver)
      3. Gamma (Sapphire)
      4. Delta (Wood)
   2. Type (Each Leaderboard) :
      1. Global (Hexagon)
      2. Friends/Country/Group (Diamond)
      3. League (Shield)
   3. Grades (Each Leaderboard):
      1. A+ (Top 10%)
      2. A (Top 10-20%)
      3. B+ (Top 20-30%)
      4. B (Mid 30-40%)
      5. C+ (Mid 40-50%)
      6. C (Mid 50-60%)
      7. D+ (Lower 60-70%)
      8. D (Lower 70-80%)
      9. E (Bottom 80-90%)
      10. F (Bottom 90-100%)

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

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.

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

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

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

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

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

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

Review 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

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

Cracker

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

Retention Weather

The weather icon changes according to the retention rate.

XP ProgressBars

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))

🔗Related Add-ons

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

💖Credit

• Original add-on : Anki LeaderBoard / Author : Thore Tyborski
  

  • Contributions : khonkhortisan, zjosua, SmallFluffyIPA, Atílio Antônio Dadalto, Rodrigo Lanes, Abdo

• Images: Crown icon /Freepik, flaticon.com, Person icon /iconixar, flaticon.com, Settings icon/Phoenix Group, Flaticon, Confetti gif/ Giphy

• Rank icons : Rhos @RhosGFX
• Star icon : Clip Art Library

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

Since it is technically impossible to prevent cheating in Anki, the use of cheats is explicitly permitted, thus all reports are unnecessary. (detailed explanation: Q. Why are cheats permitted?)

So if you think another user is cheating, 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. If you want fair competition, create a group with your trusted friends.

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:

Q. Why are cheats permitted?

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

📥 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! :-)