Gamepad Viewer

This gamepad viewer puts your button presses on screen while you stream or record. It is a controller overlay with a transparent background, added to OBS as a browser source.

Press a button on your controller to move the preview.

YXBA
Layout
Colour
Stick trail
Controller

Browser source size: Width 640, Height 400

How to use the gamepad viewer in OBS

  1. Pick a look. Set Layout and Colour in the panel above until the preview matches your controller and your scene.
  2. Copy the address. Press Copy address. Your choices are stored in that link, so there is no account and nothing to save.
  3. Add a browser source. In OBS, click + under Sources, choose Browser and paste the link into the URL field.
  4. Set the size. Enter the two numbers from the table below, press OK, then drag the controller to a free corner.
Field in OBSWhat to enter
URLThe copied address
Width640
Height400

Press any button once and the overlay wakes up. First time with this controller? Make sure every button registers in the controller tester before you go live.

Layouts and colours

These gamepad viewer skins come in two layouts and three colours.

  • Xbox Offset sticks and A B X Y letters. Use it for Xbox pads and most PC controllers.
  • PlayStation Level sticks, the four shapes and a touchpad. Pick it for a PS5 or PS4 controller.
  • Auto Reads the name of the connected controller and switches between the two for you.

Colour is about your scene, not your controller: Dark for bright games, Light for dark ones, and Clear when you only want outlines over the gameplay.

Controller overlay settings

Size, opacity and stick trail decide how the drawing sits on your stream. Everything except size is written into the address, so the gamepad viewer opens the same way every time OBS loads it.

SettingIn the addressWhat it does
Layoutlayout=xbox or psFixes the layout. Left out, it means Auto
Colourcolor=light or clearLeft out, it means Dark
Opacityopacity=20 to 100Lets the game show through
Stick trailtrail=1Draws the recent path of each stick
Controllerpad=2, 3 or 4Follows that controller instead of the first
SizeNot in the addressThe drawing fills the Width and Height you set in OBS

Because it is a plain web page, this input overlay needs no plugin and no update.

Gamepad viewer not working?

Four things stop a controller display in OBS. Check them in this order.

  1. OBS in the background. OBS 31.0.0, 31.0.1 and 33.0.0 stop reading controllers while another window has focus. Update OBS. On Windows, running OBS as administrator is a known workaround.
  2. Source settings. Leave "Shutdown source when not visible" and "Refresh browser when scene becomes active" unticked. Both reload the page, and it forgets the controller.
  3. Another app has the controller. Steam Input and remapping tools can hide the pad or rename it. If Auto picks the wrong layout, set Layout by hand.
  4. No first press. A web page only gets a controller after one of its buttons is pressed. Press one after the source loads.

More controller tests

Frequently asked questions

Does it work in Streamlabs?

Yes. Streamlabs Desktop has the same Browser Source. Paste the address there and enter the same width and height.

Can I show two controllers at once?

Yes. Add a second browser source and set Controller to 2 before you copy its address. Each source follows one controller.

Is this gamepad viewer free?

Yes. There is no account, no watermark and no limit on stream time.

Will the overlay lag behind my inputs?

By about one frame. The page redraws once per frame, so at 60 fps the drawing trails your press by roughly 17 ms.