Symbolic Controller DB

The SDL controller DB provides useful abstract descriptions of where buttons are and how controllers behave, but hammers them all into the terminology of an Xbox 360 controller.

Showing users inputs on their controller using only the SDL DB is a poor and messy experience for users and developers alike.

What if we had a free database of what controllers look like, in addition to how they're shaped and interfaced with?

More info and contributing

Currently defined controllers

Buttons with a green underline are the conventional "accept" button. Buttons with a red underline are the conventional "back" or "cancel" button.
Controller Primary Cluster Shoulder Trigger D-Pad Sticks Meta
South
(A)
East
(B)
West
(X)
North
(Y)
Left Right Left Right Up Down Left Right Left Right Back Guide Start
ASUS Gamepad
A
B
X
Y
LB
RB
LT
RT
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
LS
RS
Nintendo GameCube Controller
A
X
B
Y
Z
L
R
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
Control Stick
C
Start
Hyperkin Duke
A
B
X
Y
White
Black
LT
RT
LS
RS
Xbox
Nintendo Switch Joy-Con
B
A
Y
X
L
R
ZL
ZR
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
L
R
-
Home
+
Nintendo Switch Pro Controller
B
A
Y
X
L
R
ZL
ZR
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
L
R
-
Home
+
PlayStation 3 Controller
L1
R1
L2
R2
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
L3
R3
PS
PlayStation 4 Controller
L1
R1
L2
R2
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
L3
R3
Share
PS
Options
PlayStation 5 Controller
L1
R1
L2
R2
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
L3
R3
🗤
PS
Sega Saturn Digital Pad
A
B
X
Y
Z
C
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
Start
Steam Deck
A
B
X
Y
L1
R1
L2
R2
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
L3
R3
STEAM
Xbox 360 Controller
A
B
X
Y
LB
RB
LT
RT
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
LS
RS
Guide
Xbox One Controller
A
B
X
Y
LB
RB
LT
RT
D-Pad Up
D-Pad Down
D-Pad Left
D-Pad Right
LS
RS
Xbox

Default colors

Name Background Foreground
red
#D32F2F
#EF9A9A
pink
#E91E63
#F06292
purple
#9C27B0
#BA68C8
blue
#3F51B5
#4FC3F7
cyan
#00BCD4
#4DD0E1
teal
#009688
#4DB6AC
green
#388E3C
#81C784
lime
#8BC34A
#D4E157
yellow
#FDD835
#FFF176
orange
#FF9800
#FFB74D
brown
#795548
#A1887F
white
#E0E0E0
#FAFAFA
black
#212121
#424242
gray
#607D8B
#263238

Currently defined shapes and icons

Name Suggested
Appearance
arrow_down
arrow_left
arrow_right
arrow_up
bean_left
box
bumper_left
bumper_right
circle
circle_cluster_down
circle_cluster_left
circle_cluster_right
circle_cluster_up
circle_medium
circle_outline
cross
dpad_cross_down
dpad_cross_left
dpad_cross_right
dpad_cross_up
dpad_inward_down
dpad_inward_left
dpad_inward_right
dpad_inward_up
home
long_triangle_right
lozenge_curved_horizontal
lozenge_curved_vertical
lozenge_horizontal
lozenge_vertical
menu
minus
pill
playstation
plus
power
radiate
rectangle_horizontal
skip_next
skip_prev
square
stick_down
triangle
triangle_down
triangle_left
triangle_right
triangle_up
trigger_left
trigger_right
view
xbox
xbox_original

Icons by Material Design Icons