Skip to content

A simple module to use your gamepad as a mouse with pygame and PyAutoGUI.

License

Notifications You must be signed in to change notification settings

JackLawrenceCRISPR/GuiPad

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 

Repository files navigation

GuiPad

Use your gamepad as a mouse with pygame and PyAutoGUI.

Installation

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.

Configuration

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)

Controls

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

Button Mapping

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()

About

A simple module to use your gamepad as a mouse with pygame and PyAutoGUI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages