Current release: v0.0.51 (2026-03-06) Release notes: CHANGELOG.md
Languages: English | 繁體中文
This Python/PyQt6 version may no longer receive active maintenance or new releases.
For a Rust-based version, please use: https://github.com/leaf76/lazy_blacktea_rust
- Monitor multiple Android devices and schedule operations from a single window.
- Ship ready-to-run automation tasks (install, record, capture, shell commands, logcat streaming).
- Offer a clear device table, progress indicators, and dual light/dark themes.
- Accelerate heavy I/O and file workloads with a Rust native companion module.
- Rely on built-in tests and CI pipelines to lower regression risks.
See the full setup guide in docs/quickstart.md.
uv run python lazy_blacktea_pyqt.pyFor headless environments (CI, remote), add QT_QPA_PLATFORM=offscreen.
| Area | Highlights | Key Modules |
|---|---|---|
| Device management | Live discovery, grouping, and dynamic refresh | ui.async_device_manager, ui.device_manager |
| Automation tasks | Batch installs (with transfer progress + cancel), bug reports, shell, recording, screenshots | ui.device_operations_manager, utils.adb_tools |
| File workflows | Browse device files, preview, and coordinate export paths | ui.device_file_browser_manager, utils.file_generation_utils |
| Diagnostics | Logcat streaming, buffer controls, error classification, completion dialogs | ui.logcat_viewer, ui.console_manager, ui.error_handler |
| Performance | Debounced refresh, batched UI updates, native helpers | utils.debounced_refresh, utils.task_dispatcher, native_lbb |
See docs/architecture.md for the project tour, module responsibilities, and troubleshooting notes.
See docs/deployment.md for packaging steps, version management, and release checklist details.
- Issue tracker: https://github.com/cy76/lazy_blacktea/issues
- Discussions: https://github.com/cy76/lazy_blacktea/discussions
- Contribution guide:
CONTRIBUTING.md - Security reports: submit privately via GitHub Security Advisories.
- Fork the repository and create a feature branch.
- Practice TDD: add tests, implement the change, refactor when green. Use Conventional Commits.
- Run
python3 tests/run_tests.pyand update docs or performance notes as needed. - Open a pull request with test results, screenshots for UI changes, and relevant context.
Lazy Blacktea ships under the MIT License; PyQt6 and third-party dependencies keep their respective licenses.
- Provide richer automation templates and script samples.
- Sync preferences, tagging, and usage metrics via optional cloud services.
- Expand Windows support (experimental).
- Add guided onboarding and interactive tutorials.
Like the project? Drop a ⭐, share it with your team, and tell us how it helped!