Joystick user guide

Some AptiPilot tests (such as Follow and Crosshairs) are designed to be used with a joystick. To enable joystick control, a small third-party application is required to translate joystick movements into mouse movements.

Important: A joystick is not required for all tests. If a test does not specifically require joystick input, it can be completed using a mouse.

What you’ll need

  • A USB joystick (any standard PC-compatible joystick)
  • A desktop or laptop computer (PC or Mac)
  • The setup software listed below for your operating system

PC users (Windows)

Quick setup

  1. Download JoyToKey
  2. Unzip the downloaded file
  3. Open JoyToKey.exe
  4. Keep JoyToKey running (minimised is fine) while using joystick-based tests

JoyToKey may display messages about purchasing a licence. These can be safely ignored — the free version is sufficient.

Once running, moving your joystick should control the mouse cursor.

Mac users (macOS)

Quick setup

  1. Download Enjoy2
  2. Download the AptiPilot configuration profile
  3. Unzip both files
  4. Open Enjoy2

The first time you open Enjoy2, macOS may block it. If this happens:

  • Go to System Settings → Privacy & Security
  • Click Open Anyway
  • Confirm when prompted

Enable the AptiPilot profile

  1. Restart your Mac
  2. Download the AptiPilot Profile.json file
  3. Move the file AptiPilot Profile.json to: Users/YOUR_USERNAME/Library/Application Support/Enjoy2/mappings
  4. Open Enjoy2
  5. Select the AptiPilot profile
  6. Click Start
  7. Your joystick should now control mouse movement.

Allow permissions (if required)

If nothing happens when you click Start:

  1. Go to System Settings → Privacy & Security → Accessibility
  2. Ensure Enjoy2 is enabled
  3. You may need to unlock settings using your password

Optional: Manual configuration (advanced users)

If the profile does not load correctly, you can manually configure:

  • Axis 1 → Mouse movement (horizontal)
  • Axis 2 → Mouse movement (vertical)
  • Button 1 → Key press: F
  • Button 2 → Key press: R

Common questions

Do I need a joystick to use AptiPilot?

No. Only certain tests use joystick input.

Can I practise without setting this up?

Yes — all non-joystick tests work with a mouse only.

Does AptiPilot support joysticks natively?

No. External software is required due to browser limitations.