ZXTouch-Python-Client

A generic zxtouch python client for Windows/Mac/Linux for keyboard gaming (CoDm, PUBG, etc...)

If this helped you out, Buy me a coffee here

Description

Linked and dependant on this project... https://github.com/xuan32546/IOS13-SimulateTouch

This is a client that maps keyboard/mouse functionality for any game. You will need to modify coordinates config.json file for your specific game, but out of the box this will support CoDm on iPhone11 with the attached layout.

Features

• Functional resolution coordinate mapping and realtime plotting (via debug mode).
• Screen input locking (FPS).
• Importable screenshot of actual layout for button mapping (similar to ZXTouch.net site).
• Automatic screen size calculations (based on uploaded image size).
• Set a custom window resolution for your computer monitor (which is different than your iDevice).
• No need to login to a website to run coordinate as this is stored locally to the script.
• Buttons are already mapped and working for iPhone XR/11 (1792x828) resolution (see screenshot for working mappings).
• Button programming and joystick centering mode available for your custom layout.
• Fully working on OSX Big Sur, also tested on some windows platforms.
• Will likely need to input device IP (127.0.0.1 did not work for me).

Usage

1. Change into the ZXTouch Client directory.

cd /path/to/ZXtouch-CoDm-Client/

2. Install python dependencies.

pip install -r requirements.txt

3. Make a new config file using the template provided

cd /path/to/ZXtouch-CoDm-Client/
cp config.json.example config.json

4. Launch the program via a terminal or cmd window (you can exclude the IP if connected via USB to Windows w/ Itunes installed "127.0.0.1" will be used)

python3 main.py <IP Address of device>

5. A popup window will allow then allow you to verify/enter an IP address and also set a custom window resolution (if you computer res is lower than your iDevice)

6. A file browser box will pop up the first time you run the script asking for a screen shot of you game button layout (ensure this is a non compressed image), select the file and click "submit".

How to set keys

Map Keys

1. Press k to enter key programming mode (when you press k all current mapping locations will print to the image).
2. Press the key you want to program, then click the left mouse button once on the location for the key.
3. Confirmation of the programmed key will be signified by a blue dot and the key next to it on the background image and shown in the console output.
4. Press another key you want to program and follow steps 2-3 again or press k again to exit key programming mode.

Map Joystick Center

1. Press j to enter joystick programming mode.
2. The center of the joystick will already be selected so all you need to do is click the left mouse button in the center of your games joystick location.
3. Confirmation of joystick center will be signified by a blue dot and J_CENTER on the background image and shown in the console output.
4. Press j again to exit key programming mode.

FAQ

I see major lag when I lock input to the window ("l").

This can be caused by a high polling rate and DPI configuration on your mouse, if you have a gaming mouse/keyboard setup, try to lower the polling rate to 125 (8ms) and DPI ~900.

How do I delete keys?

I will add a way to delete keys, but for now you can manage the keys manually in the config.json file.

When I rotate my screen the button mappings are wrong.

Currently the script does not account for flipped or rotated landscape orientation, you will need to keep it oriented in one direction until I update the script to allow for rotation.

I have issues installing package "uvloop" on windows.

This package is not required, but on systems that support it this will provide a performance gain in CPU tasks making the process smoother.

Feature Requests

• Map the same button to multiple coordinates

• Support any landscape rotation

• Add ability to delete keys

• Support custom FPS center and aim movement without having to modify the config.json file.