How to Use the Gamepad Tester
Testing your controller takes just a few seconds:
Connect your controller. Plug in a USB gamepad or pair a Bluetooth controller to your computer. The browser won't detect it until you press at least one button — this is a security feature of the Gamepad API.
Press any button. Once you press a button, the tester instantly recognizes your controller and displays its name, vendor ID, and the total number of buttons and axes. Every subsequent input is shown in real time.
Check every input. Press each button individually and watch it light up on the visual map. Move analog sticks to see their X/Y coordinates plotted on a circular graph. Pull triggers to see their analog pressure values from 0% to 100%.
Test vibration. Click the vibration test button to send a haptic pulse to your controller. If the motors spin, your rumble support is working correctly.
Key capabilities:
- Real-time button detection — every button lights up instantly when pressed
- Analog stick visualization — circular plot showing exact X/Y position and deadzone
- Trigger pressure bars — see exact analog values for L2/R2 triggers
- Multi-controller support — connect up to 4 controllers simultaneously
- Vibration test — verify haptic feedback motors are functioning
Supported Controllers & Compatibility
The Gamepad API is supported in all modern browsers (Chrome, Firefox, Edge, Safari) and works with virtually any controller that registers as an HID device:
Xbox controllers: Xbox One, Xbox Series X|S, Xbox 360 (wired), and Xbox Adaptive Controller all work natively via USB or Bluetooth. Button mapping follows the standard gamepad layout.
PlayStation controllers: DualShock 4 (PS4) and DualSense (PS5) are fully supported. Analog triggers, touchpad button, and motion sensors are detected. Haptic feedback works in Chromium browsers.
Nintendo Switch: Switch Pro Controller and Joy-Cons work over Bluetooth. The tester correctly reads all buttons including the screenshot and home buttons.
Generic / third-party: Logitech, 8BitDo, PowerA, HORI, and most USB/Bluetooth HID controllers are supported. If your OS recognizes the controller, this tester will too.
Mobile: On Android devices with Chrome, connecting a Bluetooth controller allows the same testing functionality directly from your phone or tablet.
Troubleshooting & Diagnosing Controller Issues
Use the tester to diagnose common controller problems:
- Stick drift: If the analog stick visualization shows movement when you're not touching the stick, your controller has drift. The tester shows the exact offset values so you can determine if it's within a fixable deadzone range or if hardware repair is needed.
- Sticky buttons: Press each button and release. If any button stays highlighted after release, it may be physically stuck or have a faulty contact.
- Trigger range: A healthy analog trigger should smoothly go from 0% to 100%. If it never reaches full range or jumps in value, the trigger potentiometer may be worn.
- Connection drops: If the controller keeps disappearing from the tester, check your USB cable or Bluetooth connection. Wireless interference can cause intermittent disconnects.
- Wrong button mapping: Some generic controllers don't follow the standard gamepad mapping. The tester shows raw button indices so you can identify which physical button corresponds to which index.
Step-by-Step Instructions
- 1Connect your gamepad via USB cable or Bluetooth.
- 2Press any button on the controller to activate detection.
- 3View the real-time button map — each press lights up the corresponding button.
- 4Move analog sticks and watch the circular position graphs update live.
- 5Pull triggers to see their analog pressure values.
- 6Click 'Test Vibration' to verify haptic feedback motors.
- 7Connect additional controllers to test multi-player setups.