Gamepad Viewer Docs

Complete reference for every URL parameter available in Gamepad Viewer. Customize your controller overlay for OBS, streaming, and recording. Need a ready-made link? Use the URL Generator instead.

Player Number

Required for Compact

https://gpadviewer.com/?p=1

The player number parameter selects which connected controller to display and activates Compact Mode. Compact Mode strips the background and all UI elements so only the bare controller skin remains, which is ideal for stream overlays and recordings.

Property	Value
Parameter	`p`
Unit	N/A
Default	None (viewer mode)
Accepted	`1` , `2` , `3` , `4`

Notes

Setting this parameter is what switches Gamepad Viewer into Compact Mode
You can display all four players at once by combining values: p=1,2,3,4
Without this parameter, the full UI with skin selector and background is shown

Skin ID

Requires p=

https://gpadviewer.com/?p=1&s=1

The skin ID determines which controller model is rendered in Compact Mode. Each ID maps to a specific controller skin. This is the only built-in way to switch between controller visuals without writing custom CSS.

Property	Value
Parameter	`s`
Unit	N/A
Default	`1` (Xbox One)
Accepted	`0` Xbox 360 , `1` Xbox One , `2` PS3 , `3` PS4 , `4` GameCube , `5` FightPad

Notes

A player number (p=) is required for the skin parameter to work
Any ID outside the accepted range falls back to 1 (Xbox One)
For fully custom controller art, use the css= parameter instead

Strength Meter

Visual Toggle

https://gpadviewer.com/?p=1&smeter=1

Switches the trigger display mode from opacity-based feedback to a fill-bar strength meter. When enabled, the triggers show a rising bar that represents analog pressure, which is easier to read on stream.

Property	Value
Parameter	`smeter`
Unit	N/A
Default	`0` (opacity mode)
Accepted	`0` off , `1` on

Notes

Any value other than 1 keeps the default opacity behavior
Strength meters are recommended for racing and fighting game streams where trigger pressure matters

Scale Multiplier

Display Size

https://gpadviewer.com/?p=1&sc=1.5

Controls the rendered size of the controller skin. A value of 1 is the original size. Use decimal values for fine adjustments, or go above 1 to enlarge for high-resolution overlays.

Property	Value
Parameter	`sc`
Unit	Multiplier
Default	`1`
Accepted	Any number, including decimals (e.g. `0.8` , `1.5` , `2.0`)

Notes

Values below 1 shrink the controller, values above 1 enlarge it
Negative values will flip the controller while also scaling it
Common stream sizes are sc=1.2 for 1080p and sc=1.8 for 4K overlays

Deadzone Radius

Stick Filter

https://gpadviewer.com/?p=1&dz=0.3

Sets a circular deadzone around the center of each analog stick. Any stick movement within the deadzone radius is ignored and the stick stays centered on the visual display. This is essential for older controllers with stick drift.

Property	Value
Parameter	`dz`
Unit	Normalized (0 to 1)
Default	`0.25`
Accepted	Any decimal from `0` (no deadzone) to `1` (full lock)

Notes

A value of 0 means every tiny stick movement is displayed
Setting dz=1 or higher completely disables visible stick movement
Typical values for drift correction are between 0.15 and 0.35
This does not affect D-pad or button inputs

Input Delay

Sync Tool

https://gpadviewer.com/?p=1&delay=2000

Adds a timed delay to all displayed inputs. This is designed for streamers who capture gameplay from a console while reading controller input on a PC. The delay syncs the overlay to match your video feed so inputs appear at the right moment.

Property	Value
Parameter	`delay`
Unit	Milliseconds
Default	`0`
Accepted	Any positive integer (e.g. `500` , `1000` , `3000`)

Notes

Measure your capture card latency first, then enter that value here
PS4 Remote Play typically adds 1000 to 3000ms depending on network quality
A value of 0 means real-time display with no artificial delay

Rotational Stop

Wheel Mode

https://gpadviewer.com/?p=1&rot=450

Converts the thumbstick display into a steering wheel representation with a configurable maximum rotation angle. The value you enter is half the total rotation range, so a 900-degree wheel would use rot=450.

Property	Value
Parameter	`rot`
Unit	Degrees (half-rotation)
Default	`120`
Accepted	Any positive number (e.g. `90` , `180` , `450`)

Notes

Designed primarily for racing wheel overlays in sim racing streams
The deadzone parameter (dz) directly affects rotation, so set dz=0 for accurate wheel display
Common values: rot=450 for most Logitech wheels, rot=540 for Fanatec wheels

Custom CSS URL

Full Skin Override

https://gpadviewer.com/?p=1&css=YOUR_CSS_FILE_URL

Loads an external CSS file that completely replaces the active controller skin with your own custom design. This is how community-made skins and branded overlays work. The built-in skin class is swapped to .custom so your CSS takes full control.

Property	Value
Parameter	`css`
Unit	N/A
Default	None
Accepted	Any publicly accessible URL pointing to a valid CSS file

Notes

This parameter overrides the s= skin ID parameter entirely
The selected skin class is replaced with .custom in the DOM
Host your CSS on GitHub Gist, Pastebin, or any CORS-enabled server
URL-encode special characters in the file URL (spaces become %20)

Edit CSS URL

Skin Modifier

https://gpadviewer.com/?p=1&s=1&editcss=YOUR_CSS_FILE_URL

Loads an external CSS file that adds to and modifies the currently selected skin instead of replacing it. Use this when you want to tweak colors, sizes, or specific elements of a built-in skin without rebuilding the entire thing from scratch.

Property	Value
Parameter	`editcss`
Unit	N/A
Default	None
Accepted	Any publicly accessible URL pointing to a valid CSS file

Notes

Unlike css=, this does not replace the active skin. It layers on top of it.
The .edit class is applied to all gamepad elements for targeting
Works alongside the s= parameter. Pick a base skin, then modify it.
Ideal for small changes like recoloring buttons or hiding specific elements

Ready to build your overlay?

Use the URL Generator to create a custom Gamepad Viewer link with your preferred parameters, then drop it into OBS as a browser source.

URL Generator Back to Viewer