AlphaWindow kmbox Plugin
Generic kmbox recording input plugin for AlphaWindow.
The plugin registers the kmbox recording input method through the
alphawindow.plugins entry point. It records kmbox mouse movement as
AlphaWindow mouse_delta labels and leaves the target window selection to
AlphaWindow itself.
It also registers a kmbox replay input method for AlphaWindow versions that
expose plugin input methods as replay outputs. This replays recorded
mouse_delta labels through the kmbox hardware instead of the foreground mouse
or Win32 input backends.
Device Type Detection
The plugin supports device_type=auto, hid, and kmbox_a.
auto probes the notify-capable HID kmbox first, then probes kmboxA through the
optional kmA Python extension. HID devices support recording input capture.
The stock kmA modules bundled with the reference kmboxA package can be used
for connection detection. An enhanced kmA binding that exposes
read_mouse_delta(timeout_ms) is required for kmboxA recorder input capture;
see native/.
The status probe does not enable mouse lock or notify capture:
python -c "from alphawindow_kmbox import kmbox_connection_status; print(kmbox_connection_status())"
AlphaWindow can also surface this probe through plugin status metadata.
Development
python -m pip install -e .[test]
pytest -q
Local tests use ../AlphaWindow-Python/src so this project can be developed
against the adjacent AlphaWindow checkout while the recording input plugin
protocol is being integrated.
License
MIT
Publishing
Publishing is handled by .github/workflows/publish.yml.
- Push a
v*tag, or run the workflow manually from GitHub Actions. - Set the repository secret
PYPI_API_TOKENto a PyPI API token. - The workflow runs tests, builds the package, checks the distribution metadata, and uploads the artifacts to PyPI.
Metadata
Release files for alphawindow-kmbox 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| alphawindow_kmbox-0.1.1.tar.gz | 18.6 kB | Without provenance | Details for alphawindow_kmbox-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| alphawindow_kmbox-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for alphawindow_kmbox-0.1.1-py3-none-any.whl |
Total release size: 28.6 kB
Release files / alphawindow_kmbox-0.1.1.tar.gz
| Download URL | alphawindow_kmbox-0.1.1.tar.gz |
|---|---|
| Size | 18.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d658967b60003f228f8a23a527cda54dc04f6c58f6fae3f29bb5c616e52c471a
|
|
BLAKE2b-256 checksum How to use checksums |
fdfd38f99e5bca76122bdc077a31ee2887238793cc7e3ff0ed1ddfe4c931da5b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / alphawindow_kmbox-0.1.1-py3-none-any.whl
| Download URL | alphawindow_kmbox-0.1.1-py3-none-any.whl |
|---|---|
| Size | 10.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75e17e6ba516f874f5437639409ecfa839ce9f48c2d2a13e6ce8351557734349
|
|
BLAKE2b-256 checksum How to use checksums |
1245b98564dc69a0e8c4a5a66e4059cc14e7c266af94777d655730303fa2609e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Security for alphawindow-kmbox 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.