QTS3native 0.1.1__tar.gz

qts3native-0.1.1/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 l-S4M-l
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qts3native-0.1.1/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: QTS3native
+Version: 0.1.1
+Summary: PyQt menu, key listener, and RPCS3 hook helpers for Skate 3 native tooling
+Author: S4M
+License: MIT
+Project-URL: Homepage, https://github.com/l-S4M-l/QTS3native
+Project-URL: Bug Tracker, https://github.com/l-S4M-l/QTS3native/issues
+Project-URL: Ko-fi, https://ko-fi.com/chillsam2
+Keywords: rpcs3,skate3,pyqt,modding,pymem
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENCE
+Requires-Dist: PyQt5
+Requires-Dist: keyboard
+Requires-Dist: pymem
+Requires-Dist: clipboard
+Dynamic: license-file
+
+# QTS3native
+
+QTS3native is a Python library for building Skate 3 native-style menus and input-driven tooling on top of RPCS3.
+
+It bundles three main parts:
+
+- a PyQt-based menu and UI system
+- an RPCS3 controller and memory hook layer
+- a global keyboard listener for menu input and text entry
+
+The library is aimed at Windows-based Skate 3 tooling where you want a native-feeling in-game style menu driven by controller input, keyboard input, or both.
+
+## Features
+
+- PyQt menu item system with buttons, toggles, sliders, option items, labels, and typing items
+- controller polling thread for reading Skate 3 / RPCS3 input values
+- bind handler for opening or triggering menu actions from controller input
+- global keyboard listener for typing and keyboard-driven interactions
+- internal Skate 3 menu text writer for rendering menu text into RPCS3 memory
+- AOB scan helper for searching memory regions
+
+## Modules
+
+### `qtElements.py`
+
+Contains the main menu and UI logic, including:
+
+- `menu_controller`
+- `sub_menu`
+- menu item classes
+- `bind_handler`
+- controller-to-menu input routing
+
+### `rpcs3Hooks.py`
+
+Contains the RPCS3-side helpers, including:
+
+- `Controller`
+- `ControllerThread`
+- `skate_3_internal_menu_controller`
+
+This module reads controller state from RPCS3 memory, applies deadzones, and exposes the values to the menu system. It also writes menu text into the Skate 3 internal menu text area and includes an AOB scanning helper.
+
+### `keylistener.py`
+
+Contains the global keyboard listener used for keyboard input, text entry, and menu interaction.
+
+## Requirements
+
+- Python 3.10+
+- Windows
+- RPCS3 running
+- Skate 3 running in RPCS3
+- permission to read and write process memory
+
+## Dependencies
+
+- `PyQt5`
+- `pymem`
+- `clipboard`
+- `keyboard`
+
+## Install
+
+```bash
+pip install QTS3native
+```

qts3native-0.1.1/README.md

@@ -0,0 +1,67 @@
+# QTS3native
+
+QTS3native is a Python library for building Skate 3 native-style menus and input-driven tooling on top of RPCS3.
+
+It bundles three main parts:
+
+- a PyQt-based menu and UI system
+- an RPCS3 controller and memory hook layer
+- a global keyboard listener for menu input and text entry
+
+The library is aimed at Windows-based Skate 3 tooling where you want a native-feeling in-game style menu driven by controller input, keyboard input, or both.
+
+## Features
+
+- PyQt menu item system with buttons, toggles, sliders, option items, labels, and typing items
+- controller polling thread for reading Skate 3 / RPCS3 input values
+- bind handler for opening or triggering menu actions from controller input
+- global keyboard listener for typing and keyboard-driven interactions
+- internal Skate 3 menu text writer for rendering menu text into RPCS3 memory
+- AOB scan helper for searching memory regions
+
+## Modules
+
+### `qtElements.py`
+
+Contains the main menu and UI logic, including:
+
+- `menu_controller`
+- `sub_menu`
+- menu item classes
+- `bind_handler`
+- controller-to-menu input routing
+
+### `rpcs3Hooks.py`
+
+Contains the RPCS3-side helpers, including:
+
+- `Controller`
+- `ControllerThread`
+- `skate_3_internal_menu_controller`
+
+This module reads controller state from RPCS3 memory, applies deadzones, and exposes the values to the menu system. It also writes menu text into the Skate 3 internal menu text area and includes an AOB scanning helper.
+
+### `keylistener.py`
+
+Contains the global keyboard listener used for keyboard input, text entry, and menu interaction.
+
+## Requirements
+
+- Python 3.10+
+- Windows
+- RPCS3 running
+- Skate 3 running in RPCS3
+- permission to read and write process memory
+
+## Dependencies
+
+- `PyQt5`
+- `pymem`
+- `clipboard`
+- `keyboard`
+
+## Install
+
+```bash
+pip install QTS3native
+```

qts3native-0.1.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "QTS3native"
+version = "0.1.1"
+description = "PyQt menu, key listener, and RPCS3 hook helpers for Skate 3 native tooling"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+  { name = "S4M" }
+]
+keywords = ["rpcs3", "skate3", "pyqt", "modding", "pymem"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: Microsoft :: Windows",
+]
+
+dependencies = [
+  "PyQt5",
+  "keyboard",
+  "pymem",
+  "clipboard"
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.urls]
+Homepage = "https://github.com/l-S4M-l/QTS3native"
+"Bug Tracker" = "https://github.com/l-S4M-l/QTS3native/issues"
+Ko-fi = "https://ko-fi.com/chillsam2"

qts3native-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

qts3native-0.1.1/src/QTS3native/__init__.py

@@ -0,0 +1,5 @@
+from .qtElements import *
+from .rpcs3Hooks import *
+from .keylistener import *
+
+__version__ = "0.1.1"

qts3native-0.1.1/src/QTS3native/keylistener.py

@@ -0,0 +1,236 @@
+import keyboard
+from PyQt5 import QtCore
+
+
+class GlobalKeyboardListener(QtCore.QThread):
+    keys_pressed = QtCore.pyqtSignal(tuple)
+
+    NON_SYMBOL_KEYS = [
+        "BACKSPACE",
+        "TAB",
+        "ENTER",
+        "SHIFT",
+        "CTRL",
+        "ALT",
+        "ALT_GR",
+        "PAUSE",
+        "CAPSLOCK",
+        "ESCAPE",
+        "SPACE",
+        "PAGE_UP",
+        "PAGE_DOWN",
+        "END",
+        "HOME",
+        "LEFT",
+        "UP",
+        "RIGHT",
+        "DOWN",
+        "INSERT",
+        "DELETE",
+        "PRINT_SCREEN",
+        "SCROLLLOCK",
+        "NUMLOCK",
+        "LWIN",
+        "RWIN",
+        "MENU",
+        "APPS",
+        "CLEAR",
+        "HELP",
+        "SELECT",
+        "EXECUTE",
+        "SLEEP",
+        "DECIMAL",
+        "SEPARATOR",
+        "SUBTRACT",
+        "ADD",
+        "MULTIPLY",
+        "DIVIDE",
+        "NUMPAD_0",
+        "NUMPAD_1",
+        "NUMPAD_2",
+        "NUMPAD_3",
+        "NUMPAD_4",
+        "NUMPAD_5",
+        "NUMPAD_6",
+        "NUMPAD_7",
+        "NUMPAD_8",
+        "NUMPAD_9",
+        "F1",
+        "F2",
+        "F3",
+        "F4",
+        "F5",
+        "F6",
+        "F7",
+        "F8",
+        "F9",
+        "F10",
+        "F11",
+        "F12",
+        "F13",
+        "F14",
+        "F15",
+        "F16",
+        "F17",
+        "F18",
+        "F19",
+        "F20",
+        "F21",
+        "F22",
+        "F23",
+        "F24",
+        "MEDIA_PLAY_PAUSE",
+        "MEDIA_STOP",
+        "MEDIA_NEXT_TRACK",
+        "MEDIA_PREV_TRACK",
+        "VOLUME_UP",
+        "VOLUME_DOWN",
+        "VOLUME_MUTE",
+        "BROWSER_BACK",
+        "BROWSER_FORWARD",
+        "BROWSER_REFRESH",
+        "BROWSER_STOP",
+        "BROWSER_SEARCH",
+        "BROWSER_FAVORITES",
+        "BROWSER_HOME",
+        "LAUNCH_MAIL",
+        "LAUNCH_MEDIA_SELECT",
+        "LAUNCH_APP1",
+        "LAUNCH_APP2",
+    ]
+
+    MODIFIER_KEYS = {"CTRL", "ALT", "SHIFT", "ALT_GR"}
+    MODIFIER_ORDER = {
+        "CTRL": 0,
+        "ALT": 1,
+        "ALT_GR": 2,
+        "SHIFT": 3,
+    }
+
+    KEY_NAME_MAP = {
+        "backspace": "BACKSPACE",
+        "tab": "TAB",
+        "enter": "ENTER",
+        "return": "ENTER",
+        "shift": "SHIFT",
+        "left shift": "SHIFT",
+        "right shift": "SHIFT",
+        "ctrl": "CTRL",
+        "left ctrl": "CTRL",
+        "right ctrl": "CTRL",
+        "alt": "ALT",
+        "left alt": "ALT",
+        "right alt": "ALT",
+        "alt gr": "ALT_GR",
+        "pause": "PAUSE",
+        "caps lock": "CAPSLOCK",
+        "esc": "ESCAPE",
+        "escape": "ESCAPE",
+        "space": "SPACE",
+        "page up": "PAGE_UP",
+        "page down": "PAGE_DOWN",
+        "end": "END",
+        "home": "HOME",
+        "left": "LEFT",
+        "up": "UP",
+        "right": "RIGHT",
+        "down": "DOWN",
+        "insert": "INSERT",
+        "delete": "DELETE",
+        "print screen": "PRINT_SCREEN",
+        "scroll lock": "SCROLLLOCK",
+        "num lock": "NUMLOCK",
+        "windows": "LWIN",
+        "left windows": "LWIN",
+        "right windows": "RWIN",
+        "menu": "MENU",
+        "apps": "APPS",
+        "decimal": "DECIMAL",
+        "separator": "SEPARATOR",
+        "subtract": "SUBTRACT",
+        "add": "ADD",
+        "multiply": "MULTIPLY",
+        "divide": "DIVIDE",
+        "play/pause media": "MEDIA_PLAY_PAUSE",
+        "stop media": "MEDIA_STOP",
+        "next track": "MEDIA_NEXT_TRACK",
+        "previous track": "MEDIA_PREV_TRACK",
+        "volume up": "VOLUME_UP",
+        "volume down": "VOLUME_DOWN",
+        "volume mute": "VOLUME_MUTE",
+        "browser back": "BROWSER_BACK",
+        "browser forward": "BROWSER_FORWARD",
+        "browser refresh": "BROWSER_REFRESH",
+        "browser stop": "BROWSER_STOP",
+        "browser search": "BROWSER_SEARCH",
+        "browser favorites": "BROWSER_FAVORITES",
+        "browser home": "BROWSER_HOME",
+        "launch mail": "LAUNCH_MAIL",
+        "launch media select": "LAUNCH_MEDIA_SELECT",
+        "launch app 1": "LAUNCH_APP1",
+        "launch app 2": "LAUNCH_APP2",
+    }
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self._pressed_keys = set()
+        self._hook = None
+        self._running = False
+
+    def normalise_key_name(self, key_name):
+        if key_name is None:
+            return None
+
+        key_name = str(key_name).strip().lower()
+
+        if key_name in self.KEY_NAME_MAP:
+            return self.KEY_NAME_MAP[key_name]
+
+        if key_name.startswith("numpad "):
+            suffix = key_name.replace("numpad ", "")
+            if suffix.isdigit():
+                return f"NUMPAD_{suffix}"
+
+        if key_name.startswith("f") and key_name[1:].isdigit():
+            return key_name.upper()
+
+        if len(key_name) == 1:
+            return key_name
+
+        return key_name.upper().replace(" ", "_")
+
+    def build_key_tuple(self, current_key):
+        held_modifiers = [key for key in self._pressed_keys if key in self.MODIFIER_KEYS]
+        held_modifiers.sort(key=lambda key: self.MODIFIER_ORDER.get(key, 999))
+
+        if current_key in self.MODIFIER_KEYS:
+            return tuple(held_modifiers)
+
+        return tuple(held_modifiers + [current_key])
+
+    def _keyboard_callback(self, event):
+        key_name = self.normalise_key_name(event.name)
+        if key_name is None:
+            return
+
+        if event.event_type == "down":
+            self._pressed_keys.add(key_name)
+            self.keys_pressed.emit(self.build_key_tuple(key_name))
+
+        elif event.event_type == "up":
+            self._pressed_keys.discard(key_name)
+
+    def run(self):
+        self._running = True
+        self._hook = keyboard.hook(self._keyboard_callback)
+
+        while self._running:
+            self.msleep(10)
+
+        if self._hook is not None:
+            keyboard.unhook(self._hook)
+            self._hook = None
+
+    def stop(self):
+        self._running = False
+        self.wait()