todbot/hidpytoy

A GUI app for playing with HID devices, written in Python

HIDPyToy - A simple tool to play with USB HID devices

Written in Python3 with PyQt5 and built with fbs.

Download

Pre-build executables are available on the hidpytoy releases page for:

• Mac OS X
• Windows x64

Requirements

To install for development (until I get setup.py up):

git clone https://github.com/todbot/hidpytoy
cd hidpytoy

Windows

py -3.6 -m venv venv
.\venv\scripts\activate.ps1
pip install -r requirements.txt

Linux

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Running

Linux

fbs run

Hint: If you are running this from a non root user, run instead this command

fbspath=$(whereis fbs | cut -d ":" -f2)
sudo $fbspath run

Building

fbs freeze

UI Customisation

Requirements

1. Install Qt Designer from https://build-system.fman.io/qt-designer-download
2. Save .UI file and run

pyuic5 HIDToyWindow.ui -o HIDToyWindow.py

If you are working from another location

cp ~/Desktop/HIDToyWindow.ui src/main/python/ && pyuic5 src/main/python/HIDToyWindow.ui -o src/main/python/HIDToyWindow.py

Be sure to check fbs troubleshooting page

hidpytoy's Issues

Application doesn't work at all

I'm running Monterrey on an MBP 2015. The application launches and presents all the USB HID devices. After selecting a device and clicking Connect, it presents a dialog asking to give it permission on the System Preferences. After checking off HidPyToy, I see a connect error: open failed. I've tried all kinds of different variations.

ImportError: cannot import name 'ApplicationContext'

I got this error:

⇒  fbs run
Traceback (most recent call last):
  File "/Users/davidbourgeois/src/hidpytoy/src/main/python/main.py", line 6, in <module>
    from fbs_runtime.application_context import ApplicationContext
ImportError: cannot import name 'ApplicationContext'

and changed this to get it working:

diff --git a/src/main/python/main.py b/src/main/python/main.py
index ac8d203..c0496fd 100644
--- a/src/main/python/main.py
+++ b/src/main/python/main.py
@@ -3,7 +3,7 @@
 #   2019 Tod E. Kurt, todbot.com
 #

-from fbs_runtime.application_context import ApplicationContext
+from fbs_runtime.application_context.PyQt5 import ApplicationContext
 from PyQt5 import QtCore, uic, QtWidgets

 import sys

Why on earth is report size limited to 128?

I need to send a 154 bit report to my mouse. The thingamabob wont let me go past 128 on the UI. FEEEX plz