symbols.json

{
	"colors": {
		"_comment": "The first entry in the array is the color when this is used as a bg - the second is the color when used as an fg. These are only suggestions, games are free to replace these",
		"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"]
	},
	"buttons": {
		"_comment": [
			"These describe the various kinds of buttons found on controllers in the database.",
			"shape is the shape of the button itself",
			"icon (may be absent) is the symbolic name of the button's legend",
			"text is a best-effort Unicode representation of the legend",
			"text_basic (may be absent if text is all ASCII) is a best effort ASCII representation of the legend",
			"shape_is_button is defined and true if the shape is itself the button, and an additional icon or text would be redundant.",
			"The idea is a new button of an old shape can be drawn by games using the database even without explicit support by invoking a text renderer with Unicode support."
		],

		"_comment": "First up, the Xbox 360 style buttons native to the SDL controller DB.",
		"A": {
			"shape": "circle",
			"text": "A"
		},
		"B": {
			"shape": "circle",
			"text": "B"
		},
		"X": {
			"shape": "circle",
			"text": "X"
		},
		"Y": {
			"shape": "circle",
			"text": "Y"
		},
		"LS": {
			"shape": "circle",
			"text": "LS"
		},
		"RS": {
			"shape": "circle",
			"text": "RS"
		},
		"LB": {
			"shape": "bumper_left",
			"text": "LB"
		},
		"RB": {
			"shape": "bumper_right",
			"text": "RB"
		},
		"LT": {
			"shape": "trigger_left",
			"text": "LT"
		},
		"RT": {
			"shape": "trigger_right",
			"text": "RT"
		},
		"xb_guide": {
			"shape": "circle",
			"icon": "xbox",
			"text": "Guide"
		},
		"xbox": {
			"shape": "circle",
			"icon": "xbox",
			"text": "Xbox"
		},
		"xb_back": {
			"shape": "pill",
			"icon": "triangle_left",
			"text": "◀",
			"text_basic": "Back"
		},
		"xb_start": {
			"shape": "pill",
			"icon": "triangle_right",
			"text": "▶",
			"text_basic": "Start"
		},
		"xb_view": {
			"shape": "circle",
			"icon": "view",
			"text": "⧉",
			"text_basic": "View"
		},
		"xb_menu": {
			"shape": "circle",
			"icon": "menu",
			"text": "≡",
			"text_basic": "Menu"
		},

		"_comment": "More generic letter buttons",
		"Z": {
			"shape": "circle",
			"text": "Z"
		},
		"C": {
			"shape": "circle",
			"text": "C"
		},

		"_comment": "PlayStation buttons",
		"L3": {
			"shape": "circle",
			"text": "L3"
		},
		"R3": {
			"shape": "circle",
			"text": "R3"
		},
		"L1": {
			"shape": "bumper_left",
			"text": "L1"
		},
		"R1": {
			"shape": "bumper_right",
			"text": "R1"
		},
		"L2": {
			"shape": "trigger_left",
			"text": "L2"
		},
		"R2": {
			"shape": "trigger_right",
			"text": "R2"
		},
		"PS": {
			"shape": "circle",
			"icon": "playstation",
			"text": "PS"
		},
		"ps5_PS": {
			"shape": "playstation",
			"shape_is_button": true,
			"text": "PS"
		},
		"ps4_share": {
			"shape": "lozenge_vertical",
			"text": "Share"
		},
		"ps4_options": {
			"shape": "lozenge_vertical",
			"text": "Options"
		},
		"ps5_create": {
			"shape": "lozenge_vertical",
			"icon": "radiate",
			"text": "🗤",
			"text_basic": "Create"
		},
		"ps5_options": {
			"shape": "lozenge_vertical",
			"icon": "menu",
			"text": "≡",
			"text_basic": "Options"
		},

		"_comment": "Original Xbox (Xbox Zero, xb0, because Microsoft reused 'Xbox One')",
		"xb0_A": {
			"shape": "bean_left",
			"text": "A"
		},
		"xb0_B": {
			"shape": "bean_left",
			"text": "B"
		},
		"xb0_X": {
			"shape": "bean_left",
			"text": "X"
		},
		"xb0_Y": {
			"shape": "bean_left",
			"text": "Y"
		},
		"xb0_black": {
			"shape": "bean_left",
			"shape_is_button": true,
			"text": "Black"
		},
		"xb0_white": {
			"shape": "bean_left",
			"shape_is_button": true,
			"text": "White"
		},
		"xb0_jewel": {
			"shape": "circle",
			"icon": "xbox_original",
			"text": "Xbox"
		},
		"_comment": "Pill-shaped Xbox One view/menu buttons seen on the Hyperkin Duke original Xbox controller remake",
		"xb0_view": {
			"shape": "pill",
			"icon": "view",
			"text": "⧉",
			"text_basic": "View"
		},
		"xb0_menu": {
			"shape": "pill",
			"icon": "menu",
			"text": "≡",
			"text_basic": "Menu"
		},

		"_comment": "Nintendo naming of the sticks/shoulders",
		"nx_LS": {
			"shape": "stick_down",
			"text": "L"
		},
		"nx_RS": {
			"shape": "stick_down",
			"text": "R"
		},
		"nx_L": {
			"shape": "bumper_left",
			"text": "L"
		},
		"nx_R": {
			"shape": "bumper_right",
			"text": "R"
		},
		"nx_ZL": {
			"shape": "trigger_left",
			"text": "ZL"
		},
		"nx_ZR": {
			"shape": "trigger_right",
			"text": "ZR"
		},
		"minus": {
			"shape": "circle",
			"icon": "minus",
			"text": "-"
		},
		"plus": {
			"shape": "circle",
			"icon": "plus",
			"text": "+"
		},

		"_comment": "GameCube",
		"gcn_stick": {
			"shape": "circle",
			"shape_is_button": true,
			"text": "Control Stick"
		},
		"gcn_B": {
			"shape": "circle_medium",
			"text": "B"
		},
		"gcn_C": {
			"shape": "circle_medium",
			"text": "C"
		},
		"gcn_Y": {
			"shape": "lozenge_curved_horizontal",
			"text": "Y"
		},
		"gcn_X": {
			"shape": "lozenge_curved_vertical",
			"text": "X"
		},
		"gcn_Z": {
			"shape": "lozenge_horizontal",
			"text": "Z"
		},
		"gcn_start": {
			"shape": "circle_medium",
			"text": "Start"
		},
		"gcn_L": {
			"shape": "trigger_left",
			"text": "L"
		},
		"gcn_R": {
			"shape": "trigger_right",
			"text": "R"
		},

		"_comment": "Saturn stuff",
		"saturn_L": {
			"shape": "bumper_left",
			"icon": "skip_prev",
			"text": "⏮",
			"text_basic": "L"
		},
		"saturn_R": {
			"shape": "bumper_right",
			"icon": "skip_next",
			"text": "⏭",
			"text_basic": "R"
		},
		"saturn_start": {
			"shape": "pill",
			"shape_is_button": true,
			"text": "Start"
		},

		"_comment": "Steamed Decks",
		"steam": {
			"shape": "lozenge_horizontal",
			"text": "STEAM"
		},
		"deck_view": {
			"shape": "lozenge_horizontal",
			"icon": "box",
			"text": "▪",
			"text_basic": "View"
		},
		"deck_options": {
			"shape": "lozenge_horizontal",
			"icon": "menu",
			"text": "≡",
			"text_basic": "Options"
		},

		"_comment": "Iconographic buttons seen on some generic controllers",
		"home": {
			"shape": "circle",
			"icon": "home",
			"text": "Home"
		},
		"power": {
			"shape": "circle",
			"icon": "power",
			"text": "⏻",
			"text_basic": "Power"
		},
		"arrow_up": {
			"shape": "circle",
			"icon": "arrow_up",
			"text": "↑",
			"text_basic": "Up Arrow"
		},
		"arrow_down": {
			"shape": "circle",
			"icon": "arrow_down",
			"text": "↓",
			"text_basic": "Down Arrow"
		},
		"arrow_left": {
			"shape": "circle",
			"icon": "arrow_left",
			"text": "←",
			"text_basic": "Left Arrow"
		},
		"arrow_right": {
			"shape": "circle",
			"icon": "arrow_right",
			"text": "→",
			"text_basic": "Right Arrow"
		},

		"_comment": "Geometric shapes that take up the entire button space, usually seen on PlayStation controllers",
		"triangle": {
			"shape": "circle",
			"icon": "triangle",
			"text": "△",
			"text_basic": "Triangle"
		},
		"square": {
			"shape": "circle",
			"icon": "square",
			"text": "□",
			"text_basic": "Square"
		},
		"circle": {
			"shape": "circle",
			"icon": "circle_outline",
			"text": "○",
			"text_basic": "Circle"
		},
		"cross": {
			"shape": "circle",
			"icon": "cross",
			"text": "⨯",
			"text_basic": "Cross"
		},

		"_comment": "Buttons that are themselves special shapes",
		"nx_minus": {
			"shape": "minus",
			"shape_is_button": true,
			"text": "-"
		},
		"nx_plus": {
			"shape": "plus",
			"shape_is_button": true,
			"text": "+"
		},
		"ps_start": {
			"shape": "long_triangle_right",
			"shape_is_button": true,
			"text": "►",
			"text_basic": "Start"
		},
		"ps_back": {
			"shape": "rectangle_horizontal",
			"shape_is_button": true,
			"text": "▬",
			"text_basic": "Back"
		},

		"_comment": "A D-Pad that looks similar to that on PlayStation controllers; four pointed rectangles pointing inward, creating an X shape between the buttons",
		"dpad_inward_up": {
			"shape": "dpad_inward_up",
			"shape_is_button": true,
			"text": "D-Pad Up"
		},
		"dpad_inward_down": {
			"shape": "dpad_inward_down",
			"shape_is_button": true,
			"text": "D-Pad Down"
		},
		"dpad_inward_left": {
			"shape": "dpad_inward_left",
			"shape_is_button": true,
			"text": "D-Pad Left"
		},
		"dpad_inward_right": {
			"shape": "dpad_inward_right",
			"shape_is_button": true,
			"text": "D-Pad Right"
		},

		"_comment": "A standard plus-shaped D-Pad",
		"dpad_cross_up": {
			"shape": "dpad_cross_up",
			"shape_is_button": true,
			"text": "D-Pad Up"
		},
		"dpad_cross_down": {
			"shape": "dpad_cross_down",
			"shape_is_button": true,
			"text": "D-Pad Down"
		},
		"dpad_cross_left": {
			"shape": "dpad_cross_left",
			"shape_is_button": true,
			"text": "D-Pad Left"
		},
		"dpad_cross_right": {
			"shape": "dpad_cross_right",
			"shape_is_button": true,
			"text": "D-Pad Right"
		},

		"_comment": "A D-Pad like that on Nintendo's Joy-Con, which is simply a cluster of four circular buttons",
		"dpad_circle_up": {
			"shape": "circle_cluster_up",
			"shape_is_button": true,
			"text": "D-Pad Up"
		},
		"dpad_circle_down": {
			"shape": "circle_cluster_down",
			"shape_is_button": true,
			"text": "D-Pad Down"
		},
		"dpad_circle_left": {
			"shape": "circle_cluster_left",
			"shape_is_button": true,
			"text": "D-Pad Left"
		},
		"dpad_circle_right": {
			"shape": "circle_cluster_right",
			"shape_is_button": true,
			"text": "D-Pad Right"
		},


		"_comment": "Generic directional buttons",
		"dpad_up": {
			"shape": "circle",
			"icon": "triangle_up",
			"text": "▲",
			"text_basic": "D-Pad Up"
		},
		"dpad_down": {
			"shape": "circle",
			"icon": "triangle_down",
			"text": "▼",
			"text_basic": "D-Pad Down"
		},
		"dpad_left": {
			"shape": "circle",
			"icon": "triangle_left",
			"text": "◀",
			"text_basic": "D-Pad Left"
		},
		"dpad_right": {
			"shape": "circle",
			"icon": "triangle_right",
			"text": "▶",
			"text_basic": "D-Pad Right"
		}
	}
}