Contanki allows users to control Anki using a gamepad or other controller device. To install, visit AnkiWeb or use the install code 1898790263.
Features:
- Comfortably review your cards using a gamepad - no more sore hands, backs, or eyes!
- Pull up a helpful overlay to remind you of the control mapping
- Control almost any Anki feature
- Fully customisable control bindings
- Cursor control for limited situations where the gamepad is insufficient
- Much more!
Usage Notes
Connect your controller via USB or Bluetooth, install the add-on, restart Anki, and press any button to get started.
Since Anki has a lot of functions to map, Contanki uses modifier buttons (by default, the triggers (R2 and L2) are used). This mean that the other buttons will trigger different commands according to whether a modifier button is held down, similar to shift, control, etc on a keyboard. Holding down the modifier buttons will also pull up an overlay showing the control binding for the current context. To show the overlay for the unmodified controls, hold down both triggers at once.
Controls can be reassigned using the add-onâs config dialog. You can assign controls for each context (review, deck browser, etc), as well as global settings that are used if a control isnât assigned to a particular context. It is suggested that you try the default control bindings to begin with, and make changes as needed. You can remove any actions you donât need if the controls overlay is too cluttered.
Works best on 2.1.50, but support is provided for 2.1.45 and above. Please note the version specific issues below.
Analog Sticks
By default the right stick is used to move and click the mouse, and you can use L2 + right stick for a secondary click. It is only possible to click within Anki. The left stick is used to scroll and to navigate between views. Sticks can be reassigned and can also be put in âbutton modeâ, where actions can be assigned to the directions of a stick.
Choosing a Controller
I have been testing using a DualShock 4, which makes a good choice and can be readily purchased secondhand at a reasonable price. The cheapest option would be a knockoff SNES controller, which can be found for $10 or less.
Currently it is only possible to use a single controller at a time. This may include Joy-Cons depending on your system, but support for using both Joy-Cons is planned.
Testing
This add-on is still in beta, so there may still be some bugs. Please report all issues on the GitHub issue tracker or post here on the forum. Reports about bugs on Windows or when using an Xbox controller are particularly welcome as I have been testing almost exclusively on Mac using a DualShock 4 up to now.
If you encounter an issue, let me know what you were trying to do, what platform and controller youâre using, and the text of any error or message your receive. Please take note of the known issues and donât report anything listed there. Suggestions are also welcome, and can also be raised on the issue tracker.
Known issues
- Interaction outside of the main window (especially the browser and preferences) is only partially implemented
- Clicking outside Anki or in the title or menu bars doesnât work
- Add-on doesnât function in the profile window
- Unable to open or close webview context menus
Version Specific:
- Opening certain menus or dialogs prevents any actions from firing, until itâs closed and they fire all at once. This mostly affectts Anki 2.1.49 and below. The above issue is mostly fixed in 2.1.50, but some dialogs may still prevent actions from firing.
- A small number of actions are only supported in 2.1.50
Platform Specific
- Volume controls only work on MacOS
Controller Specific
- Only a single Joy-Con can be used at a time. Support for using Joy-Cons as a single controller is planned.
