Inspector for Robot Framework PlatynUI
Project description
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.
[!WARNING] Preview package. The UI and behavior may still change.
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file platynui_inspector-0.12.0.dev321-py3-none-win_arm64.whl.
File metadata
- Download URL: platynui_inspector-0.12.0.dev321-py3-none-win_arm64.whl
- Upload date:
- Size: 7.9 MB
- Tags: Python 3, Windows ARM64
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
43e53feb375996f8b12cf4f224b7dcf04e59fcac4b0ec8077dd3a74c277f7644
|
|
| MD5 |
8cdfce0aaa93339957a9e168556a2b2b
|
|
| BLAKE2b-256 |
a82662be8321a43fae98d585920317d700ca0058ea58582d1db390b250975b30
|
File details
Details for the file platynui_inspector-0.12.0.dev321-py3-none-win_amd64.whl.
File metadata
- Download URL: platynui_inspector-0.12.0.dev321-py3-none-win_amd64.whl
- Upload date:
- Size: 8.4 MB
- Tags: Python 3, Windows x86-64
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
15a02fcac6b4c5d9a6e39b03e3cbc193d8ac85ea51f34cc5d4f78c7b0980ef43
|
|
| MD5 |
05f2c5eff48726a9cb54091a3e5f894c
|
|
| BLAKE2b-256 |
390b6e9171aba4451aa9490fb43f4c0faa62e8d595ae29ae29c737351ee9528d
|
File details
Details for the file platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_x86_64.whl.
File metadata
- Download URL: platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_x86_64.whl
- Upload date:
- Size: 13.3 MB
- Tags: Python 3, manylinux: glibc 2.34+ x86-64
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
131f27e818c09ac5a3b48b58e53dfb38c3e143bf3f14695ea591fed3bbdc27a9
|
|
| MD5 |
9bdac2c5a993e94d3ebe59a05f1692f1
|
|
| BLAKE2b-256 |
d8a9adf69778de67a1b32833631c2dcf83e7ee8000ccb08f3e47833a5b86b6af
|
File details
Details for the file platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_aarch64.whl.
File metadata
- Download URL: platynui_inspector-0.12.0.dev321-py3-none-manylinux_2_34_aarch64.whl
- Upload date:
- Size: 13.3 MB
- Tags: Python 3, manylinux: glibc 2.34+ ARM64
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a4489014aa583ca3f4df79f9ab9020c890d07160f8fb9dff6f719721d55749b3
|
|
| MD5 |
7603181bb7104ee0fa007ebb160b4b61
|
|
| BLAKE2b-256 |
d7b29d111aa57ff7c4b04d13f4e5480b6e15b36a77ecd6d85c517e97f746e070
|
File details
Details for the file platynui_inspector-0.12.0.dev321-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: platynui_inspector-0.12.0.dev321-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 7.9 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5639e248f3fd4a04b8b466366098f18e48ce913f002be70f625e080473e5083c
|
|
| MD5 |
99ae9b896ae498e510de4ca212ffc972
|
|
| BLAKE2b-256 |
3a6e45392bb36fe3d39679a52dc2083a6bb5c384a0a22b617bc133f7c5808326
|
