AnkiFriends

AnkiFriends adds a social leaderboard to Anki, so you can compare study statistics with friends and stay motivated together.

📊 Features

• Personal Stats Dashboard, your Study Score, streak, and time studied today, this week and this month
• Friends Leaderboard, add friends by username and compete on a shared list
• Friend Requests, people who add you show greyed out at the bottom of your leaderboard, where you can add them back, reject them or ignore them
• Profiles, showing date joined, friends since, highest score on record, a status line and all current stats
• Study Score, one number built from your last 30 days of activity, covering consistency, retention, volume and review speed
• Deck Browser Widget, compatible with Onigiri

📈 How the Study Score Works

The score comes from your last 30 days of activity, and the leaderboard ranks by it.

Formula: Score = C × R × V × S × 1000

• Consistency (C), 0.5 to 1.5: how many days out of the last 30 you studied on. This is not your streak, and it is the biggest factor. Showing up every day gives the full 1.5×, a single day gives 0.5×
• Retention (R), 0 to 1: the share of cards you answered correctly, so 90% correct gives 0.90
• Volume (V): log₁₀(effective reviews + 1). More is better, with diminishing returns, and a card you spend longer on counts for more
• Speed Penalty (S), 1.0 or 0.1: triggers only when your average review time is under 0.5 seconds, which catches mindless clicking and bots. If it fires, the score drops by 90%. Cards with no recorded time are left out of the average, so an imported deck cannot trip it

Typical scores range from about 1,000 for light use to 10,000 for heavy use.

🚀 Getting Started

1. Click the Friends Tab in the toolbar, or the AnkiFriends widget on the deck browser
2. Pick a username when asked, or press Later and do it whenever you like
3. Add friends by their username
4. Study, refresh the leaderboard, and climb

👥 Friends

• When you add somebody, they show greyed out on your side until they answer. Add back keeps them, Reject removes them for good in that direction, and Ignore hides them without telling them
• Ignored requests wait under Tools > AnkiFriends > Ignored friend requests, and that entry only appears once there is something in it
• Removing a friend is silent and works both ways. You simply stop seeing each other, and either side can send a new request later. Only a Reject blocks a new request
• Change your username once every 30 days, and your friends follow the new name automatically

💡 Tips

• Stats reach the server when you refresh the leaderboard
• The streak counts consecutive days of studying, and it does not affect your score
• Your account is kept in the Anki collection as well as the add-on config, so a reinstall keeps it

Found a bug, or have an idea for the next update? Tools > AnkiFriends > Send Feedback, and it comes straight to me.

Thank you for 500+ users! This addon was originally made for my friends, but kept growing from there. I'm running this on a Raspberry Pi, trying to keep it free for everyone :)

📋 Changelog

2.0.0

• Friend requests, with add back, reject and ignore, and an ignored list in the Tools menu
• Profiles with a status line, dates, highest score on record and all current stats
• Change your username, and friends follow the new name automatically
• Delete your account from the About window
• A Later button on the first run username prompt, and it returns on restart until you pick a name
• Silent friend removal that works both ways and never blocks a new request
• Dark mode readability fixes (thank you for the suggestion!)

1.5.0 and 1.4.0

• The Speed Penalty now looks at cards under 0.5 seconds, and cards with no recorded time are left out of the average
• If the server no longer recognises your install, the leaderboard says so and offers a one click way to ask for a reset, instead of failing in silence