+
+
Controllers
{controllerCount > 0 && (
-
+
{controllerCount} detected
)}
-
-
- Detected game controllers, joysticks, and gamepads connected to this system.
- Copy SDL mappings for per-game controller configuration.
-
+
+
+ Joysticks and gamepads detected by the kernel. Test inputs live,
+ copy SDL mappings, and link to per-game configuration tools.
+
Re-scan connected controllers
@@ -118,258 +352,712 @@ export default function ControllersPage() {
{/* Loading state */}
{isLoading ? (
-
+
{Array.from({ length: 3 }).map((_, i) => (
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
-
-
-
+
+
))}
-
- /* Error state */
) : error ? (
Failed to detect controllers
- Check that the backend is running and /proc/bus/input/devices or /dev/input/js* is accessible, then try refreshing.
+ Check that the backend is running and{" "}
+
+ /proc/bus/input/devices
+ {" "}
+ or{" "}
+ /dev/input/js*{" "}
+ is accessible, then try refreshing.
-
- /* Empty state */
- ) : !controllers || controllerCount === 0 ? (
-
-
-
-
-
-
-
- No game controllers detected
-
-
- Connect a controller via USB or Bluetooth and press refresh to re-scan.
- Devices are detected from /proc/bus/input and /dev/input/js*.
-
-
+ ) : controllerCount === 0 ? (
+
+
+
+
+
+ No game controllers detected
+
+ Connect a controller via USB or Bluetooth and press refresh to
+ re-scan. Devices are detected from{" "}
+
+ /proc/bus/input
+ {" "}
+ and{" "}
+ /dev/input/js*
+ .
+
+
+
-
+
+
+ )}
- {/* SDL usage guide */}
-
+ {/* Per-controller cards */}
+ {filtered.length === 0 ? (
+
+
+
+
+
+ No matches
+
+ Adjust the filters or clear the search to see all detected
+ controllers.
+
+
+
+ ) : (
-
-
- SDL mappings let games recognize your controller with the correct button layout.
- The generated mapping provides a standard Xbox-style layout as a starting point.
-
-
-
+ {`# Append the full mapping line (one per controller) to:\n~/.config/SDL_GameControllerDB.txt`}
+
+
+
+
{/* Info footer */}
-
-
-
-
+
+
+
+
Controllers are detected from{" "}
- /proc/bus/input/devices{" "}
- (handler list) with a fallback to{" "}
- /dev/input/js*{" "}
- device nodes. Type classification is based on vendor name matching.
- The SDL mapping uses a standard Xbox-style button layout — for full
- calibration, use{" "}
- SDL2 Gamepad Tool or{" "}
- AntiMicroX.
-
-
-
+
+ /proc/bus/input/devices
+ {" "}
+ with a fallback to{" "}
+
+ /dev/input/js*
+
+ . Type classification is based on vendor name matching. The
+ generated SDL mapping uses a standard Xbox-style button
+ layout — for full per-axis calibration use the SDL2 Gamepad
+ Tool, AntiMicroX, or{" "}
+
+ sdl2-jstest
+ {" "}
+ above. Live input testing uses the browser's W3C Gamepad
+ API which only exposes a controller after the first input.
+
+
+
)}
- Variables set here are written to{" "}
-
- ~/.config/environment.d/70-protonshift.conf
- {" "}
- and loaded by systemd on login. They apply to{" "}
-
- every application
- {" "}
- in your session — Steam, Lutris, Heroic, and terminal-launched
- games all inherit them.
-
-
- Changes take effect after your next{" "}
-
- logout and login
-
- . Per-game overrides can be set in Steam's launch options
- or in the Games page.
-
+
+
+
+
+
+
+ Variables set here are written to{" "}
+
+ {ENV_FILE_PATH}
+ {" "}
+ and loaded by systemd on login. They apply to{" "}
+
+ every application
+ {" "}
+ in your session — Steam, Lutris, Heroic, and terminal-launched
+ games all inherit them.
+
+
+ Changes take effect after your next{" "}
+
+ logout and login
+
+ . Per-game overrides can be set in Steam's launch options
+ or in the Games page.
+
+
- MangoHud is a Vulkan/OpenGL overlay that shows FPS, GPU/CPU usage, temperatures, frame timing, and more. It's the go-to performance overlay for Linux gaming.
-
+
+
+ MangoHud
+
+
+ Vulkan/OpenGL overlay for FPS, GPU/CPU usage, temperatures, and
+ frame timing.
+
+
+
+
+
+
+
+ MangoHud
+
+ Not installed
+
+
+
+
+
+ MangoHud is the go-to performance overlay for Linux gaming. Once
+ installed, restart this app to detect it.
+
+
+
- MangoHud loads ~/.config/MangoHud/wine-<name>.conf for
- Wine games—often <name> matches the game{" "}
- .exe stem (e.g.{" "}
- eldenring). For Steam we suggest the library{" "}
- install folder name; for Heroic/Lutris the game
- title. Edit the field if your overlay still doesn't load. You can also set{" "}
- MANGOHUD_CONFIGFILE=~/.config/MangoHud/wine-…conf in launch
- options.
-