Home

Awesome

<p align="center"> <a href="https://github.com/open-spaced-repetition/fsrs4anki/wiki"> <img src="https://github.com/open-spaced-repetition/fsrs4anki/assets/32575846/9efb2ca5-51bd-411d-9694-a77b09f51fa7" width="150" height="150" alt="FSRS4Anki"> </a> </p> <div align="center">

FSRS4Anki

✨ A modern spaced-repetition scheduler for Anki based on the Free Spaced Repetition Scheduler algorithm

</div> <p align="center"> <a href="https://raw.githubusercontent.com/open-spaced-repetition/fsrs4anki/main/LICENSE"> <img src="https://img.shields.io/github/license/open-spaced-repetition/fsrs4anki" alt="license"> </a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/releases/latest"> <img src="https://img.shields.io/github/v/release/open-spaced-repetition/fsrs4anki?color=blueviolet" alt="release"> </a> </p>

Table of contents

Introduction

FSRS4Anki consists of two main parts: the scheduler and the optimizer.

For details about the FSRS algorithm, please read the algorithm. If you are interested, you can also read my papers:

FSRS4Anki Helper is an Anki add-on that complements the FSRS4Anki Scheduler. You can read about it here: https://github.com/open-spaced-repetition/fsrs4anki-helper

How to Get Started?

If you are using Anki v23.10 or newer, refer to this tutorial.

If you are using an older version of Anki, refer to this tutorial.

Note that setting up FSRS is much easier in Anki v23.10 or newer.

Add-on Compatibility

Some add-ons can cause conflicts with FSRS. As a general rule of thumb, if an add-on affects a card's intervals, it shouldn't be used with FSRS.

Add-onCompatible?Comment
Review HeatmapYes :white_check_mark:Doesn't affect anything FSRS-related.
Advanced BrowserYes :white_check_mark:Please use the latest version.
Advanced Review Bottom BarYes :white_check_mark:Please use the latest version.
The KING of Button Add-onsYes :white_check_mark:Please use the latest version.
Pass/FailYes :white_check_mark:Pass is the equivalent of Good, Fail is the equivalent of Again.
AJT Card ManagementYes :white_check_mark:Compatible with Anki 23.12 and newer.
Incremental Reading v4.11.3 (unofficial clone)Unsure :question:If you are using the standalone version of FSRS, it shows the interval given by Anki's built-in scheduler, not the custom scheduler. This add-on is technically compatible with built-in FSRS, but FSRS was not designed for incremental reading, and FSRS settings do not apply to IR cards because they work in a different way compared to other card types.
Delay siblingsNo :x:Delay siblings will modify the intervals given by FSRS. However, the FSRS4Anki Helper add-on has a similar feature that works better with FSRS. Please use the FSRS4Anki Helper add-on instead.
Auto Ease FactorNo :x:The Ease Factor is no longer relevant when FSRS is enabled, therefore you won't benefit from using this add-on.
autoLapseNewIntervalNo :x:The New Interval setting is no longer relevant when FSRS is enabled, therefore you won't benefit from using this add-on.
Straight RewardNo :x:The Ease Factor is no longer relevant when FSRS is enabled, therefore you won't benefit from using this add-on.

Let me know via issues if you want me to check compatibility between FSRS and some add-on.

Contribute

You can contribute to FSRS4Anki by beta testing, submitting code, or sharing your data. If you want to share your data with me, please fill out this form: https://forms.gle/KaojsBbhMCytaA7h8

Contributors

<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->

All Contributors

<!-- ALL-CONTRIBUTORS-BADGE:END --> <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Expertium"><img src="https://avatars.githubusercontent.com/u/83031600?v=4?s=100" width="100px;" alt="Expertium"/><br /><sub><b>Expertium</b></sub></a><br /><a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=Expertium" title="Tests">⚠️</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=Expertium" title="Documentation">📖</a> <a href="#data-Expertium" title="Data">🔣</a> <a href="#ideas-Expertium" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/issues?q=author%3AExpertium" title="Bug reports">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/user1823"><img src="https://avatars.githubusercontent.com/u/92206575?v=4?s=100" width="100px;" alt="user1823"/><br /><sub><b>user1823</b></sub></a><br /><a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=user1823" title="Tests">⚠️</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/commits?author=user1823" title="Documentation">📖</a> <a href="#data-user1823" title="Data">🔣</a> <a href="#ideas-user1823" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/open-spaced-repetition/fsrs4anki/issues?q=author%3Auser1823" title="Bug reports">🐛</a></td> <td align="center" valign="top" width="14.28%"><a href="http://chrislongros.com"><img src="https://avatars.githubusercontent.com/u/98426896?v=4?s=100" width="100px;" alt="Christos Longros"/><br /><sub><b>Christos Longros</b></sub></a><br /><a href="#data-chrislongros" title="Data">🔣</a> <a href="#content-chrislongros" title="Content">🖋</a></td> </tr> </tbody> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->

Developer Resources

If you're a developer considering using the FSRS algorithm in your own projects, we've curated some valuable resources for you. Check out the Awesome FSRS repository, where you'll find:

This carefully curated list will help you better understand FSRS and choose the right implementation for your project. We encourage you to explore these resources and consider contributing to the FSRS ecosystem.

Star History

<a href="https://star-history.com/#open-spaced-repetition/fsrs4anki&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=open-spaced-repetition/fsrs4anki&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=open-spaced-repetition/fsrs4anki&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=open-spaced-repetition/fsrs4anki&type=Date" /> </picture> </a>