Skip to main content

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_TOKEN to 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)

Source distribution for alphawindow-kmbox 0.1.1
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)

Table of built distributions (wheels) for alphawindow-kmbox 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page