qingpi-python 0.1.10

Python library for Qingpi.

qingpi-python

Python library for Qingpi.

$ pip install qingpi-python

qingpictl

GUI application to control Qingpi with transparent Window and Citra compatible keyboard operation.

Currently, only Windows version is available.

Run

$ qingpictl [port]

or

$ python -m qingpi [port]

or using pre-built binary

> qingpictl.exe [port]

You may create batch file like this if you don't want to specify the port from the command line every time.

START qingpictl.exe COM6

Input mapping

Button

Control	Input
A	A
B	S
X	Z
Y	X
L	Q
R	W
ZL	1
ZR	2
START	M
SELECT	N
HOME	B
POWER	V
WIRELESS	P

Hat

Control	Input
UP	T
RIGHT	H
DOWN	G
LEFT	F

SlidePad

Control	Input
UP	<Up>
RIGHT	<Right>
DOWN	<Down>
LEFT	<Left>

Circle Pad Pro (not implemented)

Control	Input
UP	I
RIGHT	L
DOWN	K
LEFT	J

Hotkeys

Control	Input
Expand window	+
Shrink window	-

Developer note

$ poetry run python -m qingpi [port] --debug

The build script requires PyInstaller and ImageMagick.

$ poetry run python -m pip install pyinstaller
$ make

PyInstaller is not included in the dev group because PyInstaller has a narrower Python version specification than necessary (e.g. v6.3.0 requires "<3.13,>=3.8"), which affects version reqirements of qingpi-python.

To avoid security issues,

$ poetry run python -m pip uninstall pyinstaller
$ git clone https://github.com/pyinstaller/pyinstaller --depth 1
$ cd .\pyinstaller\bootloader\
$ py .\waf distclean all
$ cd ..\..\
$ poetry run python -m pip install .\pyinstaller\