Skip to content

remnoteio/remnote-gamepad

Repository files navigation

RGC Logo

🎮 RemNote Gamepad Controller: Connect your favorite game controller and use it in your Flashcard Queue!

GitHub Stars GitHub Issues GitHub Contributors

👾 Overview

RemNote Gamepad Controller (RGC) is a RemNote Plugin that allows you to connect your favorite game controller to RemNote and use it to navigate your flashcard queue. RGC is designed to be simple and easy to use, so you can spend less time configuring and more time studying. (Works out of the box with most controllers!)

📅 Planned Features

  • Controller Profiles for different controllers (e.g. You can have a profile for your Joycon (R) and another for your 8BitDo SN30 Pro)
    • Support for Nintendo Switch Joycons (L/R, as pair or individually)
  • Indicator for when controller is connected
  • Better Button Binding UI (cancelled - don't have the energy to implement this right now. If you find this is a priority, please let me know!)

Have an idea for a new feature? Contribute to RGC development!

📖 Documentation

Predefined Button Mappings

Each queue interaction is mapped to one or more buttons:

Action Slot 1 Slot 2 Slot 3
Forgot North Button (Y) North D-Pad Left Trigger
Easily Recalled South Button (A) South D-Pad Right Trigger
Recalled with Effort East Button (B) East D-Pad Right Bumper
Partially Recalled West Button (X) West D-Pad Left Bumper
Skip Start Button
Back Select Button

Note

In parentheses are the buttons on an Xbox controller. For other controllers, please refer to the controller's button layout.

Customizing Button Mappings

  1. Open Plugin Settings and navigate to Gamepad Queue Controller
  2. Select the button you want to assign a Queue Interaction to
  3. Go back to studying and enjoy your new button mapping!

Customizing Button Mappings Theme used: Catppuccin

(better method coming soon! for now, head to Plugin Settings to manually configure)

FAQ

How do I connect my controller to RemNote?

  1. Download the latest version of RGC from the RemNote Plugin Store
  2. Connect your controller to your computer via USB or Bluetooth
  3. Open a Flashcard Queue in RemNote
  4. Buttons should immediately start working!

How do I know if my controller is connected?

(coming soon!)

How do I know if my controller will work with RGC?

RGC is designed to work with most controllers out of the box. If you're unsure if your controller will work, please download and try. See the My controller isn't working with RGC. What do I do? section for more information.

How do I disconnect my controller from RemNote?

For this, you can either:

  • Disconnect your controller from your computer
  • Close the Flashcard Queue in RemNote
  • Disable the plugin in Plugins > Manage

My controller isn't working with RGC. What do I do?

If your controller isn't working with RGC, please open an issue. See the Bugs and Issues section for more information.

🐛 Bugs and Issues

Found a bug or want to suggest a feature? Please open an issue on our GitHub Issues page. Your feedback is invaluable!

Note

If you're reporting a bug, please include as much information as possible to help us reproduce the bug. I love detailed bug reports! PS. If you have an idea for a better name for the plugin, please let me know! 😭