Skip to content

Instantly share code, notes, and snippets.

@emleddin
Last active January 18, 2024 05:21
Show Gist options
  • Save emleddin/fa059bd25445f9bb30150857640c0bc9 to your computer and use it in GitHub Desktop.
Save emleddin/fa059bd25445f9bb30150857640c0bc9 to your computer and use it in GitHub Desktop.
Instructions for using the 8BitDo Micro Remote with ANKI on MacOS

Using the 8BitDo Micro Remote with ANKI

The 8BitDo Micro remote is ~$25 and can be used to gamify your studying. The Micro is bigger than the Zero 2, but smaller than the SN30 Pro.

See controller image below

The controller comes with preset keybindings to buttons, which don't automatically work with ANKI. So, through the use of a key remapping software, you’ll update how your device interprets the keys!

If you don’t want to download a remapper, you should be able to use an Anki add-on to change the keyboard shortcuts to match the existing buttons on the device. Certain add-ons allow you to define add-on specific bindings (such as those for AMBOSS).

Here I'll go through set-up using karabiner-elements.

MacOS Karabiner

  1. Install karabiner-elements
    • Allow it to access input monitoring through the security and privacy menu
  2. Put the remote into keyboard mode by sliding SDK slider on the bottom edge to K
    • The remote does have a manual explaining pairing.
  3. Turn on your remote by holding the "checkerboard" bottom right button
  4. Hold the button next the slide on the bottom edge for 1 second to enter pairing mode
  5. Ensure bluetooth is on for your computer, and connect to the controller
    • Device should be something like 8BitDo Micro Gamepad
  6. Open karabiner-elements
  7. Under Simple Modifications, highlight the 8BitDo device, and then use the letters from the initial keybindings. - See karabiner-elements image below
    • Letters under Letter keys
    • Shifts under Modifier keys
    • Numbers under Number keys
    • Spacebar under Controls and symbols
    • D-pad arrows under D-pad
8BitDo Micro Initial Keybindings Suggested Remapped Keys Anki Function for Suggested Remap
Up arrow c d Decks
Down arrow d a Add
Left arrow e s Edit card
Right arrow f spacebar Show answer
A g 4 “Easy”
X h 1 “Again”
Y i 2 “Hard”
B j 3 “Good”
L (back) k spacebar Show answer
R (back) m spacebar Show answer
L2 (back) l , Open next AMBOSS pop-up
R2 (back) r . Close AMBOSS pop-up
  1. Notes
    • Certain add-ons let you modify the shortcuts (like AMBOSS). The AMBOSS add-on-specific bindings were changed, since karabiner-elements does not play well with multi-key mappings.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment