Reference // URL Parameters

Gamepad Viewer Docs

A complete reference for every URL parameter in Gamepad Viewer. Mix and match these to build the exact controller overlay you want for OBS, Streamlabs, or recording. Prefer point-and-click? The URL Generator builds the link for you.

How parameters work

Every option is added to the page URL as a parameter. The first one starts with a question mark, and each one after that is joined with an ampersand.

Pattern: ?p=1 then &s=3 then &sc=1.5, giving ?p=1&s=3&sc=1.5.

The p= parameter is the important one. It selects your controller and switches the page into a clean, transparent overlay mode with no background or UI.

Use it in OBS in 3 steps

Build your link below or with the URL Generator, then copy it.
In OBS, add a Browser Source and paste the link as the URL.
Press a button on your controller so it wakes up, then resize the source to fit your layout.

A full example, annotated

https://gpadviewer.com/?p=1&s=3&sc=1.4&dz=0.2&smeter=1

Player Number

Required for Overlay

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

The player number selects which connected controller to display and switches the page into Compact (overlay) Mode. Compact Mode strips the background and all UI so only the bare controller skin remains, which is exactly what you want for a stream or recording.

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

Notes

Setting this parameter is what switches Gamepad Viewer into Compact Mode
Show 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
Most overlays start here. Add the other parameters after it.

Skin ID

Requires p=

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

The skin ID chooses which controller model is rendered in overlay mode. Each ID maps to a specific controller skin. This is the built-in way to switch controller visuals without writing any 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 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 at a glance 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
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 decimals 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 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. Movement within the radius is ignored and the stick stays centered on the display. This is essential for older controllers with stick drift, so the overlay does not show phantom movement.

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. Designed for streamers who capture gameplay from a console while reading controller input on a PC. The delay syncs the overlay to 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 uses 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) 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 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 to tweak colors, sizes, or specific elements of a built-in skin without rebuilding the whole 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-made recipes

Copy one of these as a starting point and swap in your own values. Each line is a complete overlay URL.

Clean Xbox overlay for 1080p

Player one, Xbox One skin, scaled up slightly for a crisp 1080p canvas.

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

PS4 overlay with drift correction

PlayStation skin with a deadzone so an aging stick does not wander on stream.

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

Fighting game with trigger meters

FightPad skin with the strength meter on so trigger pressure is easy to read.

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

Sim racing wheel (Logitech)

Wheel mode at 900 degrees of total rotation, with the deadzone off for accuracy.

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

Console capture, synced to a capture card

Adds a 2-second delay so the overlay lines up with delayed console footage.

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

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