Skip to main content

UI hierarchy visualization tool, supporting Android, iOS, HarmonyOS NEXT.

Project description

ui-viewer

github actions pypi version python

UI hierarchy visualization tool, supporting Android, iOS, HarmonyOS NEXT.

showcase

Installation

  • python3.8+
pip3 install -U uiviewer

Run

Start with a default port (8000)

uiviewer
# or
python3 -m uiviewer

Start with a custom port

uiviewer -p <PORT>
python3 -m uiviewer -p <PORT>

and then open the browser to http://localhost:8000

Tips

  • If you are using a virtual environment, please make sure to activate it before running the command.
  • On iOS, please ensure that WDA is successfully started and wda port forwarding is successful in advance.
    • First, Use xcode or tidevice or go-ios to launch wda.
    tidevice xctest -B <wda_bundle_id>
    
    • Second, Use tidevice or iproxy to forward the wda port,and keep it running.
    tidevice relay <local_port> 8100
    
    • Finally, To ensure the success of the browser to access http://localhost:<local_port>/status
  • On iOS,WDA can easily freeze when dumping high UI hierarchy. You can reduce the maxDepth on the web page. The default is 30.

preview

  • HarmonyOS harmony

  • Android android

  • iOS ios

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uiviewer-1.0.1.tar.gz (14.7 kB view details)

Uploaded Source

Built Distribution

uiviewer-1.0.1-py3-none-any.whl (19.2 kB view details)

Uploaded Python 3

File details

Details for the file uiviewer-1.0.1.tar.gz.

File metadata

  • Download URL: uiviewer-1.0.1.tar.gz
  • Upload date:
  • Size: 14.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for uiviewer-1.0.1.tar.gz
Algorithm Hash digest
SHA256 983d48ced2bf4354441e5f33315907976b1bf25ff96d16edccd3a24b37989962
MD5 a51ff68be45bfe8125ed501e0bff16a5
BLAKE2b-256 6b424345c152c0d5804f0265e641852004c747eebd33bc014288efd6c79cf6c1

See more details on using hashes here.

File details

Details for the file uiviewer-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: uiviewer-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 19.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for uiviewer-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 57e15521614c20eb5958d1618ef9588a0ec90315fe134f364e1856da148c1c29
MD5 9a135e7c9a4b7fd84ec4ed5f5cbdccfb
BLAKE2b-256 9c57166869a48b9f18989d8ba3635f56694437e4c39b3df8f3ef859c050e17b8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page