This release is a pre-release and may not be stable for production use.
PlatynUI Inspector
platynui-inspector is a small desktop app for looking at the UI tree that PlatynUI sees. Use it to explore windows and controls, inspect attributes, test what is visible to the accessibility backend, and briefly highlight selected elements on screen.
Install
uv tool install --prerelease allow platynui-inspector
Inside an existing virtual environment:
uv pip install --pre platynui-inspector
# or
pip install --pre platynui-inspector
Windows and Linux are the active targets. macOS packages currently contain stub backend support.
Run
platynui-inspector
The left side shows the desktop UI tree. Selecting an element shows its attributes on the right and, when bounds are available, highlights it on screen for a moment.
Rendering options
The inspector ships with both wgpu and glow renderers. wgpu is the default; glow can be useful in virtual machines or older graphics stacks.
Command-line options take precedence over environment variables:
platynui-inspector --renderer glow --glow-hardware-acceleration off
Equivalent environment variables:
PLATYNUI_INSPECTOR_RENDERER=glow
PLATYNUI_INSPECTOR_GLOW_HARDWARE_ACCELERATION=off
Supported renderer values are wgpu and glow. Supported glow hardware acceleration values are required, preferred, and off.
The glow hardware acceleration setting applies to the glow renderer only. When glow is selected, off is treated as a best-effort request. Some Windows systems do not expose a software-only OpenGL configuration, so the inspector falls back to preferred instead of failing during window creation.
The wgpu renderer does not use the glow hardware acceleration setting. It can be influenced through the environment variables supported by wgpu itself:
WGPU_POWER_PREF=low # low, high, or none
WGPU_BACKEND=dx12 # comma-separated: dx12, vulkan, gl, metal
WGPU_POWER_PREF changes adapter preference, such as low-power versus high-performance devices. WGPU_BACKEND limits which graphics backends wgpu may try. These settings do not force pure software rendering, but they are useful when diagnosing virtual machine or driver-specific rendering behavior.
Notes
- On Linux/X11, make sure accessibility is enabled and AT-SPI is running.
- On Windows, UIA is available by default, but elevated applications may require matching privileges.
- If a highlighted element is missing or empty, the application may not expose usable bounds through the platform backend.
More information
- ../../docs/ - current working notes for Inspector behavior and platform details.
- ../../README.md - project overview.
The files in docs/ are working documentation for now and will be replaced or consolidated into proper user documentation later.
License
Apache-2.0. See the repository's LICENSE file.
Metadata
Release files for platynui-inspector 0.12.0.dev321
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| platynui_inspector-0.12.0.dev321-py3-none-win_arm64.whl | Python 3 | none | Windows ARM64 | Details for platynui_inspector-0.12.0.dev321-py3-none-win_arm64.whl |
| platynui_inspector-0.12.0.dev321-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details for platynui_inspector-0.12.0.dev321-py3-none-win_amd64.whl |
| platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_x86_64.whl | Python 3 | none | Linux glibc 2.34+ x86-64 | Details for platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_x86_64.whl |
| platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_aarch64.whl | Python 3 | none | Linux glibc 2.34+ ARM64 | Details for platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_aarch64.whl |
| platynui_inspector-0.12.0.dev321-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for platynui_inspector-0.12.0.dev321-py3-none-macosx_11_0_arm64.whl |
Total release size: 50.8 MB
Release files / platynui_inspector-0.12.0.dev321-py3-none-win_arm64.whl
| Download URL | platynui_inspector-0.12.0.dev321-py3-none-win_arm64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
43e53feb375996f8b12cf4f224b7dcf04e59fcac4b0ec8077dd3a74c277f7644
|
|
BLAKE2b-256 checksum How to use checksums |
a82662be8321a43fae98d585920317d700ca0058ea58582d1db390b250975b30
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / platynui_inspector-0.12.0.dev321-py3-none-win_amd64.whl
| Download URL | platynui_inspector-0.12.0.dev321-py3-none-win_amd64.whl |
|---|---|
| Size | 8.4 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
15a02fcac6b4c5d9a6e39b03e3cbc193d8ac85ea51f34cc5d4f78c7b0980ef43
|
|
BLAKE2b-256 checksum How to use checksums |
390b6e9171aba4451aa9490fb43f4c0faa62e8d595ae29ae29c737351ee9528d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_x86_64.whl
| Download URL | platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 13.3 MB |
| Tags | Linux glibc 2.34+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
131f27e818c09ac5a3b48b58e53dfb38c3e143bf3f14695ea591fed3bbdc27a9
|
|
BLAKE2b-256 checksum How to use checksums |
d8a9adf69778de67a1b32833631c2dcf83e7ee8000ccb08f3e47833a5b86b6af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_aarch64.whl
| Download URL | platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_aarch64.whl |
|---|---|
| Size | 13.3 MB |
| Tags | Linux glibc 2.34+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
a4489014aa583ca3f4df79f9ab9020c890d07160f8fb9dff6f719721d55749b3
|
|
BLAKE2b-256 checksum How to use checksums |
d7b29d111aa57ff7c4b04d13f4e5480b6e15b36a77ecd6d85c517e97f746e070
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / platynui_inspector-0.12.0.dev321-py3-none-macosx_11_0_arm64.whl
| Download URL | platynui_inspector-0.12.0.dev321-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 7.9 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5639e248f3fd4a04b8b466366098f18e48ce913f002be70f625e080473e5083c
|
|
BLAKE2b-256 checksum How to use checksums |
3a6e45392bb36fe3d39679a52dc2083a6bb5c384a0a22b617bc133f7c5808326
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for platynui-inspector 0.12.0.dev321
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.