Skip to main content

A Local HTTP File Server with ngrok & QR support

Project description

📱 Android UI Inspector

Android UI Inspector is a plug-and-play Python-based visual tool to inspect and analyze the UI of Android apps directly from your phone.

🔧 No manual setup needed — it installs ADB, matplotlib, and pyperclip automatically and works across Windows, Linux, and macOS.


🚀 Features

✅ Auto-installs ADB (platform-tools) for your OS
✅ Installs Python dependencies automatically
✅ Connects to real Android devices via USB or Wi-Fi
✅ Live UI screenshot + hierarchy dump
✅ Click on UI elements to highlight and inspect them
✅ Dropdown filter: class, resource-id, text, bounds
✅ One-click Copy to Clipboard
✅ Press n to cycle overlapping elements
✅ Press r or click "Refresh Screen" to reload live UI
✅ Cleans up old screenshots/XML files (older than 10 minutes)
✅ Cross-platform (Windows, macOS, Linux)
✅ Works offline after first run


📲 Requirements

  • Android phone with:
    • Developer Mode enabled
    • USB Debugging turned ON
  • Python 3.7 or higher
  • Internet connection (for first run only)

🖥 How to Use (All OS)

  1. Clone the repo
    git clone https://github.com/kdiitg/ui-finder.git
    cd ui_finder
    
  2. In Windows
    pip install ui_finder
    ui_finder
    
    
  3. In Linux/MacOS
    pip3 install ui_finder
    ui_finder
    

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

ui_finder-1.1.5.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ui_finder-1.1.5-py3-none-any.whl (16.9 kB view details)

Uploaded Python 3

File details

Details for the file ui_finder-1.1.5.tar.gz.

File metadata

  • Download URL: ui_finder-1.1.5.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.4

File hashes

Hashes for ui_finder-1.1.5.tar.gz
Algorithm Hash digest
SHA256 a0682e64401ee50c879713378c370b1808d71502c8634e0a3e46fe32afc3dfa0
MD5 7889b8920379650c2f5be6e8c1b894e4
BLAKE2b-256 e7c146326a2d8ad584605bd4d01dec9d30870795c615883f43f5939781e2de9f

See more details on using hashes here.

File details

Details for the file ui_finder-1.1.5-py3-none-any.whl.

File metadata

  • Download URL: ui_finder-1.1.5-py3-none-any.whl
  • Upload date:
  • Size: 16.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.4

File hashes

Hashes for ui_finder-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 a49e139ed3e94ce6e72363c73fbf4206da088164963b4ec6d0b0bce62d484566
MD5 9a90dee4bfdeb6a696513cd38e8455e9
BLAKE2b-256 4d44d72f251a4607145a36617503ed9f196d90711abe305a79a07b20d8a9d68b

See more details on using hashes here.

Supported by

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