Make sure that pygame is at least version 2.0
Download GuiPad.py and run it with python.
OR
Use pip install GuiPad
in your Operating System terminal, then in a python terminal or script:
import GuiPad
GuiPad.GuiPad()
https://pypi.org/project/GuiPad/
Linux desktops based on Wayland (piOS as of 10-10-2023, Debian 12.0+/Bookworm, etc) are not currently supported.
A settings.ini file can be used in Guipad.Guipad("PathToSettings.ini") for additional customisation.
Generate a standard settings file using:
import os
import GuiPad
Make_In_Directory = os.path.join("C:\\Users","JackLawrenceCRISPR","Desktop","Folder") #put your own deployment directory!
GuiPad.MakeGuiPadini(Make_In_Directory, "GuiPad.ini") #you can also choose a custom name
Edit the .ini file to your preference then provide
Path = os.path.join("C:\Users","JackLawrenceCRISPR","Desktop","Folder","GuiPad.ini") in your GuiPad.GuiPad(Path)
Input | Output | Effect |
---|---|---|
Left joystick | Mouse | Move cursor |
Right trigger | Slow Mouse | Slow movment |
Right joystick | Arrow Keys | Page Scrolling / Time & Sound (videos) |
A Button | Left click | Normal click |
B Button | Right click | Right click |
X Button | Double click | Open file / select a word in text |
Y Button | Middle click | Open link in new tab |
D-Pad up | Ctrl + + | Zoom in |
D-Pad down | Ctrl + - | Zoom out |
D-Pad right | Ctrl + T | New tab |
D-Pad left | Ctrl + W | Close window |
Left shoulder | Ctrl + Shift + Tab | Next tab |
Right shoulder | Ctrl + Tab | Previous tab |
Left stick | Alt + Left | Go back |
Right stick | Alt + Right | Go forward |
Select button | Ctrl + C | Copy |
Start button | Ctrl + V | Paste |
Middle button | Enter | Apply |
Different gamepad types combined with different operating systems/drivers can cause button mapping inconsistencies.
Manually set your map if the shoulder and stick buttons on your gamepad are misaligned with the table above.
For example, a gamepad called "Controller (HORIPAD S)" could use the "xbox_windows" map which would be applied as:
GuiPad.MapGamepad("Controller (HORIPAD S)","xbox_windows")
The following command will provide further guidance for button mapping:
import GuiPad
GuiPad.MapGamepad()